Chainflip Broker as a Service

Overview

Broker as a Service exposes a Model Context Protocol (MCP) server, allowing AI agents and coding assistants to discover assets, get quotes, execute cross-chain swaps, and monitor swap progress — all through natural language.

The MCP server uses HTTP Streamable transport in stateless mode. No API key is required to get started, though you can optionally provide one for partner-level tracking.

MCP Endpoints

Environment	URL
Production	https://chainflip-broker.io/mcp
Testing	https://perseverance.chainflip-broker.io/mcp

Available Tools

The MCP server exposes the following tools:

Tool	Description
list_assets	List all available swap assets with ticker, network, decimals, minimum amounts, and USD prices
get_quotes	Get swap quotes using human-readable amounts (e.g. 1.5 for 1.5 BTC)
get_native_quotes	Get swap quotes using native unit amounts (e.g. 150000000 satoshis)
start_swap	Initiate a simple cross-chain swap
start_dca_swap	Initiate a Dollar Cost Averaging swap, split across multiple sub-swaps
check_status	Check the status of a swap by its swap ID

A swap-assistant prompt is also available, providing AI agents with detailed guidance on the complete swap workflow — from asset discovery through quoting, execution, and monitoring.

Connecting Your AI Tool

Claude Code

Add the MCP server to your project by running:

claude mcp add chainflip-baas --transport http https://chainflip-broker.io/mcp

Or add it to your .mcp.json file:

{
  "mcpServers": {
    "chainflip-baas": {
      "type": "url",
      "url": "https://chainflip-broker.io/mcp"
    }
  }
}

Claude Desktop

Open Settings > Developer > Edit Config and add the server to your claude_desktop_config.json:

{
  "mcpServers": {
    "chainflip-baas": {
      "type": "url",
      "url": "https://chainflip-broker.io/mcp"
    }
  }
}

Restart Claude Desktop to pick up the changes.

OpenClaw

The quickest option is to install our published ClawHub skill, which connects this MCP server and adds guided, natural-language swap workflows:

openclaw skills install @baas/chainflip

Or add the MCP server directly. Navigate to Settings > MCP Servers > Add Server and configure:

• Name: chainflip-baas
• Type: URL
• URL: https://chainflip-broker.io/mcp

Cursor

Open Cursor Settings > MCP and click Add new MCP server. Set the type to url and enter:

https://chainflip-broker.io/mcp

Alternatively, add to your project's .cursor/mcp.json:

{
  "mcpServers": {
    "chainflip-baas": {
      "type": "url",
      "url": "https://chainflip-broker.io/mcp"
    }
  }
}

Windsurf

Open Windsurf Settings > MCP and click Add Server. Use the URL transport with:

https://chainflip-broker.io/mcp

Or add to your ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "chainflip-baas": {
      "type": "url",
      "url": "https://chainflip-broker.io/mcp"
    }
  }
}

Other MCP Clients

Any MCP-compatible client can connect using the HTTP Streamable transport. Point it at the endpoint URL:

https://chainflip-broker.io/mcp

For the testing environment, use https://perseverance.chainflip-broker.io/mcp instead.

Authentication

An API key is optional. All tools are accessible without one, making it easy to explore and test.

To use your API key, pass it as the apiKey parameter on tools that support it (get_quotes, get_native_quotes, start_swap, start_dca_swap). Register at chainflip-broker.io to get one.

Support

Feel free to reach out to us in case you need help.