scoped-mcp
Per-agent scoped MCP tool proxy with credential isolation, resource scoping, and audit logging.
Tested on Linux
Use it
Linux x86_64
install scoped-mcp via uv tool install
uv tool install scoped-mcp
Where the README and reality differ
- README: pip install scoped-mcp and run scoped-mcp --manifest
What worked: requires AGENT_ID and AGENT_TYPE env vars or server exits with ConfigError; also needs manifest file and base_path/db_dir to exist - README: filesystem_list_dir path="/" example
What worked: root path "/" rejected; use "." to list agent-scoped directory
Add it to your agent
claude mcp add scoped-mcp -e AGENT_ID='<AGENT_ID>' -e AGENT_TYPE='<AGENT_TYPE>' -e SCOPED_MCP_BEARER_TOKEN='<SCOPED_MCP_BEARER_TOKEN>' -- scoped-mcp --manifest '<manifest>'JSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"scoped-mcp": {
"command": "scoped-mcp",
"args": [
"--manifest",
"<manifest>"
],
"env": {
"AGENT_ID": "<AGENT_ID>",
"AGENT_TYPE": "<AGENT_TYPE>",
"SCOPED_MCP_BEARER_TOKEN": "<SCOPED_MCP_BEARER_TOKEN>"
}
}
}
}You fill in
AGENT_ID: unique agent instance identity (required)AGENT_TYPE: agent role for manifest mapping (required)SCOPED_MCP_BEARER_TOKEN: bearer token for http transport (required)
Replace <manifest> with your own path. Ask the user for AGENT_ID, AGENT_TYPE, SCOPED_MCP_BEARER_TOKEN; pickfit never had a value, so these are placeholders.
Add scoped-mcp as an MCP server in your MCP client, then call the scoped_mcp_status tool to see which tools your agent can use.
What it does
- Give each agent only the tools it is allowed to useNot tested
- Keep each agent within its own resourcesNot shown working
- Hold backend credentials so agents never see themNot tested
- Log every tool call to an audit trailNot tested
How far pickfit got
Linux x86_64
- Installs
- Connects
- 0 of 4 features work
- Works offline
Good for
- load only the tools an agent is allowed to use
- enforce resource boundaries between agents
- hold backend credentials so agents never see them
- log every tool call to a structured audit trail
An alternative to Aggregation gateways, Access control proxies, Credential proxies and Enterprise gateways.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Works offline
- Checked on 1 Nov 2026
- Version 1.19.3
An MCP client handshake over stdio listed 3 tools, and a call to filesystem_read_file returned a result.