{"_id":"@aura-payments/mcp-server","_rev":"4-eb154fe3cd81fc6c90bd0ed159203080","name":"@aura-payments/mcp-server","dist-tags":{"latest":"1.2.0"},"versions":{"1.0.0":{"name":"@aura-payments/mcp-server","version":"1.0.0","keywords":["aura","payments","mcp","model-context-protocol","ai-agents","claude","anthropic","escrow","usdc","blockchain"],"author":{"name":"Aura Payments"},"license":"MIT","_id":"@aura-payments/mcp-server@1.0.0","maintainers":[{"name":"humancodex","email":"aurapaymentslab@gmail.com"}],"bin":{"aura-mcp":"dist/bin.js"},"dist":{"shasum":"1cb75f137331f828c1e4d2f7e09803010400d22d","tarball":"https://registry.npmjs.org/@aura-payments/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":12,"integrity":"sha512-Dl5i2aj0SxJEjPDr2DYvDG9CF8F/MSD8ifi+or0YXK/TsVNQOWjgb5peHsieNFrKBlXRDBh/+w3PujS5dRVzdw==","signatures":[{"sig":"MEQCIB+nnhaYVfzLebS2sd/BPsU+VF/CHLNpQI0QDREjxTl7AiBEGNHuuYyPiKv60H08TzZuy/k50+avmdwPDkGLPm5wbA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":286968},"main":"./dist/index.js","_from":"file:aura-payments-mcp-server-1.0.0.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"scripts":{"dev":"tsup --watch","lint":"eslint src --ext .ts","build":"tsup","typecheck":"tsc --noEmit"},"_npmUser":{"name":"humancodex","email":"aurapaymentslab@gmail.com"},"_resolved":"/private/var/folders/c7/06b9xh_57rn7dpbqy0wvs8lw0000gn/T/0fae9af42a5944ee2dbcbe5a85c5f802/aura-payments-mcp-server-1.0.0.tgz","_integrity":"sha512-Dl5i2aj0SxJEjPDr2DYvDG9CF8F/MSD8ifi+or0YXK/TsVNQOWjgb5peHsieNFrKBlXRDBh/+w3PujS5dRVzdw==","_npmVersion":"11.17.0","description":"Model Context Protocol server for Aura Payments. Lets AI agents and LLMs (Claude Desktop, Cursor, Continue, etc.) drive Aura escrows, mandates, and agent governance natively.","directories":{},"_nodeVersion":"26.5.0","dependencies":{"zod":"^3.25.76","@aura-payments/sdk":"2.1.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","typescript":"^5","@types/node":"^22"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.0_1786064436466_0.1657775178804406","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@aura-payments/mcp-server","version":"1.0.1","keywords":["aura","payments","mcp","model-context-protocol","ai-agents","claude","anthropic","escrow","usdc","blockchain"],"author":{"name":"Aura Payments"},"license":"MIT","_id":"@aura-payments/mcp-server@1.0.1","maintainers":[{"name":"humancodex","email":"aurapaymentslab@gmail.com"}],"homepage":"https://getaura.sh","bugs":{"url":"https://github.com/humancodex/ap/issues"},"bin":{"aura-mcp":"dist/bin.js"},"dist":{"shasum":"48b9ae38f4de6e42d89048b52271f2a178ff106d","tarball":"https://registry.npmjs.org/@aura-payments/mcp-server/-/mcp-server-1.0.1.tgz","fileCount":8,"integrity":"sha512-AVz/1pJHD/9TJ/Z+8/sASU0FCK95MMDfjuCb7gggENdTIv+/M1+PDBges5HY6KFAsLEX5jbOC13oitvjdSi5gw==","signatures":[{"sig":"MEUCIQClGJT8asw9x+xsL5C0z7EtBYsoo49fYnL3TUxYj/1vbQIgc3ny1wdx03e+TmZWy2i/L+TqraR0fahTpyyJMrZ0nI4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":94642},"main":"./dist/index.js","_from":"file:aura-payments-mcp-server-1.0.1.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"scripts":{"dev":"tsup --watch","lint":"eslint src --ext .ts","build":"tsup","typecheck":"tsc --noEmit"},"_npmUser":{"name":"humancodex","email":"aurapaymentslab@gmail.com"},"_resolved":"/private/var/folders/c7/06b9xh_57rn7dpbqy0wvs8lw0000gn/T/ee6fc3e980b787e6b659ea881648523e/aura-payments-mcp-server-1.0.1.tgz","_integrity":"sha512-AVz/1pJHD/9TJ/Z+8/sASU0FCK95MMDfjuCb7gggENdTIv+/M1+PDBges5HY6KFAsLEX5jbOC13oitvjdSi5gw==","repository":{"url":"git+https://github.com/humancodex/ap.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.17.0","description":"Model Context Protocol server for Aura Payments. Lets AI agents and LLMs (Claude Desktop, Cursor, Continue, etc.) drive Aura escrows, mandates, and agent governance natively.","directories":{},"_nodeVersion":"26.5.0","dependencies":{"zod":"^3.25.76","@aura-payments/sdk":"2.1.1","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","typescript":"^5","@types/node":"^22"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.1_1786300124332_0.6400291026192","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@aura-payments/mcp-server","version":"1.1.0","keywords":["aura","payments","mcp","model-context-protocol","ai-agents","claude","anthropic","escrow","usdc","blockchain"],"author":{"name":"Aura Payments"},"license":"MIT","_id":"@aura-payments/mcp-server@1.1.0","maintainers":[{"name":"humancodex","email":"aurapaymentslab@gmail.com"}],"homepage":"https://getaura.sh","bugs":{"url":"https://github.com/humancodex/ap/issues"},"bin":{"aura-mcp":"dist/bin.js"},"dist":{"shasum":"f44521c111b64a29a78a89cd64502ac380667b0c","tarball":"https://registry.npmjs.org/@aura-payments/mcp-server/-/mcp-server-1.1.0.tgz","fileCount":8,"integrity":"sha512-md4lBn7gWpodnLJj9/9RVgYZRXodkW18uL+oyN+KQNkqifmSjBV4W0TN6ni+L+pJtILguB4OyNyNYs5BE7ML5Q==","signatures":[{"sig":"MEQCIBRh5PksW8oqP1dEw6sAFaZENmw2zbQ0ek02D4h+MaJ6AiAl/WbbIliOyjGavU6BHI4D1DjWnKyQ62IGw+wii5CHxA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":139390},"main":"./dist/index.js","_from":"file:aura-payments-mcp-server-1.1.0.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"scripts":{"dev":"tsup --watch","lint":"eslint src --ext .ts","test":"node --test --experimental-strip-types 'src/**/*.test.ts'","build":"tsup","pretest":"pnpm --filter @aura-payments/shared --filter @aura-payments/sdk build","typecheck":"tsc --noEmit"},"_npmUser":{"name":"humancodex","email":"aurapaymentslab@gmail.com"},"_resolved":"/private/var/folders/c7/06b9xh_57rn7dpbqy0wvs8lw0000gn/T/0af7920a71665978a7f0cc8286a1fc51/aura-payments-mcp-server-1.1.0.tgz","_integrity":"sha512-md4lBn7gWpodnLJj9/9RVgYZRXodkW18uL+oyN+KQNkqifmSjBV4W0TN6ni+L+pJtILguB4OyNyNYs5BE7ML5Q==","repository":{"url":"git+https://github.com/humancodex/ap.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.17.0","description":"Model Context Protocol server for Aura Payments. Lets AI agents and LLMs (Claude Desktop, Cursor, Continue, etc.) drive Aura escrows, mandates, wallets, webhooks, and agent governance natively.","directories":{},"_nodeVersion":"26.5.0","dependencies":{"zod":"^3.25.76","@aura-payments/sdk":"2.1.1","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","typescript":"^5","@types/node":"^22"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.1.0_1786577032377_0.813595136931093","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@aura-payments/mcp-server","version":"1.2.0","description":"Model Context Protocol server for Aura Payments. Lets AI agents and LLMs (Claude Desktop, Cursor, Continue, etc.) drive Aura escrows, mandates, wallets, webhooks, and agent governance natively.","main":"./dist/index.js","module":"./dist/index.mjs","types":"./dist/index.d.ts","bin":{"aura-mcp":"dist/bin.js"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.js"}},"keywords":["aura","payments","mcp","model-context-protocol","ai-agents","claude","anthropic","escrow","usdc","blockchain"],"author":{"name":"Aura Payments"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/humancodex/ap.git","directory":"packages/mcp-server"},"homepage":"https://getaura.sh","bugs":{"url":"https://github.com/humancodex/ap/issues"},"engines":{"node":">=20.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","zod":"^3.25.76","@aura-payments/sdk":"2.2.0"},"devDependencies":{"@types/node":"^22","tsup":"^8.3.5","typescript":"^5"},"publishConfig":{"access":"public"},"scripts":{"build":"tsup","dev":"tsup --watch","lint":"eslint src --ext .ts","test":"node --test --experimental-strip-types 'src/**/*.test.ts'","typecheck":"tsc --noEmit","pretest":"pnpm --filter @aura-payments/shared --filter @aura-payments/sdk build"},"_id":"@aura-payments/mcp-server@1.2.0","_integrity":"sha512-LjzlWHG1LYMvoZhmFp3ysjBU9rdx96I03VqbmyDUxIXXQ4z7t2FJOfFFfiaYcoX3V+HBoTCOATELIhUHaZYonw==","_resolved":"/private/var/folders/c7/06b9xh_57rn7dpbqy0wvs8lw0000gn/T/b4539830c6923e5dd3bcc29c92d79d85/aura-payments-mcp-server-1.2.0.tgz","_from":"file:aura-payments-mcp-server-1.2.0.tgz","_nodeVersion":"26.5.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-LjzlWHG1LYMvoZhmFp3ysjBU9rdx96I03VqbmyDUxIXXQ4z7t2FJOfFFfiaYcoX3V+HBoTCOATELIhUHaZYonw==","shasum":"a63651dc967aa9a93c0203980b512c26e87d0e20","tarball":"https://registry.npmjs.org/@aura-payments/mcp-server/-/mcp-server-1.2.0.tgz","fileCount":8,"unpackedSize":188920,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCXxrLMTL6kcju9cOMVNvrICQJR/PFPVX74YBahgFd9uwIgG4fevWyq7dSVN4/ExWVVwJmCpvP3rGfeigcHD8KqOXM="}]},"_npmUser":{"name":"humancodex","email":"aurapaymentslab@gmail.com"},"directories":{},"maintainers":[{"name":"humancodex","email":"aurapaymentslab@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_1.2.0_1786729061585_0.272289641074007"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-07T01:00:36.317Z","modified":"2026-08-14T17:37:41.911Z","1.0.0":"2026-08-07T01:00:36.642Z","1.0.1":"2026-08-09T18:28:44.539Z","1.1.0":"2026-08-12T23:23:52.531Z","1.2.0":"2026-08-14T17:37:41.728Z"},"bugs":{"url":"https://github.com/humancodex/ap/issues"},"author":{"name":"Aura Payments"},"license":"MIT","homepage":"https://getaura.sh","keywords":["aura","payments","mcp","model-context-protocol","ai-agents","claude","anthropic","escrow","usdc","blockchain"],"repository":{"type":"git","url":"git+https://github.com/humancodex/ap.git","directory":"packages/mcp-server"},"description":"Model Context Protocol server for Aura Payments. Lets AI agents and LLMs (Claude Desktop, Cursor, Continue, etc.) drive Aura escrows, mandates, wallets, webhooks, and agent governance natively.","maintainers":[{"name":"humancodex","email":"aurapaymentslab@gmail.com"}],"readme":"# `@aura-payments/mcp-server`\n\nModel Context Protocol server for Aura Payments. Drop it into Claude\nDesktop, Cursor, Continue, or any other MCP host and your AI agent can\ncreate escrows, manage agents, approve mandates, and check wallet\nbalances natively, without writing HTTP boilerplate.\n\n## Install\n\n```bash\nnpm install -g @aura-payments/mcp-server\n# or invoke directly via npx (no install)\nnpx @aura-payments/mcp-server\n```\n\n## Configure (Claude Desktop / Cursor / any MCP client)\n\nAdd this to your `mcp.json` (paths vary by host, e.g.\n`~/Library/Application Support/Claude/mcp.json` for Claude Desktop on\nmacOS, `~/.cursor/mcp.json` for Cursor):\n\n```json\n{\n  \"mcpServers\": {\n    \"aura\": {\n      \"command\": \"aura-mcp\",\n      \"env\": {\n        \"AURA_API_KEY\": \"pk_live_...\"\n      }\n    }\n  }\n}\n```\n\nGet an API key at <https://getaura.sh>.\n\n### Optional env\n\n| Variable                | Default                       | Purpose                                              |\n| ----------------------- | ----------------------------- | ---------------------------------------------------- |\n| `AURA_API_KEY`          | (required)                    | Your platform API key (`pk_live_*` or `pk_test_*`)   |\n| `AURA_BASE_URL`         | `https://tryaura.xyz/api`     | Override for self-hosted or staging deployments      |\n| `AURA_AUTO_IDEMPOTENCY` | `true`                        | Auto-generate idempotency keys for POST/PUT requests |\n\n## Tools\n\n| Tool                       | What it does                                                                                                            |\n| -------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| `aura_create_escrow`       | Create a new escrow with payment splits across vendor/platform/seller wallets                                           |\n| `aura_get_escrow`          | Get the current state of an escrow                                                                                      |\n| `aura_list_escrows`        | List escrows with state/sort/search filters                                                                             |\n| `aura_fund_escrow`         | Fund an escrow from the buyer wallet                                                                                    |\n| `aura_release_escrow`      | Release a funded escrow to recipients per the splits                                                                    |\n| `aura_refund_escrow`       | Refund a funded escrow back to the buyer                                                                                |\n| `aura_create_agent`        | Create a new AI agent with a dedicated wallet and optional initial spending policy                                      |\n| `aura_list_agents`         | List agents (filter by status/type, paginated)                                                                          |\n| `aura_get_agent`           | Get a single agent by id                                                                                                |\n| `aura_get_agent_balance`   | Get an agent's current USDC wallet balance (on-chain)                                                                   |\n| `aura_freeze_agent`        | Kill switch — pause the agent and cascade-reject every pending mandate it has in flight                                 |\n| `aura_unfreeze_agent`      | Resume a frozen agent                                                                                                   |\n| `aura_evaluate_policy`     | Run a hypothetical transaction through the policy engine without executing it                                           |\n| `aura_list_mandates`       | List operator mandates (defaults to status=pending — the inbox)                                                         |\n| `aura_get_mandate`         | Get a single mandate by id                                                                                              |\n| `aura_approve_mandate`     | Approve a pending mandate. Requires a precomputed HMAC decision signature (the LLM never sees the secret).              |\n| `aura_reject_mandate`      | Reject a pending mandate. Same signature scheme.                                                                        |\n| `aura_get_wallet_balance`  | Get any wallet's USDC balance                                                                                           |\n\n## Resources\n\n| URI                              | Returns                                                |\n| -------------------------------- | ------------------------------------------------------ |\n| `aura://agents/{id}`             | Full agent record (status, wallet, type, etc.)         |\n| `aura://agents/{id}/balance`     | Current on-chain USDC balance                          |\n| `aura://mandates/pending`        | The operator's inbox (50 most-urgent pending mandates) |\n| `aura://mandates/{id}`           | Full mandate record (intent, status, decision history) |\n\n## Try it\n\nOnce configured, ask your AI agent:\n\n> \"Using Aura, create a $50 USDC escrow on ARC, splitting 80% to vendor wallet\n> `<vendor-uuid>` and 20% to platform wallet `<platform-uuid>`.\"\n\nThe agent should call `aura_create_escrow` and return the new escrow id.\n\n> \"List all my pending mandates.\"\n\nThe agent should call `aura_list_mandates` (defaults to pending) and show the\ninbox.\n\n## Approving mandates from an LLM\n\n`aura_approve_mandate` requires a precomputed HMAC-SHA256 signature over\n`${mandateId}:approve:${decidedAt}`. The LLM should NOT compute this — the\nsecret stays out of model context. Instead, use the Aura CLI (`aura mandates\napprove <id>`) or the mobile app to approve, and the LLM can confirm via\n`aura_get_mandate` that the decision landed.\n\nIf you want LLM-driven approval (e.g., for a fully autonomous ops agent),\nrun a thin trusted shim alongside the MCP server that holds the secret and\nexposes a non-MCP signing endpoint. That's deliberately not bundled here.\n\n## Errors\n\nEvery tool catches errors and returns them as structured `isError: true`\nresults so the LLM can read the message. The `errorCode` line tells the LLM\nwhat kind of error it is:\n\n| `errorCode`         | What it means                                                          |\n| ------------------- | ---------------------------------------------------------------------- |\n| `CONFIG_ERROR`      | `AURA_API_KEY` missing or unreadable                                   |\n| `AUTH_ERROR`        | Key is invalid, revoked, or unauthorized for the requested resource    |\n| `NOT_FOUND`         | The escrow / agent / mandate doesn't exist (or isn't yours)            |\n| `VALIDATION_ERROR`  | Request body failed server-side validation                             |\n| `RATE_LIMITED`      | Too many requests. Includes `retryAfter` when available                |\n| `TIMEOUT`           | Request exceeded the SDK timeout (default 30s)                         |\n| `API_ERROR_<code>`  | Generic platform error (5xx etc.)                                      |\n\n## License\n\nMIT.\n","readmeFilename":"README.md"}