About Proxykey
Proxykey is an API-key vault and proxy for apps and agents that use revocable virtual passes without seeing original keys. Its MCP server manages passes while keeping secret values out of agent access.
Key features
- 01AES-256-GCM encrypted key storage
- 02Create, rotate, and revoke passes
- 03Per-pass IP binding and rate limits
- 04Inspect request logs and usage stats
- 05Proxy API requests
Use cases
- 01Let agents manage API credentials without exposing original keys
- 02Apply IP binding and rate limits to passes
- 03Review request activity and usage per pass
MCP support
The MCP server provides tools to create, update, revoke, and inspect passes. It cannot read or create original secret values; a human enters keys through the panel.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.proxykey.org/mcpclaude mcp add --transport http proxykey https://mcp.proxykey.org/mcp{"mcpServers":{"proxykey":{"type":"http","url":"https://mcp.proxykey.org/mcp"}}}Open in Cursor{"servers":{"proxykey":{"type":"http","url":"https://mcp.proxykey.org/mcp"}}}Open in VS Code{"mcpServers":{"proxykey":{"type":"http","url":"https://mcp.proxykey.org/mcp"}}}{"mcpServers":{"proxykey":{"serverUrl":"https://mcp.proxykey.org/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://mcp.proxykey.org/mcpAuth requiredTools
Details
From the project READMEproxykey MCP server
Issue, rotate and revoke API-key passes from your AI agent — without the agent ever seeing a real key.
proxykey is a credential vault and proxy: your real API keys (OpenAI,
Anthropic, Telegram, Stripe, 25+ providers) are encrypted with AES-256-GCM
and never leave the server. Apps and agents use revocable virtual keys —
passes (vlt_…) — with per-pass IP binding, rate limits and full request
logs. This MCP server lets an agent manage those passes.
- Website: https://proxykey.org/en/
- Panel: https://app.proxykey.org
- Docs: https://app.proxykey.org/docs.html
- MCP endpoint (Streamable HTTP):
https://mcp.proxykey.org/mcp
Why give an agent this instead of a key
Anything that enters a model's context can leak — through logs, traces or prompt injection. With proxykey the agent gets a tool, not a secret:
- the agent can create / rotate / revoke / inspect passes;
- a "read the real key" operation does not exist in the toolset;
- only a human can enter the original key, in the panel;
- a leaked pass is a non-event: wrong IP → 403, over limit → 429, revocation is one click and doesn't touch the original.
Quick start
- Sign in at https://app.proxykey.org (GitHub OAuth or email magic link, free).
- Open MCP → create a token (
mcp_…). - Connect your client:
Claude Code
claude mcp add --transport http proxykey https://mcp.proxykey.org/mcp \
--header "Authorization: Bearer mcp_YOUR_TOKEN"
Claude Desktop / Cursor (mcp.json)
{
"mcpServers": {
"proxykey": {
"url": "https://mcp.proxykey.org/mcp",
"headers": { "Authorization": "Bearer mcp_YOUR_TOKEN" }
}
}
}
Tools (13)
| Tool | What it does |
|---|---|
list_providers | Provider catalogue (slugs, auth models) |
list_secrets | Stored keys (metadata only — never values) |
get_manual_secret_setup | Link for a human to enter a key |
list_passes | All passes with status, limits, binding |
create_pass | Issue a pass for an existing secret |
create_pending_pass | Issue a pass before the key exists; a human fills the key in later, the pass activates automatically |
update_pass | Change limits, IP mode, expiry |
revoke_pass / delete_pass | Kill a pass instantly / remove a revoked one |
rotate_pass | Reissue the token, same settings |
rebind_pass_ip | Reset IP learning |
get_pass_logs / get_pass_stats | Per-pass request log and usage stats |
The proxy itself
Point your client at the proxy and use the pass as the API key — only the host and the key change:
# before
curl https://api.openai.com/v1/chat/completions -H "Authorization: Bearer sk-..."
# after
curl https://api.proxykey.org/p/openai/v1/chat/completions -H "Authorization: Bearer vlt_openai_..."
Streaming (SSE), request bodies and headers pass through unchanged.
Telegram bots keep their URL shape (/p/telegram-bot/<pass>/getMe).
Full reference: https://app.proxykey.org/docs.html
Security model (short version)
- Secrets: AES-256-GCM envelope encryption, decrypted in memory per request, never logged, never returned by any API after creation.
- Pass tokens and MCP tokens are stored hashed (SHA-256).
- MCP surface cannot create or read secret values, or toggle body logging — those stay human-only in the panel.
- Request logs contain metadata only — no auth headers, no key material.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.