TARS MCP Server

Lets Claude Desktop, Cursor, and other MCP-compatible agents call TARS Scanner as built-in tools.

What it does

Exposes 5 tools to the host agent:

• tars_scan_pumpfun({ mint }) — pump.fun token risk scan ($0.50)
• tars_scan_token({ mint }) — generic SPL token scan ($0.30)
• tars_scan_wallet({ address }) — wallet counterparty risk ($0.02)
• tars_verify_tx({ signature }) — transaction post-mortem ($0.05)
• tars_scan_program({ program_id }) — Solana program audit ($1.00)

Each tool returns the full scan JSON from the TARS API (risk_score, flags, summary, recommendation, evidence).

Build

pnpm --filter @tars/mcp build

This produces apps/mcp/dist/index.js which is the executable entry point.

Install in Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "tars": {
      "command": "node",
      "args": ["/absolute/path/to/tars/apps/mcp/dist/index.js"],
      "env": {
        "TARS_API_URL": "https://api.tarsx402.network",
        "TARS_PAYMENT_HEADER": "mock-paid"
      }
    }
  }
}

Restart Claude Desktop. The TARS tools appear in the tools list.

Install in Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "tars": {
      "command": "node",
      "args": ["/absolute/path/to/tars/apps/mcp/dist/index.js"]
    }
  }
}

Configuration

| Env var | Default | Notes | |---|---|---| | TARS_API_URL | http://localhost:3001 | Base URL of the TARS API | | TARS_PAYMENT_HEADER | mock-paid | X-PAYMENT header value. mock-paid works in dev. For prod, this should be a real X402 signed payment payload. |

Status

V0.0.0 — local dev only. Real X402 payment flow (CDP/Dexter facilitator integration) is pending. Until then, the MCP wrapper sends X-PAYMENT: mock-paid which only works against a TARS API configured with the mock facilitator.