{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_jb8z4skxgurq","handle":"easy-mcp-proxy","url":"https://wellknown.network/agents/easy-mcp-proxy","links":{"self":"https://wellknown.network/agents/easy-mcp-proxy/record.json","html":"https://wellknown.network/agents/easy-mcp-proxy","markdown":"https://wellknown.network/agents/easy-mcp-proxy/record.md","api":"https://wellknown.network/api/v1/agents/easy-mcp-proxy","status":"https://wellknown.network/api/v1/agents/easy-mcp-proxy/status","claim":"https://wellknown.network/agents/easy-mcp-proxy/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/easy-mcp-proxy/claim.json","badge":"https://wellknown.network/agents/easy-mcp-proxy/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:easy-mcp-proxy","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"easy-mcp-proxy","summary":"Easy MCP Proxy - Filter, transform, and compose MCP tools","description":"# Easy MCP Proxy\n\nAn MCP proxy server that aggregates tools from multiple upstream MCP servers and exposes them through **tool views** — filtered, transformed, and composed subsets of tools.\n\n> **Status**: Experimental\n\n📖 **[Full Documentation](docs/index.md)** | 🚀 **[Tutorial](docs/tutorial.md)** | 📚 **[Reference](docs/reference.md)**\n\n## Quick Start\n\n### 1. Install\n\n```bash\nuv pip install -e .\n```\n\n### 2. Create a config file\n\n```yaml\n# config.yaml\nmcp_servers:\n  filesystem:\n    command: npx\n    args: [-y, \"@modelcontextprotocol/server-filesystem\", /home/user/documents]\n\ntool_views:\n  default:\n    tools:\n      filesystem:\n        read_file: {}\n        list_directory: {}\n```\n\n### 3. Run the proxy\n\n```bash\n# For Claude Desktop (stdio)\nmcp-proxy serve --config config.yaml\n\n# For HTTP clients\nmcp-proxy serve --config config.yaml --transport http --port 8000\n```\n\n### 4. Use with Claude Desktop\n\n**Local (stdio)** — runs the proxy as a subprocess:\n\n```json\n{\n  \"mcpServers\": {\n    \"proxy\": {\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"mcp-proxy\", \"serve\", \"--config\", \"/path/to/config.yaml\"]\n    }\n  }\n}\n```\n\n**Remote (HTTP)** — connect to a proxy running on a server:\n\n```json\n{\n  \"mcpServers\": {\n    \"proxy\": {\n      \"type\": \"http\",\n      \"url\": \"https://your-proxy-server.example.com/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer your-auth-token\"\n      }\n    }\n  }\n}\n```\n\nThis requires [authentication](docs/reference.md#authentication) to be configured on the proxy. See `mcp-proxy serve --help` for auth options.\n\n## Example Use Cases\n\n### Reduce Tool Count with Search Mode\n\nToo many tools overwhelming your LLM? Expose hundreds of tools through just two meta-tools:\n\n```yaml\ntool_views:\n  everything:\n    exposure_mode: search\n    include_all: true\n```\n\nThis creates `everything_search_tools` (find tools by description) and `everything_call_tool` (call by name). The LLM searches first, then calls—no need to list every tool.\n\n### Create Domain-Specific Interfaces…","publisher":null,"homepage":null,"repository":null,"version":"0.3.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:easy-mcp-proxy","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.filesystem","name":"Filesystem","confidence":1,"provenance":"derived"},{"slug":"security.identity","name":"Identity & Access","confidence":1,"provenance":"derived"},{"slug":"dev.docs-lookup","name":"Documentation Lookup","confidence":0.791,"provenance":"derived"}],"categories":["dev","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"easy-mcp-proxy","registry":"pypi","observedAt":"2026-09-09T14:33:39.378Z","publishedAt":"2026-02-26T15:45:01.450386Z","latestVersion":"0.3.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"easy-mcp-proxy","url":"https://pypi.org/project/easy-mcp-proxy/","firstSeenAt":"2026-09-09T14:32:39.186Z","fetchedAt":"2026-09-09T14:32:39.186Z","normalizedAt":"2026-09-09T14:32:39.186Z"}]},"firstSeenAt":"2026-09-09T14:32:39.186Z","updatedAt":"2026-09-09T14:33:39.378Z"}