使用说明

Spritz MCP Server

MCP server for Spritz fiat rails — let AI agents off-ramp crypto to bank accounts.

What This Does

An MCP (Model Context Protocol) server that gives AI agents tools to interact with the Spritz API. Tools are derived from the OpenAPI spec — no hand-written schemas.

Installation

npx (recommended)

npx @spritz-finance/mcp-server

Global install

npm install -g @spritz-finance/mcp-server
spritz-mcp-server

From source

git clone https://github.com/spritz-finance/spritz-mcp-server.git
cd spritz-mcp-server
npm install && npm run build

Configuration

1. Get Your API Key

Create one at app.spritz.finance/api-keys.

2. Configure Your MCP Client

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "spritz": {
      "command": "npx",
      "args": ["@spritz-finance/mcp-server"],
      "env": {
        "SPRITZ_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

Add to your project's .mcp.json:

{
  "spritz": {
    "command": "npx",
    "args": ["@spritz-finance/mcp-server"],
    "env": {
      "SPRITZ_API_KEY": "your-api-key"
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "spritz": {
      "command": "npx",
      "args": ["@spritz-finance/mcp-server"],
      "env": {
        "SPRITZ_API_KEY": "your-api-key"
      }
    }
  }
}

Available Tools

Tool	Description
`list_bank_accounts`	List saved bank accounts
`create_bank_account`	Add a bank account (US, CA, UK, or IBAN)
`delete_bank_account`	Remove a bank account
`list_off_ramps`	List off-ramp transactions with optional filters
`create_off_ramp_quote`	Create a quote to convert crypto to fiat
`get_off_ramp_quote`	Re-fetch a quote to check status
`get_off_ramp_transaction`	Get transaction params (EVM calldata or Solana serialized tx) to sign and submit

Architecture

Tools are driven by the OpenAPI spec — not hand-written. To expose a new endpoint, add one entry to src/config.ts:

{
  name: "list_bank_accounts",
  operationId: "getV1Bank-accounts",
  description: "List all bank accounts saved as off-ramp payment destinations.",
},
// Add more entries — inputSchema, HTTP method, and path are derived from the spec.

The server reads openapi.json, finds each operationId, extracts the JSON Schema for parameters and request bodies, and registers them as MCP tools. A generic handler dispatches tool calls to the Spritz API.

openapi.json          → source of truth for request/response schemas
src/config.ts         → which operations to expose (cherry-pick)
src/spec.ts           → reads spec, builds MCP tool definitions
src/handlers.ts       → generic dispatcher (path params, query, body)
src/formatters.ts     → CSV/JSON response formatting
src/client.ts         → Spritz API HTTP client
src/index.ts          → MCP server entrypoint

Development

npm install
npm run dev          # Watch mode
npm run build        # Build
npm run inspector    # MCP inspector

Updating the OpenAPI spec

curl -s https://sandbox.spritz.finance/openapi/json > openapi.json

License

MIT