MCP Server

The Strails MCP server exposes the full Strails API as tools that AI agents can call directly. It speaks the Model Context Protocol over streamable HTTP, so any MCP-compatible client (Claude Code, your own agent framework, or any other MCP host) can integrate with Strails without writing API client code. The server covers the entire surface of this documentation: user onboarding and KYC, virtual accounts, customer and corporate onramps and offramps, wallets and balances, swaps, the FX orderbook and trading engine, fees, transaction history and account management.

Need credentials? Contact support@strails.io to receive your API key. See Authentication for details.

Endpoint

https://mcp.strails.io/mcp

Authentication uses your Strails API key as the bearer token. The server validates it against the Strails API and makes every upstream call with your key, so one server safely serves many fintechs.

Connect

Claude Code
Other MCP clients
Self-host

claude mcp add --transport http strails https://mcp.strails.io/mcp \
  --header "Authorization: Bearer YOUR_STRAILS_API_KEY"

Run claude mcp list to verify the connection, then ask for something like “list my users” or “show the CNGN-USDC orderbook” to see the tools in action.

Any client that supports streamable HTTP with custom headers can connect:

{
  "mcpServers": {
    "strails": {
      "type": "http",
      "url": "https://mcp.strails.io/mcp",
      "headers": { "Authorization": "Bearer YOUR_STRAILS_API_KEY" }
    }
  }
}

The server is open source. Run your own instance with uv or Docker:

uv sync --locked
STRAILS_API_KEY=YOUR_STRAILS_API_KEY uv run strails-mcp --no-auth
# or: docker build -t strails-mcp . && docker run -p 8000:8000 strails-mcp

The MCP endpoint is then at http://localhost:8000/mcp. STRAILS_ENV selects the upstream environment (sandbox, staging, production).

How agents work with the tools

Confirm-gated mutations

Every tool that moves money or changes configuration first returns a preview with amounts, fees and warnings. Nothing executes until the tool is called again with confirm=true.

Correct amounts, always

Pass human-readable amounts. The server converts to naira, kobo or 6-decimal smallest units per endpoint, and orderbook responses include human-readable conversions next to raw values.

Async operations

Onramps, offramps, swaps and FX trades return a requestId. One tool, strails_get_operation_status, polls the right status endpoint for any of them.

Actionable errors

Upstream failures come back with the Strails response_code and a corrective hint the agent can act on, such as a rate-limit retry delay.

Tool overview

The server exposes 62 tools. Highlights by area:

Area	What agents can do
Users and KYC	Onboard users with BVN, track onboarding, manage user status
On/off-ramps	Customer onramps, customer and corporate offramps, withdrawals, transfers
Bank accounts	List banks, verify and register NUBAN payout accounts
Wallets	Balances, user wallets, external-wallet whitelisting, virtual accounts
Swaps	Token swaps on user or onramp wallets
FX orderbook	Quotes, trades, market and limit orders, book stats, auto-signing, MPC vault registration
Fees	Fee configuration, previews, accumulated fees, withdrawals
History	Deposits, payouts and combined transaction views
Management	Webhooks, IP allowlist, API keys, encryption keys

Resources and prompts

Agents can also read these resources and follow these workflow prompts:

strails://config/status: server environment and auth mode
strails://banks: Nigerian banks with NIBSS codes
strails://orderbook/{pair}: live orderbook snapshot for CNGN-USDC or CNGN-USDT
onboard_and_fund_user: step-by-step runbook from BVN onboarding to a funded wallet
corporate_offramp_runbook: runbook from bank account registration to payout

Notes and limits

The server does not receive webhooks. Configure your own endpoint with strails_set_webhook and verify signatures as described in HMAC signatures.
X25519 encrypted-response mode is not supported by the MCP server. Do not register a public key for the API key you use with it. See Encryption for what that mode does.
Production enforces the IP allowlist. Add the server’s egress IP with strails_manage_ip_allowlist before first use.

Get Started

Wallets

Guides

Tools

Endpoint

Connect

How agents work with the tools

Confirm-gated mutations

Correct amounts, always

Async operations

Actionable errors

Tool overview

Resources and prompts

Notes and limits

​Endpoint

​Connect

​How agents work with the tools

Confirm-gated mutations

Correct amounts, always

Async operations

Actionable errors

​Tool overview

​Resources and prompts

​Notes and limits

Endpoint

Connect

How agents work with the tools

Tool overview

Resources and prompts

Notes and limits