{"_id":"@agency-lang/mcp","_rev":"3-ac7985718fa0216dbff13829591cacb4","name":"@agency-lang/mcp","dist-tags":{"latest":"0.0.5"},"versions":{"0.0.1":{"name":"@agency-lang/mcp","version":"0.0.1","keywords":[],"author":{"name":"Aditya Bhargava"},"license":"ISC","_id":"@agency-lang/mcp@0.0.1","maintainers":[{"name":"egonschiele","email":"npm@adit.io"}],"homepage":"https://github.com/egonSchiele/agency-lang","bugs":{"url":"https://github.com/egonSchiele/agency-lang/issues"},"bin":{"mcp":"dist/src/cli.js"},"dist":{"shasum":"ca2ab3dd73e934a4361544e99c1046957727c17c","tarball":"https://registry.npmjs.org/@agency-lang/mcp/-/mcp-0.0.1.tgz","fileCount":25,"integrity":"sha512-Md7K8BsmjMVnAjorXMvFD1tm+zlPqaiv5+1xc8VKAiU0dl53AMFG/NCi2oqeT6g+JPdSw8Pvb1A89Bxwf5UTmw==","signatures":[{"sig":"MEUCIEKBBGT5LCRZ0cpKFUQO0Tbnf5gUjU86ktx9u1FikxoMAiEAsLE9+FGFe61bwo48VD57tKTHPT9cazvseNmZtkG1roc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":45537},"main":"./dist/src/mcp.js","type":"module","types":"./dist/src/mcp.d.ts","agency":"./index.agency","exports":{".":{"types":"./dist/src/mcp.d.ts","import":"./dist/src/mcp.js"},"./package.json":"./package.json"},"gitHead":"0d22c457e1ea60f0c920c25240ffe0e13aa1581e","scripts":{"test":"vitest","build":"tsc","agency":"agency","test:run":"vitest run","test:agency":"agency tests/agency -p 8","test:agency-js":"agency test js tests/agency-js -p 8"},"_npmUser":{"name":"egonschiele","email":"npm@adit.io"},"_npmVersion":"11.6.2","description":"MCP (Model Context Protocol) support for the Agency language","directories":{},"_nodeVersion":"25.1.0","dependencies":{"@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.0.0","typescript":"^5.0.0"},"peerDependencies":{"zod":"^4.0.0","agency-lang":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.0.1_1777166831851_0.1441852692099701","host":"s3://npm-registry-packages-npm-production"}},"0.0.4":{"name":"@agency-lang/mcp","version":"0.0.4","keywords":[],"author":{"name":"Aditya Bhargava"},"license":"ISC","_id":"@agency-lang/mcp@0.0.4","maintainers":[{"name":"egonschiele","email":"npm@adit.io"}],"homepage":"https://github.com/egonSchiele/agency-lang","bugs":{"url":"https://github.com/egonSchiele/agency-lang/issues"},"bin":{"mcp":"dist/src/cli.js"},"dist":{"shasum":"13fe843eed9a091d9515b3b143a375ad8952ed3b","tarball":"https://registry.npmjs.org/@agency-lang/mcp/-/mcp-0.0.4.tgz","fileCount":26,"integrity":"sha512-pQVewTY4v5PzYNl1wJjkyM8olB2nkkDUquZKS4NYIsvXz2n3xGF70uoJc5j2K4rDWfBnwS7lf2ZlZJkV2+Vjdg==","signatures":[{"sig":"MEQCIH097wUdPPj4yI3PLiFGjFT6sR+H89pQmG08J8jlTWxpAiAsQArwwFD1LfCzwKBmPnob+h9Q56VT3fvdtvjk/ydt2Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":60263},"main":"./index.js","type":"module","_from":"file:agency-lang-mcp-0.0.4.tgz","agency":"./index.agency","exports":{".":{"types":"./dist/src/mcp.d.ts","import":"./dist/src/mcp.js"},"./package.json":"./package.json"},"scripts":{"test":"vitest","build":"tsc","agency":"agency","test:run":"vitest run","test:agency":"agency tests/agency -p 8","test:agency-js":"agency test js tests/agency-js -p 8"},"_npmUser":{"name":"egonschiele","email":"npm@adit.io"},"_resolved":"/private/var/folders/7v/4q_s04w13_dg2278232mcqz80000gn/T/62b1f055b4a4dbf5c01520bedd7870f6/agency-lang-mcp-0.0.4.tgz","_integrity":"sha512-pQVewTY4v5PzYNl1wJjkyM8olB2nkkDUquZKS4NYIsvXz2n3xGF70uoJc5j2K4rDWfBnwS7lf2ZlZJkV2+Vjdg==","_npmVersion":"11.6.2","description":"MCP (Model Context Protocol) support for the Agency language","directories":{},"_nodeVersion":"25.1.0","dependencies":{"@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.0.0","typescript":"^5.0.0"},"peerDependencies":{"zod":"^4.0.0","agency-lang":"0.7.7"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.0.4_1783829453273_0.7969417172188351","host":"s3://npm-registry-packages-npm-production"}},"0.0.5":{"name":"@agency-lang/mcp","version":"0.0.5","description":"MCP (Model Context Protocol) support for the Agency language","type":"module","agency":"./index.agency","main":"./index.js","keywords":[],"author":{"name":"Aditya Bhargava"},"license":"ISC","bugs":{"url":"https://github.com/egonSchiele/agency-lang/issues"},"homepage":"https://github.com/egonSchiele/agency-lang","exports":{".":{"types":"./dist/src/mcp.d.ts","import":"./dist/src/mcp.js"},"./package.json":"./package.json"},"bin":{"mcp":"dist/src/cli.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0"},"peerDependencies":{"agency-lang":">=0.9.0","zod":"^4.0.0"},"devDependencies":{"typescript":"^5.0.0","vitest":"^3.0.0","agency-lang":"0.9.0"},"scripts":{"build":"tsc","agency":"agency","test":"vitest","test:run":"vitest run","test:agency":"agency tests/agency -p 8","test:agency-js":"agency test js tests/agency-js -p 8"},"_id":"@agency-lang/mcp@0.0.5","_integrity":"sha512-QoLK1RI+IPvv1wKXTEqrQKk3wpV7CxSm30J3tO9gOcm6wevSf5161eBXbZHF83fPn2QXytqFcOt+tK8ei4i+NA==","_resolved":"/private/var/folders/7v/4q_s04w13_dg2278232mcqz80000gn/T/3c753dd964dd5f8f86a0925b8fa9deab/agency-lang-mcp-0.0.5.tgz","_from":"file:agency-lang-mcp-0.0.5.tgz","_nodeVersion":"25.1.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-QoLK1RI+IPvv1wKXTEqrQKk3wpV7CxSm30J3tO9gOcm6wevSf5161eBXbZHF83fPn2QXytqFcOt+tK8ei4i+NA==","shasum":"0db9c44d112fc93ee99612a46ef133cd9a7c9ef4","tarball":"https://registry.npmjs.org/@agency-lang/mcp/-/mcp-0.0.5.tgz","fileCount":26,"unpackedSize":60293,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCkcJy6hmGH8jy1LTHCCfNoc8ICVqAYJ08byvSOWcB0zAIhANDwqrdvhpJC6H+fk4it0VY/SrI//PK75nkndPpICbO1"}]},"_npmUser":{"name":"egonschiele","email":"npm@adit.io"},"directories":{},"maintainers":[{"name":"egonschiele","email":"npm@adit.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.0.5_1784420643459_0.282012186295876"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-26T01:27:11.718Z","modified":"2026-07-19T00:24:03.771Z","0.0.1":"2026-04-26T01:27:11.999Z","0.0.4":"2026-07-12T04:10:53.419Z","0.0.5":"2026-07-19T00:24:03.609Z"},"bugs":{"url":"https://github.com/egonSchiele/agency-lang/issues"},"author":{"name":"Aditya Bhargava"},"license":"ISC","homepage":"https://github.com/egonSchiele/agency-lang","keywords":[],"description":"MCP (Model Context Protocol) support for the Agency language","maintainers":[{"name":"egonschiele","email":"npm@adit.io"}],"readme":"# @agency-lang/mcp\n\nMCP (Model Context Protocol) support for the [Agency language](https://github.com/egonSchiele/agency-lang). Connects your Agency agents to external tool servers — filesystem access, databases, GitHub, and more.\n\n## Installation\n\n```bash\nnpm install @agency-lang/mcp\n```\n\nRequires `agency-lang` and `zod` as peer dependencies.\n\n## Usage\n\nImport `mcp()` in your `.agency` file and pass tools to `llm()`:\n\n```\nimport { mcp } from \"pkg::@agency-lang/mcp\"\n\nnode main() {\n  const tools = mcp(\"filesystem\") catch []\n  const result = llm(\"List the files in /tmp\", { tools: [...tools] })\n  print(result)\n}\n```\n\n## Configuration\n\nConfigure MCP servers in `agency.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"filesystem\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-filesystem\", \"/tmp\"]\n    }\n  }\n}\n```\n\nHTTP servers are also supported:\n\n```json\n{\n  \"mcpServers\": {\n    \"weather\": {\n      \"type\": \"http\",\n      \"url\": \"https://weather-mcp.example.com/mcp\"\n    }\n  }\n}\n```\n\n## OAuth\n\nFor servers that require OAuth (like GitHub), add `\"auth\": \"oauth\"` to the config and set environment variables for your credentials:\n\n```bash\nexport MCP_GITHUB_CLIENT_ID=your-client-id\nexport MCP_GITHUB_CLIENT_SECRET=your-client-secret\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"github\": {\n      \"type\": \"http\",\n      \"url\": \"https://api.githubcopilot.com/mcp/\",\n      \"auth\": \"oauth\"\n    }\n  }\n}\n```\n\nThe first time you connect, your browser opens for authorization. Tokens are stored at `~/.agency/tokens/` and reused automatically.\n\n### Managing tokens\n\n```bash\nnpx @agency-lang/mcp auth github        # Authorize a server\nnpx @agency-lang/mcp auth --list        # List stored tokens\nnpx @agency-lang/mcp auth --revoke github  # Remove a token\n```\n\n## TypeScript usage\n\n```typescript\nimport { mcp } from \"@agency-lang/mcp\";\n\nconst result = await mcp(\"filesystem\");\nif (result.success) {\n  console.log(\"Tools:\", result.value);\n}\n```\n\nFor custom OAuth handling, pass a callback as the second argument:\n\n```typescript\nconst result = await mcp(\"github\", async ({ authUrl, complete }) => {\n  console.log(`Please authorize at: ${authUrl}`);\n  await complete;\n});\n```\n\n## Documentation\n\nSee the full [MCP guide](https://github.com/egonSchiele/agency-lang/blob/main/packages/agency-lang/docs-new/guide/mcp.md) for details on configuration options, tool filtering, combining tools from multiple servers, and more.\n","readmeFilename":"README.md"}