Chainflip Broker as a Service

Official6 toolsLive

by CumpsD

Native cross-chain swaps: Bitcoin, Ethereum, Solana, Polkadot, Tron, Arbitrum. Quote, swap, track.

io.chainflip-broker/crypto-swap MCP Server

A remote MCP server that enables AI agents to perform native cross-chain cryptocurrency swaps via the Chainflip decentralized exchange. It supports quoting, swapping, and swap tracking across Bitcoin, Ethereum, Solana, Polkadot, Tron, and Arbitrum, without requiring an API key to get started.

🛠️ Key Features

Native cross-chain swaps across BTC, ETH, Solana, Polkadot, Tron, Arbitrum
Quote, swap, and track swaps
No API key required to get started
Supports 6 tools

🚀 Use Cases

Generate swap quotes for cross-chain trades (human-readable or native units)
Discover supported assets including networks and live USD prices
Execute cross-chain swaps for AI agents

⚡ Developer Benefits

list_assets to retrieve tickers, networks, decimals, minimum amounts, and live USD prices
get_quotes with human-readable amounts (e.g., 1.5 BTC)
get_native_quotes with native unit amounts (e.g., satoshis)
start_swap to execute swaps

Topics

bitcoinbtcchainflipcryptodexethethereumsolsolanacryptocurrencyexchangeswapmcp-servermodel-context-protocolai-agentscross-chaindefimcptronusdc

Captured live from the server via tools/list.

get_quotes

Get swap quotes for exchanging one crypto asset to another. Returns available quotes with exchange rates, fees, and estimated output amounts. API key is optional.

Parameters4

sourceAsset	string	required	Source asset identifier (e.g., 'btc.btc', 'eth.eth', 'usdc.eth')
destinationAsset	string	required	Destination asset identifier (e.g., 'eth.eth', 'btc.btc', 'sol.sol')
amount	number	required	Amount to swap in human-readable format (e.g., 1.5 for 1.5 BTC)
apiKey	string \| null	optional	Optional partner API key.

Raw schema

{
  "type": "object",
  "properties": {
    "sourceAsset": {
      "description": "Source asset identifier (e.g., 'btc.btc', 'eth.eth', 'usdc.eth')",
      "type": "string"
    },
    "destinationAsset": {
      "description": "Destination asset identifier (e.g., 'eth.eth', 'btc.btc', 'sol.sol')",
      "type": "string"
    },
    "amount": {
      "description": "Amount to swap in human-readable format (e.g., 1.5 for 1.5 BTC)",
      "type": "number"
    },
    "apiKey": {
      "description": "Optional partner API key.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    }
  },
  "required": [
    "sourceAsset",
    "destinationAsset",
    "amount"
  ]
}

start_dca_swap

Start a DCA (Dollar Cost Averaging) cross-chain swap that splits into multiple sub-swaps over time. Returns the deposit address. API key is optional.

Parameters8

sourceAsset	string	required	Source asset identifier (e.g., 'btc.btc', 'eth.eth', 'usdc.eth')
destinationAsset	string	required	Destination asset identifier (e.g., 'eth.eth', 'btc.btc', 'sol.sol')
destinationAddress	string	required	Destination address on the target chain
refundAddress	string	required	Refund address on the source chain, used if minimum price cannot be met
numberOfChunks	integer	required	Number of sub-swaps for DCA (Dollar Cost Averaging). Must be >= 1.
chunkIntervalBlocks	integer \| null	optional	Optional delay between DCA sub-swaps in state-chain blocks (1 block = 6 seconds). Defaults to 2 blocks (12 seconds).
minimumPrice	number \| null	optional	Optional minimum accepted price as a destination-per-source ratio (e.g., for a btc.btc to eth.eth swap, 28.5 means 1 BTC gets at least 28.5 ETH). When omitted, automatically calculated from current pool prices with 2% slippage tolerance. Set to 0 to accept any price.
apiKey	string \| null	optional	Optional partner API key.

Raw schema

{
  "type": "object",
  "properties": {
    "sourceAsset": {
      "description": "Source asset identifier (e.g., 'btc.btc', 'eth.eth', 'usdc.eth')",
      "type": "string"
    },
    "destinationAsset": {
      "description": "Destination asset identifier (e.g., 'eth.eth', 'btc.btc', 'sol.sol')",
      "type": "string"
    },
    "destinationAddress": {
      "description": "Destination address on the target chain",
      "type": "string"
    },
    "refundAddress": {
      "description": "Refund address on the source chain, used if minimum price cannot be met",
      "type": "string"
    },
    "numberOfChunks": {
      "description": "Number of sub-swaps for DCA (Dollar Cost Averaging). Must be >= 1.",
      "type": "integer"
    },
    "chunkIntervalBlocks": {
      "description": "Optional delay between DCA sub-swaps in state-chain blocks (1 block = 6 seconds). Defaults to 2 blocks (12 seconds).",
      "type": [
        "integer",
        "null"
      ],
      "default": null
    },
    "minimumPrice": {
      "description": "Optional minimum accepted price as a destination-per-source ratio (e.g., for a btc.btc to eth.eth swap, 28.5 means 1 BTC gets at least 28.5 ETH). When omitted, automatically calculated from current pool prices with 2% slippage tolerance. Set to 0 to accept any price.",
      "type": [
        "number",
        "null"
      ],
      "default": null
    },
    "apiKey": {
      "description": "Optional partner API key.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    }
  },
  "required": [
    "sourceAsset",
    "destinationAsset",
    "destinationAddress",
    "refundAddress",
    "numberOfChunks"
  ]
}

check_status

Check the status of a swap by its ID. Returns the current swap state including deposit detection, swap progress, and egress information.

Parameters1

swapId

integer

required

The swap ID returned by start_swap or start_dca_swap

Raw schema

{
  "type": "object",
  "properties": {
    "swapId": {
      "description": "The swap ID returned by start_swap or start_dca_swap",
      "type": "integer"
    }
  },
  "required": [
    "swapId"
  ]
}

list_assets

List all available swap assets and their details including ticker, network, direction, decimals, minimum amounts, and current USD prices.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

start_swap

Start a cross-chain swap. Returns the deposit address where you should send your source asset. API key is optional.

Parameters6

sourceAsset	string	required	Source asset identifier (e.g., 'btc.btc', 'eth.eth', 'usdc.eth')
destinationAsset	string	required	Destination asset identifier (e.g., 'eth.eth', 'btc.btc', 'sol.sol')
destinationAddress	string	required	Destination address on the target chain
refundAddress	string	required	Refund address on the source chain, used if minimum price cannot be met
minimumPrice	number \| null	optional	Optional minimum accepted price as a destination-per-source ratio (e.g., for a btc.btc to eth.eth swap, 28.5 means 1 BTC gets at least 28.5 ETH). When omitted, automatically calculated from current pool prices with 2% slippage tolerance. Set to 0 to accept any price.
apiKey	string \| null	optional	Optional partner API key.

Raw schema

{
  "type": "object",
  "properties": {
    "sourceAsset": {
      "description": "Source asset identifier (e.g., 'btc.btc', 'eth.eth', 'usdc.eth')",
      "type": "string"
    },
    "destinationAsset": {
      "description": "Destination asset identifier (e.g., 'eth.eth', 'btc.btc', 'sol.sol')",
      "type": "string"
    },
    "destinationAddress": {
      "description": "Destination address on the target chain",
      "type": "string"
    },
    "refundAddress": {
      "description": "Refund address on the source chain, used if minimum price cannot be met",
      "type": "string"
    },
    "minimumPrice": {
      "description": "Optional minimum accepted price as a destination-per-source ratio (e.g., for a btc.btc to eth.eth swap, 28.5 means 1 BTC gets at least 28.5 ETH). When omitted, automatically calculated from current pool prices with 2% slippage tolerance. Set to 0 to accept any price.",
      "type": [
        "number",
        "null"
      ],
      "default": null
    },
    "apiKey": {
      "description": "Optional partner API key.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    }
  },
  "required": [
    "sourceAsset",
    "destinationAsset",
    "destinationAddress",
    "refundAddress"
  ]
}

get_native_quotes

Get swap quotes for exchanging one crypto asset to another using native (smallest unit) amounts. Returns available quotes with exchange rates, fees, and estimated output amounts. Use this when you have amounts in native units (e.g., satoshis for BTC, wei for ETH). API key is optional.

Parameters4

sourceAsset	string	required	Source asset identifier (e.g., 'btc.btc', 'eth.eth', 'usdc.eth')
destinationAsset	string	required	Destination asset identifier (e.g., 'eth.eth', 'btc.btc', 'sol.sol')
amount	string	required	Amount to swap in native units (e.g., '100000000' for 1 BTC in satoshis)
apiKey	string \| null	optional	Optional partner API key.

Raw schema

{
  "type": "object",
  "properties": {
    "sourceAsset": {
      "description": "Source asset identifier (e.g., 'btc.btc', 'eth.eth', 'usdc.eth')",
      "type": "string"
    },
    "destinationAsset": {
      "description": "Destination asset identifier (e.g., 'eth.eth', 'btc.btc', 'sol.sol')",
      "type": "string"
    },
    "amount": {
      "description": "Amount to swap in native units (e.g., '100000000' for 1 BTC in satoshis)",
      "type": "string"
    },
    "apiKey": {
      "description": "Optional partner API key.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    }
  },
  "required": [
    "sourceAsset",
    "destinationAsset",
    "amount"
  ]
}

README.md2 KBView on GitHub

Chainflip Broker as a Service

A remote MCP server that enables AI agents to perform cross-chain cryptocurrency swaps through the Chainflip decentralized exchange. No API key required to get started.

Tools

Tool	Description
`list_assets`	Discover all available assets with tickers, networks, decimals, minimum amounts, and live USD prices
`get_quotes`	Get swap quotes using human-readable amounts (e.g., 1.5 BTC)
`get_native_quotes`	Get swap quotes using native unit amounts (e.g., 150000000 satoshis)
`start_swap`	Execute a cross-chain swap and receive a deposit address
`start_dca_swap`	Execute a DCA swap that splits into multiple sub-swaps to reduce price impact on large trades
`check_status`	Track swap progress through its stages: Waiting, Receiving, Swapping, Sending, Sent, Completed

Prompts

Prompt	Description
`swap-assistant`	Guided workflow that walks through asset discovery, quoting, swap execution, and status monitoring

Supported Assets

Assets are identified as ticker.network, for example btc.btc, eth.eth, usdc.eth, sol.sol, or usdt.tron. Call list_assets to see the full list of supported assets and their current prices.

Configuration

Connect to the remote MCP server at:

code

https://chainflip-broker.io/mcp

Transport: Streamable HTTP

No authentication is required. An optional API key can be provided for partner attribution.

Documentation

For detailed human-readable documentation, visit docs.chainflip-broker.io/resources/ai-documentation.

Agent Skill

For agent frameworks that consume SKILL.md plugins (OpenClaw, Nous Hermes, Claude Code), this repo ships a ready-to-use skill at skills/chainflip-swap/SKILL.md. It wraps the tools above into a guided swap workflow with natural-language triggers. The skill manifest is skills/index.json.

The skill is published on ClawHub. Install it in OpenClaw with:

bash

openclaw skills install @baas/chainflip

Usage Example

Call list_assets to see available assets
Call get_quotes with source asset, destination asset, and amount to preview the swap
Call start_swap with the destination and refund addresses to get a deposit address
Send funds to the deposit address
Call check_status with the returned swap ID to monitor progress

Install

Tools (6)

get_quotesstart_dca_swapcheck_statuslist_assetsstart_swapget_native_quotes

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://chainflip-broker.io/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "crypto-swap": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://chainflip-broker.io/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.chainflip-broker/crypto-swap MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

Topics

get_quotes

start_dca_swap

check_status

list_assets

start_swap

get_native_quotes

Chainflip Broker as a Service

Tools

Prompts

Supported Assets

Configuration

Documentation

Agent Skill

Usage Example

Install

Remote endpoint

Related servers