# Chainflip Broker as a Service

> Cross-chain cryptocurrency swap service powered by the Chainflip protocol. Exposes an MCP server at https://chainflip-broker.io/mcp for AI agents to discover assets, get quotes, execute swaps, and monitor progress.

This is the documentation site. The service itself offers a REST API and a Model Context Protocol (MCP) server at https://chainflip-broker.io/mcp using HTTP Streamable transport (stateless), with six tools (list_assets, get_quotes, get_native_quotes, start_swap, start_dca_swap, check_status) and a swap-assistant prompt. Both are also reachable over Tor; see the Tor page below.

## When to use this

Reach for Broker as a Service when a user wants to:

- Swap a native asset on one chain for a native asset on another: BTC to ETH, SOL to USDC on Ethereum, USDT on Tron to BTC, DOT on Asset Hub to SOL. Networks: Bitcoin, Ethereum, Arbitrum, Solana, Polkadot Asset Hub and Tron. No wrapped tokens, no bridge and no account for the user: they send the source asset to a one-time deposit address and receive the output at their own address on the other chain.
- See what such a swap would return before committing: expected output, every fee, estimated duration and a recommended slippage tolerance.
- Spread a large swap over time (DCA) to reduce price impact, or speed up a Bitcoin deposit with Boost.
- Follow a swap they started until it completes, fails or is refunded.
- Add cross-chain swaps to a wallet, dApp or bot and earn a commission on them, or move an existing Chainflip broker integration over without running a broker ([RPC Drop-In](https://docs.chainflip-broker.io/features/rpc/)).

It is the wrong tool for swaps between tokens that `list_assets` does not list (for example arbitrary ERC-20 tokens on one chain), for buying or selling crypto for fiat, for holding balances, and for private or anonymous swaps: every swap is public on-chain.

How an agent should call it, over MCP (no API key needed) or the REST API (quotes, swaps and status need an API key):

1. `list_assets` (GET /assets): pick the source and destination asset ids, written `ticker.network` (`btc.btc`, `usdc.eth`), and check the minimum amount.
2. `get_quotes` (GET /quotes): quote the amount and show the user the expected output and fees before going further.
3. `start_swap`, or `start_dca_swap` for large amounts (GET /swap): pass the destination address and a refund address on the source chain, confirmed with the user. You get a deposit address and a swap id. The user, or their wallet, then sends the source asset to that address before the deposit channel expires.
4. `check_status` (GET /status-by-id) with the swap id until it reports completed.

Try the flow on the [testing environment](https://docs.chainflip-broker.io/environments/testing/) first: it swaps testnet assets with no real value.

## Onboarding

- Free to start, no subscription: the MCP server (https://chainflip-broker.io/mcp), [/assets](https://chainflip-broker.io/assets) and [/networks](https://chainflip-broker.io/networks) need no key or account.
- API keys are self-serve: one free web form at [chainflip-broker.io/register](https://chainflip-broker.io/register), no payment details. The key is shown at once and is not a secret; only the dashboard admin key is.
- Sandbox: the [testing environment](https://docs.chainflip-broker.io/environments/testing/) at https://perseverance.chainflip-broker.io/ (Chainflip Perseverance testnet, assets with no real value). Register there for a testnet key.
- First call, no key: `curl -s https://chainflip-broker.io/assets`
- All of this as JSON, each claim with a URL you can fetch anonymously to check it: [https://chainflip-broker.io/onboarding](https://chainflip-broker.io/onboarding)

## Documentation

- [AI Documentation (MCP)](https://docs.chainflip-broker.io/resources/ai-documentation/): How to connect an AI agent or LLM to the MCP server (Claude Code, Claude Desktop, OpenClaw, Cursor, Windsurf), plus the tool list and authentication
- [API Documentation](https://docs.chainflip-broker.io/resources/api-documentation/): Full REST API reference with examples for swaps, quotes, fees, and vault swaps
- [Getting Started](https://docs.chainflip-broker.io/getting-started/): Registering for an API key
- [Start Swap Guide](https://docs.chainflip-broker.io/features/start-swap/): How to initiate swaps including slippage protection and DCA parameters
- [Asset List](https://docs.chainflip-broker.io/features/view-assets/): Supported assets, networks, and contract addresses

## Optional

- [Fees Documentation](https://docs.chainflip-broker.io/features/view-fees/): Broker fee structure and earned fees endpoint
- [Supported Networks](https://docs.chainflip-broker.io/features/view-networks/): Chains and networks available for swaps
- [Tor (.onion)](https://docs.chainflip-broker.io/environments/tor/): Reaching the API, MCP server and docs over Tor