{"_id":"@advisors-crypto/mcp","name":"@advisors-crypto/mcp","dist-tags":{"latest":"0.2.0"},"versions":{"0.2.0":{"name":"@advisors-crypto/mcp","version":"0.2.0","description":"MCP server for Advisors Crypto — policy-layer access for AI agents. Read state, validate trades against an IPS, propose for human attestation. No execute scope by design.","type":"module","bin":{"advisors-crypto-mcp":"dist/index.js"},"main":"dist/index.js","scripts":{"build":"tsc","dev":"tsx watch src/index.ts","start":"node dist/index.js","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"keywords":["advisors-crypto","mcp","model-context-protocol","agent","ai","claude","cursor","policy-layer","investment-policy"],"homepage":"https://app.advisorscrypto.com/agents","repository":{"type":"git","url":"git+https://github.com/AdvisorsCrypto/ac-monorepo.git","directory":"apps/mcp-server"},"bugs":{"url":"https://github.com/AdvisorsCrypto/ac-monorepo/issues"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.23.8"},"devDependencies":{"@types/node":"^22.0.0","tsx":"^4.19.0","typescript":"^5.6.0"},"engines":{"node":">=20"},"_id":"@advisors-crypto/mcp@0.2.0","gitHead":"2902cdb1075b539d7686cc1ac9e2a78ab6cf70b3","types":"./dist/index.d.ts","_nodeVersion":"23.11.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-ZLRtEImKpcftI8fMGsEpPusz7RZ4bl52rAd/TqzzUtCAgxKBO9l8Lac6gn5YmLKW4ZFBsUJiZ/sRMlv9iuTf2Q==","shasum":"cb82c0aff71abc6c145c9bc98f721f0fcce2188d","tarball":"https://registry.npmjs.org/@advisors-crypto/mcp/-/mcp-0.2.0.tgz","fileCount":9,"unpackedSize":23942,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDPHn5uL0GafZ+XFPb6k12pbpcwBvYApw1ts4Ge1oRHVAiEA1/yLXdKPOKgQEIVkGt+qEh9XGhpjusBmxIdoGncbASY="}]},"_npmUser":{"name":"advisorscrypto","email":"support@advisorscrypto.com"},"directories":{},"maintainers":[{"name":"advisorscrypto","email":"support@advisorscrypto.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.2.0_1781708391206_0.4180272660843556"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-17T14:59:51.054Z","0.2.0":"2026-06-17T14:59:51.349Z","modified":"2026-06-17T14:59:51.636Z"},"maintainers":[{"name":"advisorscrypto","email":"support@advisorscrypto.com"}],"description":"MCP server for Advisors Crypto — policy-layer access for AI agents. Read state, validate trades against an IPS, propose for human attestation. No execute scope by design.","homepage":"https://app.advisorscrypto.com/agents","keywords":["advisors-crypto","mcp","model-context-protocol","agent","ai","claude","cursor","policy-layer","investment-policy"],"repository":{"type":"git","url":"git+https://github.com/AdvisorsCrypto/ac-monorepo.git","directory":"apps/mcp-server"},"bugs":{"url":"https://github.com/AdvisorsCrypto/ac-monorepo/issues"},"license":"MIT","readme":"# @advisors-crypto/mcp\n\nMCP server that lets any MCP-aware AI agent (Claude Desktop, Cursor,\ncustom orchestrators) talk to Advisors Crypto's policy layer.\n\n> **The product wedge:** agents propose, the IPS decides, humans\n> attest. There is intentionally **no execute tool** — every action\n> that would mutate the portfolio gets routed to a human attestation\n> queue in the AC app.\n\n## Setup\n\n1. Mint an agent key at https://app.advisors.crypto/agent. Pick\n   scopes (`read`, `validate`, `propose`).\n2. Add the server to your MCP client config.\n\n   **Claude Desktop** — edit\n   `~/Library/Application Support/Claude/claude_desktop_config.json`\n   (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n   ```json\n   {\n     \"mcpServers\": {\n       \"advisors-crypto\": {\n         \"command\": \"npx\",\n         \"args\": [\"-y\", \"@advisors-crypto/mcp\"],\n         \"env\": {\n           \"AC_AGENT_KEY\": \"ac_live_…\"\n         }\n       }\n     }\n   }\n   ```\n\n   **Cursor** — Settings → MCP → add the same JSON block.\n\n   **Custom client** — run `npx -y @advisors-crypto/mcp` with\n   `AC_AGENT_KEY` in env. Stdio transport; logs go to stderr.\n\n3. Restart your client. Tools, resources, and prompts should appear.\n\n## What's exposed\n\n### Tools (6)\n| Tool | Scope | Purpose |\n| --- | --- | --- |\n| `whoami` | `read` | Confirm key + user. |\n| `get_mandate` | `read` | Active IPS as a policy bundle. |\n| `get_holdings` | `read` | Portfolio across custodians. |\n| `validate_trade` | `validate` | Dry-run a trade. No side effects. |\n| `propose_trade` | `propose` | Submit for human attestation. |\n| `get_audit` | `read` | Recent guardrail decisions. |\n\n### Resources (2)\nRead passively as context — no tool call needed.\n- `ac://mandate/current`\n- `ac://holdings/current`\n\n### Prompts (2)\nCanned workflows surfaced by the host UI.\n- `review-portfolio` — mandate + holdings drift review.\n- `propose-trade-with-rationale {idea}` — validate then propose.\n\n## Environment\n\n| Var | Default | Notes |\n| --- | --- | --- |\n| `AC_AGENT_KEY` | — | Required. Bearer token. |\n| `AC_API_BASE` | `https://api.advisors.crypto` | Override for preview envs. |\n\n## REST alternative\n\nDon't want MCP? The same surface is available as REST under\n`/api/agent/v1/*`. OpenAPI spec at\n`https://api.advisors.crypto/api/agent/v1/openapi.json`. The\nin-app reference at `https://app.advisors.crypto/agent` lists\nendpoints + scopes + cURL/TS/Python snippets.\n\n## Versioning\n\nThis package follows semver. Tool, resource, and prompt names are\nconsidered stable surface — we won't rename them in a minor bump.\n","readmeFilename":"README.md","_rev":"1-a7b56e459a46c355b756d72f80ead1de"}