prism-wallet MCP v0.1.0

Model Context Protocol server for Prism Wallet. Read your accounts, transactions, budgets, holdings, and net worth — and ask the Prism financial AI — from any MCP-compatible client.

Base URL: https://prism-mcp-677461572521.us-central1.run.app

/docs.json · /health

1. Get an API key

Provision API keys from the Prism Wallet mobile app:

1. Open the Prism Wallet mobile app.
2. Open the drawer menu (top-left).
3. Tap "API Keys".
4. Create a new key, give it a name (e.g. "Claude Desktop"), and pick scopes.
5. Copy the token immediately — it is only shown once.

Tokens look like mcp_<64 hex chars> and are shown exactly once. Pick scopes when you create the key (see below).

2. Available scopes

• mcp:read — Default scope. Grants every read tool and every resource. Does not allow mutations.
• mcp:write — Grants the budget, categorization, and digest write tools in addition to read access.
• mcp:* — Wildcard — grants all current and future MCP scopes.

3. Connect with curl

Sanity-check the connection with a JSON-RPC initialize call:

curl -X POST https://prism-mcp-677461572521.us-central1.run.app/mcp \
  -H "Authorization: Bearer mcp_YOUR_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

4. Connect from an MCP client

Pick your client below. All snippets use a placeholder token — replace mcp_YOUR_TOKEN_HERE with the token you minted in step 1.

Jump to: Claude Code (CLI) · Claude Desktop · Cursor · VS Code · Windsurf · Any other MCP client

Claude Code (CLI)

Run from any terminal

claude mcp add --transport http prism-wallet https://prism-mcp-677461572521.us-central1.run.app/mcp \
  --header "Authorization: Bearer mcp_YOUR_TOKEN_HERE"

Adds the server for the current user. Use --scope project to commit a .mcp.json to a repo instead. Verify with `claude mcp list`.

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "prism-wallet": {
      "url": "https://prism-mcp-677461572521.us-central1.run.app/mcp",
      "headers": {
        "Authorization": "Bearer mcp_YOUR_TOKEN_HERE"
      }
    }
  }
}

Quit and relaunch Claude Desktop after editing. Prism tools show up in the MCP tool picker once the connection is healthy.

Cursor

Global: ~/.cursor/mcp.json
Per-project: <repo>/.cursor/mcp.json

{
  "mcpServers": {
    "prism-wallet": {
      "url": "https://prism-mcp-677461572521.us-central1.run.app/mcp",
      "headers": {
        "Authorization": "Bearer mcp_YOUR_TOKEN_HERE"
      }
    }
  }
}

Or use Cursor → Settings → MCP → "Add new MCP server" and paste the same JSON.

VS Code

Workspace: .vscode/mcp.json
User settings: settings.json under "mcp"

{
  "servers": {
    "prism-wallet": {
      "type": "http",
      "url": "https://prism-mcp-677461572521.us-central1.run.app/mcp",
      "headers": {
        "Authorization": "Bearer mcp_YOUR_TOKEN_HERE"
      }
    }
  }
}

VS Code requires an MCP-capable extension (e.g. GitHub Copilot Chat with MCP enabled). Reload the window after saving.

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "prism-wallet": {
      "url": "https://prism-mcp-677461572521.us-central1.run.app/mcp",
      "headers": {
        "Authorization": "Bearer mcp_YOUR_TOKEN_HERE"
      }
    }
  }
}

Open Windsurf → Cascade → MCP settings → Refresh after editing the file.

Any other MCP client

Streamable HTTP, JSON-RPC 2.0

{
  "mcpServers": {
    "prism-wallet": {
      "url": "https://prism-mcp-677461572521.us-central1.run.app/mcp",
      "headers": {
        "Authorization": "Bearer mcp_YOUR_TOKEN_HERE"
      }
    }
  }
}

POST JSON-RPC to /mcp with the Authorization: Bearer header. Most clients accept the mcpServers shape above; otherwise consult that client's MCP docs.

5. claude.ai (web)

On claude.ai, go to Settings → Connectors → "Add custom connector" and paste these three values:

Claude opens a Prism sign-in page in your browser; sign in with your normal Prism email + password and approve. That's it — no further setup. You'll authorize once and Claude refreshes its access automatically.

6. Tools

7. Resources

Read-only data sources addressable via MCP resource URIs.

All data is automatically scoped to the API key owner. Tokens are stored hashed (SHA-256); revoke a key any time from the same "API Keys" screen in the mobile app.