Skip to main content
Glama
Rails by Spritz API

Rails by Spritz API

Official

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.

Related MCP server: satsrail-mcp

Installation

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that enables AI agents to accept Bitcoin Lightning payments. It allows agents to create orders, generate invoices, check payment status, and manage the full SatsRail merchant API through natural language.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Printr, a cross-chain token launchpad. Lets AI agents launch, stake, and graduate tokens across EVM chains and Solana without requiring an API key.
      4
      Apache 2.0
    • F
      license
      Not graded
      quality
      C
      maintenance
      MCP server that provides AI agents a prepaid fiat wallet, enabling them to pay metered APIs per call on the peage rail with adjustable spending caps.
      -