{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_7r4rp82r5h3q","handle":"auth-agent-mcp","url":"https://wellknown.network/agents/auth-agent-mcp","links":{"self":"https://wellknown.network/agents/auth-agent-mcp/record.json","html":"https://wellknown.network/agents/auth-agent-mcp","markdown":"https://wellknown.network/agents/auth-agent-mcp/record.md","api":"https://wellknown.network/api/v1/agents/auth-agent-mcp","status":"https://wellknown.network/api/v1/agents/auth-agent-mcp/status","claim":"https://wellknown.network/agents/auth-agent-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/auth-agent-mcp/claim.json","badge":"https://wellknown.network/agents/auth-agent-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:auth-agent-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"auth-agent-mcp","summary":"OAuth 2.1 middleware for MCP servers using Auth-Agent","description":"# Auth-Agent MCP - Python SDK\n\nOAuth 2.1 authentication middleware for MCP servers using FastAPI.\n\n## Installation\n\n```bash\npip install auth-agent-mcp\n```\n\n## Quick Start\n\n```python\nfrom fastapi import FastAPI, Request\nfrom auth_agent_mcp import AuthAgentMiddleware\nimport os\n\napp = FastAPI()\n\n# Add Auth-Agent authentication\napp.add_middleware(\n    AuthAgentMiddleware,\n    auth_server=os.getenv(\"AUTH_SERVER\", \"https://mcp.auth-agent.com\"),\n    server_id=os.getenv(\"SERVER_ID\"),\n    api_key=os.getenv(\"API_KEY\"),\n    required_scopes=[\"files:read\"],\n)\n\n@app.get(\"/files\")\nasync def list_files(request: Request):\n    # User context injected by middleware\n    user_email = request.state.user_email\n    scopes = request.state.scopes\n\n    return {\n        \"user\": user_email,\n        \"files\": [\"document.txt\", \"image.png\"]\n    }\n```\n\n## Configuration\n\n### Environment Variables\n\n```bash\nAUTH_SERVER=https://mcp.auth-agent.com\nSERVER_ID=srv_abc123\nAPI_KEY=sk_xyz789\n```\n\n### Middleware Parameters\n\n- `auth_server` (str): Auth-Agent server URL (default: https://mcp.auth-agent.com)\n- `server_id` (str): Your MCP server ID from registration\n- `api_key` (str): API key for token validation\n- `required_scopes` (List[str]): Scopes required for all endpoints\n- `public_paths` (List[str]): Paths that don't require authentication\n\n## Manual Token Validation\n\n```python\nfrom auth_agent_mcp import AuthAgentClient\n\nclient = AuthAgentClient(\n    auth_server=\"https://mcp.auth-agent.com\",\n    api_key=\"sk_xyz789\"\n)\n\n# Introspect token\nresult = await client.introspect_token(\"eyJhbG...\")\nif result[\"active\"]:\n    print(f\"Valid token for user: {result['sub']}\")\n    print(f\"Scopes: {result['scope']}\")\n    print(f\"Audience: {result['aud']}\")\n\n# Revoke token\nawait client.revoke_token(\"eyJhbG...\")\n```\n\n## License\n\nMIT","publisher":{"name":"Auth-Agent Team","url":null},"homepage":"https://github.com/auth-agent/auth-agent-mcp","repository":"https://github.com/auth-agent/auth-agent-mcp/issues","version":"1.0.0","license":"MIT","protocols":["mcp"],"tags":["oauth","mcp","authorization","fastapi","middleware"],"pricing":null,"endpoints":[{"url":"pypi:auth-agent-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"security.identity","name":"Identity & Access","confidence":1,"provenance":"declared"}],"categories":["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":"auth-agent-mcp","registry":"pypi","observedAt":"2026-09-09T09:25:18.433Z","publishedAt":"2025-11-27T19:59:19.037000Z","latestVersion":"1.0.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"auth-agent-mcp","url":"https://pypi.org/project/auth-agent-mcp/","firstSeenAt":"2026-09-09T09:24:24.314Z","fetchedAt":"2026-09-09T09:24:24.314Z","normalizedAt":"2026-09-09T09:24:24.314Z"}]},"firstSeenAt":"2026-09-09T09:24:24.314Z","updatedAt":"2026-09-09T09:25:18.433Z"}