Skip to main content

Kryptos MCP Server

Connect your AI assistant — Claude, Cursor, or any other MCP-compatible tool — directly to your Kryptos account. Once connected, you can ask questions about your portfolio, review transactions, and clean up your data in plain English, without leaving your AI chat.

What is MCP? Model Context Protocol (MCP) is a standard that lets AI assistants securely talk to other services. Setting up the Kryptos MCP server is a one-time configuration in your AI app.

What you can do with it​

Once connected, you can ask your AI things like:

  • Check your portfolio — "What are my top holdings right now?"
  • Search transactions — "Show me every swap I did in January"
  • Review DeFi positions — "Where am I staked, and how much am I earning?"
  • Browse NFTs — "List my Bored Apes with current floor prices"
  • Find data issues — "Are any of my transactions missing prices or cost basis?"
  • Fix labels — "Recategorize all my Uniswap swaps as DeFi Swap"
  • Add missing trades — "Add a manual BTC purchase from January 2024"
  • Connect wallets — "Connect my Binance account" or "Add my Ethereum address"
  • Do your accounting — "Categorize my transactions and push the journals to Xero"

The server exposes its tools to your AI automatically, covering portfolio and transaction reads, reconciliation checks, wallet and portfolio management, and accounting/ERP workflows. You don't need to learn the tool names — describe what you want and your assistant picks the right ones. To see what is available in your session, ask it to "list my available tools".

Installation​

The Kryptos MCP Server uses OAuth 2.0 login. You paste a short config snippet into your AI tool, and the first time it connects a Kryptos login page opens in your browser. There is no API key to copy or store.

Server URL: https://mcp.kryptos.io

Cursor​

  1. Open Cursor Settings → MCP
  2. Add to mcp.json:
{
  "mcpServers": {
    "kryptos": {
      "type": "url",
      "url": "https://mcp.kryptos.io"
    }
  }
}

Claude Code (CLI)​

claude mcp add --transport http kryptos https://mcp.kryptos.io

Other MCP clients​

Any client supporting MCP over HTTP works — point it at https://mcp.kryptos.io and let it complete the OAuth flow in your browser.

What happens on first connect​

  1. Your AI app contacts the Kryptos MCP server
  2. A Kryptos login page opens in your browser
  3. You log in, exactly as you would at the dashboard
  4. Your AI is connected — no key to copy, no extra step

After setup​

Restart your AI app. Fully quit and reopen it so it picks up the new tools — a window reload is often not enough.

Then ask "list my available tools". You should see Kryptos tools in the response.

Troubleshooting​

It won't connect

  • Check your internet, and that your firewall isn't blocking mcp.kryptos.io
  • Test the server directly: open https://mcp.kryptos.io/health in a browser — you should get a small "ok" response

Tools don't show up

  • Fully quit and reopen your AI app
  • Validate your config file as JSON — a missing comma or bracket fails silently
  • Check your AI app's logs for MCP errors

Kryptos login fails

  • Confirm you can sign in normally at dashboard.kryptos.io
  • Remove the server from your config and add it again to start a fresh login
For developers: technical details

Transport: HTTP over TLS Protocol: Model Context Protocol (MCP) Authentication: OAuth 2.0 / OIDC Sessions: Token-based

MethodPathDescription
GET/healthHealth check
POST/mcpHTTP transport (OIDC auth)

Success:

{ "success": true, "data": { ... } }

Error:

{ "success": false, "error": "ERROR_CODE", "message": "..." }

The MCP server calls the same API documented under API Reference with the workspace bound to your OAuth grant, so anything it reports is reproducible with a direct API call.

Support​