{"_id":"@aegis-protocol/mcp-server","_rev":"5-aa6d3143061a152fcbe4a3f1f8ef0b05","name":"@aegis-protocol/mcp-server","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@aegis-protocol/mcp-server","version":"0.1.0","keywords":["mcp","model-context-protocol","aegis","escrow","ai-agents","erc-8004","base","usdc"],"license":"MIT","_id":"@aegis-protocol/mcp-server@0.1.0","maintainers":[{"name":"srehman","email":"shamim.a.rehman@gmail.com"}],"homepage":"https://github.com/im-sham/aegis-protocol#readme","bugs":{"url":"https://github.com/im-sham/aegis-protocol/issues"},"bin":{"aegis-mcp":"dist/index.js"},"dist":{"shasum":"e6304875e15a001515ee8539819190913b843a2a","tarball":"https://registry.npmjs.org/@aegis-protocol/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":22,"integrity":"sha512-ij0v1zbiT2pyEI57KMhNsj2Uw5BTSJg8Vei1sGCuO40XP9PXRRTyeEDQ66jhdl6+UqpoMbMXtANhykYs8cDr2g==","signatures":[{"sig":"MEYCIQD6atBSNMj82QbIc1XHI1eCDRh5jzl1032TJ0dzZFh59wIhAN9idpj/hTQvXB/tJ+y96eYKS3v2J9sl4hO/bD5jz4KT","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8209475},"main":"./dist/index.js","type":"module","_from":"file:aegis-protocol-mcp-server-0.1.0.tgz","types":"./dist/index.d.ts","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit","test":"vitest run","build":"tsup","start":"node dist/index.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"srehman","email":"shamim.a.rehman@gmail.com"},"_resolved":"/private/var/folders/85/4f5_fj8n0l16bmqzsw6rz1p40000gn/T/df4ba3573938507e6edfbbcd72bffed7/aegis-protocol-mcp-server-0.1.0.tgz","_integrity":"sha512-ij0v1zbiT2pyEI57KMhNsj2Uw5BTSJg8Vei1sGCuO40XP9PXRRTyeEDQ66jhdl6+UqpoMbMXtANhykYs8cDr2g==","repository":{"url":"git+https://github.com/im-sham/aegis-protocol.git","type":"git","directory":"mcp"},"_npmVersion":"10.8.2","description":"MCP Server for the AEGIS Protocol — trustless escrow for AI agent transactions","directories":{},"_nodeVersion":"20.17.0","dependencies":{"zod":"^3.23.0","viem":"^2.0.0","@aegis-protocol/sdk":"0.1.0","@aegis-protocol/abis":"0.1.0","@aegis-protocol/types":"0.1.0","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","tsup":"^8.0.0","vitest":"^2.0.0","typescript":"^5.5.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.0_1771445015004_0.4464452942518988","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@aegis-protocol/mcp-server","version":"0.1.1","keywords":["mcp","model-context-protocol","aegis","escrow","ai-agents","erc-8004","base","usdc"],"license":"MIT","_id":"@aegis-protocol/mcp-server@0.1.1","maintainers":[{"name":"srehman","email":"shamim.a.rehman@gmail.com"}],"homepage":"https://github.com/im-sham/aegis-protocol#readme","bugs":{"url":"https://github.com/im-sham/aegis-protocol/issues"},"bin":{"aegis-mcp":"dist/index.js"},"dist":{"shasum":"50c4a937e360778a5ceed9f763e59c8c25164d6e","tarball":"https://registry.npmjs.org/@aegis-protocol/mcp-server/-/mcp-server-0.1.1.tgz","fileCount":22,"integrity":"sha512-ZAXb5x/mxlq5HwBClBmQjjdaOC/5KG/H/l6QBiQfdyTJv2a+BPtv3M4si3IWwX6AbYBvC2p8OcF2cpMFChYF4w==","signatures":[{"sig":"MEUCIEzFQsLIWICx65qsSxlDDMuHhRVFwVwKWHExBVFOZ+rLAiEAwG4O0NTGQdZjwKs8Baf2l8DZ4iUw6mgFDLTP5ivqNrs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8210575},"main":"./dist/index.js","type":"module","_from":"file:aegis-protocol-mcp-server-0.1.1.tgz","types":"./dist/index.d.ts","mcpName":"io.github.im-sham/aegis-protocol","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit","test":"vitest run","build":"tsup","start":"node dist/index.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"srehman","email":"shamim.a.rehman@gmail.com"},"_resolved":"/private/var/folders/85/4f5_fj8n0l16bmqzsw6rz1p40000gn/T/0888dad0f08ae66451cd9c048e756d0f/aegis-protocol-mcp-server-0.1.1.tgz","_integrity":"sha512-ZAXb5x/mxlq5HwBClBmQjjdaOC/5KG/H/l6QBiQfdyTJv2a+BPtv3M4si3IWwX6AbYBvC2p8OcF2cpMFChYF4w==","repository":{"url":"git+https://github.com/im-sham/aegis-protocol.git","type":"git","directory":"mcp"},"_npmVersion":"10.8.2","description":"MCP Server for the AEGIS Protocol — trustless escrow for AI agent transactions","directories":{},"_nodeVersion":"20.17.0","dependencies":{"zod":"^3.23.0","viem":"^2.0.0","@aegis-protocol/sdk":"0.1.0","@aegis-protocol/abis":"0.1.0","@aegis-protocol/types":"0.1.0","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","tsup":"^8.0.0","vitest":"^2.0.0","typescript":"^5.5.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.1_1771629816335_0.7091826312761127","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@aegis-protocol/mcp-server","version":"0.1.2","keywords":["mcp","model-context-protocol","aegis","escrow","ai-agents","erc-8004","base","usdc"],"license":"MIT","_id":"@aegis-protocol/mcp-server@0.1.2","maintainers":[{"name":"srehman","email":"shamim.a.rehman@gmail.com"}],"homepage":"https://github.com/im-sham/aegis-protocol#readme","bugs":{"url":"https://github.com/im-sham/aegis-protocol/issues"},"bin":{"aegis-mcp":"dist/index.js"},"dist":{"shasum":"3d6345ee3d16581439034b046d2b6820d6f98476","tarball":"https://registry.npmjs.org/@aegis-protocol/mcp-server/-/mcp-server-0.1.2.tgz","fileCount":22,"integrity":"sha512-hMs0miHt9qQuOT5F2plMbjMmrasWwNX1OqW/nJeEMXqbJhamRmm4nQ4z0APBltCd9X/t2slWZK2rHUqx7Xph3Q==","signatures":[{"sig":"MEUCIQDEjiyRATZTThPqIE/lC4zIcotl8ypfIvZbCLYxSHnvjQIgYVRtsDrYoZ4pCcdyybTI7I4A7WNQgRGgHyK6hcONN/4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8210741},"main":"./dist/index.js","type":"module","_from":"file:aegis-protocol-mcp-server-0.1.2.tgz","types":"./dist/index.d.ts","mcpName":"io.github.im-sham/aegis-protocol","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit","test":"vitest run","build":"tsup","start":"node dist/index.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"srehman","email":"shamim.a.rehman@gmail.com"},"_resolved":"/private/var/folders/85/4f5_fj8n0l16bmqzsw6rz1p40000gn/T/10ab596d3e23a34a04ddb4277fdc1213/aegis-protocol-mcp-server-0.1.2.tgz","_integrity":"sha512-hMs0miHt9qQuOT5F2plMbjMmrasWwNX1OqW/nJeEMXqbJhamRmm4nQ4z0APBltCd9X/t2slWZK2rHUqx7Xph3Q==","repository":{"url":"git+https://github.com/im-sham/aegis-protocol.git","type":"git","directory":"mcp"},"_npmVersion":"10.8.2","description":"MCP Server for the AEGIS Protocol — trustless escrow for AI agent transactions","directories":{},"_nodeVersion":"20.17.0","dependencies":{"zod":"^3.23.0","viem":"^2.0.0","@aegis-protocol/sdk":"0.1.0","@aegis-protocol/abis":"0.1.0","@aegis-protocol/types":"0.1.0","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","tsup":"^8.0.0","vitest":"^2.0.0","typescript":"^5.5.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.2_1771633498757_0.7879806669770215","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@aegis-protocol/mcp-server","version":"0.1.3","keywords":["mcp","model-context-protocol","aegis","escrow","ai-agents","erc-8004","base","usdc"],"license":"MIT","_id":"@aegis-protocol/mcp-server@0.1.3","maintainers":[{"name":"srehman","email":"shamim.a.rehman@gmail.com"}],"homepage":"https://github.com/im-sham/aegis-protocol#readme","bugs":{"url":"https://github.com/im-sham/aegis-protocol/issues"},"bin":{"aegis-mcp":"dist/index.js"},"dist":{"shasum":"70385dcc1b5e08ac1953051af02a0868f2755d39","tarball":"https://registry.npmjs.org/@aegis-protocol/mcp-server/-/mcp-server-0.1.3.tgz","fileCount":22,"integrity":"sha512-DwV43B4BpTiCwZb7GJh0b8vnt8GqvtnvxuH18mvlzvpGFdWRFUlauKOlGdM85lfG07uK1lTDWxh9f7em0ma+0g==","signatures":[{"sig":"MEUCIQC5YSeUFkHb90nziOnRS8tbDG6OMOdAtlRkuPg4wmYJNAIgOb1hcpkZOSegc0eZwzIMdO9qDDchnA8dkeB0PjptG+s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8224833},"main":"./dist/index.js","type":"module","_from":"file:aegis-protocol-mcp-server-0.1.3.tgz","types":"./dist/index.d.ts","mcpName":"io.github.im-sham/aegis-protocol","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit","test":"vitest run","build":"tsup","start":"node dist/index.js","typecheck":"tsc --noEmit","test:watch":"vitest"},"_npmUser":{"name":"srehman","email":"shamim.a.rehman@gmail.com"},"_resolved":"/private/var/folders/85/4f5_fj8n0l16bmqzsw6rz1p40000gn/T/8b5af9696e312ff62b07f5ff2b456518/aegis-protocol-mcp-server-0.1.3.tgz","_integrity":"sha512-DwV43B4BpTiCwZb7GJh0b8vnt8GqvtnvxuH18mvlzvpGFdWRFUlauKOlGdM85lfG07uK1lTDWxh9f7em0ma+0g==","repository":{"url":"git+https://github.com/im-sham/aegis-protocol.git","type":"git","directory":"mcp"},"_npmVersion":"10.8.2","description":"MCP Server for the AEGIS Protocol — trustless escrow for AI agent transactions","directories":{},"_nodeVersion":"20.17.0","dependencies":{"zod":"^3.23.0","viem":"^2.0.0","@aegis-protocol/sdk":"0.1.1","@aegis-protocol/abis":"0.1.1","@aegis-protocol/types":"0.1.1","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","tsup":"^8.0.0","vitest":"^2.0.0","typescript":"^5.5.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.3_1771695673532_0.5750046489895015","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-02-18T20:03:34.937Z","modified":"2026-05-11T14:39:18.602Z","0.1.0":"2026-02-18T20:03:35.221Z","0.1.1":"2026-02-20T23:23:36.587Z","0.1.2":"2026-02-21T00:24:59.018Z","0.1.3":"2026-02-21T17:41:13.788Z"},"bugs":{"url":"https://github.com/im-sham/aegis-protocol/issues"},"license":"MIT","homepage":"https://github.com/im-sham/aegis-protocol#readme","keywords":["mcp","model-context-protocol","aegis","escrow","ai-agents","erc-8004","base","usdc"],"repository":{"url":"git+https://github.com/im-sham/aegis-protocol.git","type":"git","directory":"mcp"},"description":"MCP Server for the AEGIS Protocol — trustless escrow for AI agent transactions","maintainers":[{"email":"shamim.a.rehman@gmail.com","name":"srehman"},{"email":"pallas@aegis-protocol.xyz","name":"pallas-aegis"}],"readme":"# @aegis-protocol/mcp-server\n\nMCP (Model Context Protocol) server for the AEGIS Protocol — trustless escrow for AI agent-to-agent transactions.\n\nEnables any MCP-compatible AI agent (Claude, GPT, Gemini) to autonomously create escrow jobs, deliver work, check status, settle payments, and open disputes through the AEGIS Protocol on Base L2.\n\n[![npm](https://img.shields.io/npm/v/@aegis-protocol/mcp-server)](https://www.npmjs.com/package/@aegis-protocol/mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## Quick Start\n\n### Install via npx (recommended)\n\nNo installation required — runs directly from npm:\n\n```json\n{\n  \"mcpServers\": {\n    \"aegis\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aegis-protocol/mcp-server\"],\n      \"env\": {\n        \"AEGIS_CHAIN\": \"base-sepolia\"\n      }\n    }\n  }\n}\n```\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json` (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"aegis\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aegis-protocol/mcp-server\"],\n      \"env\": {\n        \"AEGIS_CHAIN\": \"base-sepolia\"\n      }\n    }\n  }\n}\n```\n\n### With signing (local trusted setup)\n\n```json\n{\n  \"mcpServers\": {\n    \"aegis\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aegis-protocol/mcp-server\"],\n      \"env\": {\n        \"AEGIS_CHAIN\": \"base-sepolia\",\n        \"AEGIS_PRIVATE_KEY\": \"0x...\"\n      }\n    }\n  }\n}\n```\n\n## Tools\n\n### Job Lifecycle\n\n| Tool | Description |\n|------|-------------|\n| `aegis_create_job` | Create a trustless escrow job between two AI agents |\n| `aegis_deliver_work` | Submit completed work for on-chain validation |\n| `aegis_check_job` | Check the current state of an escrow job |\n| `aegis_settle_job` | Settle a job (confirm delivery or settle after window) |\n| `aegis_open_dispute` | Initiate 3-tier dispute resolution |\n| `aegis_claim_refund` | Claim refund on an expired job |\n\n### Agent Discovery\n\n| Tool | Description |\n|------|-------------|\n| `aegis_lookup_agent` | Look up an agent's identity, wallet, and ERC-8004 reputation |\n| `aegis_list_jobs` | List all escrow jobs for a specific agent |\n\n### Utility\n\n| Tool | Description |\n|------|-------------|\n| `aegis_check_balance` | Check USDC balance and escrow approval |\n| `aegis_get_template` | Get a job template's default parameters |\n\n## Operating Modes\n\n### Read-only (default)\n\nWhen no `AEGIS_PRIVATE_KEY` is set, write tools return unsigned transaction calldata. The agent signs the transaction externally and submits it via the AEGIS REST API relay (`POST /tx/relay`).\n\n### Signing mode\n\nWhen `AEGIS_PRIVATE_KEY` is set, write tools execute transactions directly on-chain. Use this for trusted local setups.\n\n## Configuration\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `AEGIS_CHAIN` | Target chain (`base-sepolia` or `base`) | `base-sepolia` |\n| `AEGIS_RPC_URL` | RPC endpoint URL | Chain default |\n| `AEGIS_PRIVATE_KEY` | Private key for signing (optional) | — |\n| `AEGIS_API_URL` | REST API URL for relay (optional) | — |\n\n## Registries\n\n- **npm**: [@aegis-protocol/mcp-server](https://www.npmjs.com/package/@aegis-protocol/mcp-server)\n- **Smithery**: [aegis-protocol](https://smithery.ai/server/@aegis-protocol/mcp-server) *(pending)*\n- **MCP Registry**: [io.github.im-sham/aegis-protocol](https://registry.modelcontextprotocol.io) *(pending)*\n\n## Development\n\n```bash\n# Install dependencies\npnpm install\n\n# Build\npnpm build\n\n# Run tests\npnpm test\n\n# Development mode\npnpm dev\n\n# Typecheck\npnpm typecheck\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}