Quickstart

Prerequisites

• An Advisors Crypto managed-account login. The agent platform is included with your advisory subscription.
• An active Investment Policy Statement on file.
• One of: Node ≥ 20 (for MCP), or any HTTP client.

1 · Mint an agent key

Sign in to the app and open /agent. Click New key, pick scopes — for this quickstart, read and validate are enough. The plaintext key is shown exactly once. Copy it now.

2 · Install

Option A — MCP (Claude Desktop, Cursor)

Add the server to your client’s MCP config. For Claude Desktop on macOS, edit ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Restart your client. Six tools, two resources, and two prompts will appear.

Option B — Direct REST

Skip the package. Hit the API directly.

curl -X POST https://api.advisorscrypto.com/api/agent/v1/policy/validate \
  -H "Authorization: Bearer ac_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "buy",
    "assetSymbol": "BTC",
    "assetType": "crypto",
    "amountUsd": 5000
  }'

3 · Make your first call

Ask your agent: “Use whoami to confirm the AC key is wired up.” Or hit the endpoint directly:

curl -H "Authorization: Bearer ac_live_…" \
  https://api.advisorscrypto.com/api/agent/v1/whoami

You should get back something like:

{
  "userId": "8d0a1f8b-…",
  "scopes": ["read", "validate"],
  "productLine":
    "AC Policy Layer — agents propose, the IPS decides, humans attest."
}

4 · Next steps

• Read the policy layer to understand the wedge before you ship.
• Browse the API reference for full request and response shapes.
• See the Claude Desktop guide for the canonical install path with screenshots.