@advisors-crypto/mcp

MCP server that lets any MCP-aware AI agent (Claude Desktop, Cursor, custom orchestrators) talk to Advisors Crypto's policy layer.

The product wedge: agents propose, the IPS decides, humans attest. There is intentionally no execute tool — every action that would mutate the portfolio gets routed to a human attestation queue in the AC app.

Setup

1. Mint an agent key at https://app.advisors.crypto/agent. Pick scopes (read, validate, propose).

2. Add the server to your MCP client config.

   Claude Desktop — edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

   {
     "mcpServers": {
       "advisors-crypto": {
         "command": "npx",
         "args": ["-y", "@advisors-crypto/mcp"],
         "env": {
           "AC_AGENT_KEY": "ac_live_…"
         }
       }
     }
   }

   Cursor — Settings → MCP → add the same JSON block.

   Custom client — run npx -y @advisors-crypto/mcp with AC_AGENT_KEY in env. Stdio transport; logs go to stderr.

3. Restart your client. Tools, resources, and prompts should appear.

What's exposed

Tools (6)

| Tool | Scope | Purpose | | --- | --- | --- | | whoami | read | Confirm key + user. | | get_mandate | read | Active IPS as a policy bundle. | | get_holdings | read | Portfolio across custodians. | | validate_trade | validate | Dry-run a trade. No side effects. | | propose_trade | propose | Submit for human attestation. | | get_audit | read | Recent guardrail decisions. |

Resources (2)

Read passively as context — no tool call needed.

• ac://mandate/current
• ac://holdings/current

Prompts (2)

Canned workflows surfaced by the host UI.

• review-portfolio — mandate + holdings drift review.
• propose-trade-with-rationale {idea} — validate then propose.

Environment

| Var | Default | Notes | | --- | --- | --- | | AC_AGENT_KEY | — | Required. Bearer token. | | AC_API_BASE | https://api.advisors.crypto | Override for preview envs. |

REST alternative

Don't want MCP? The same surface is available as REST under /api/agent/v1/*. OpenAPI spec at https://api.advisors.crypto/api/agent/v1/openapi.json. The in-app reference at https://app.advisors.crypto/agent lists endpoints + scopes + cURL/TS/Python snippets.

Versioning

This package follows semver. Tool, resource, and prompt names are considered stable surface — we won't rename them in a minor bump.