Swap native BTC to and from tokens on EVM chains and Tron through BOB Gateway
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer <integrator API key>; optional, makes the gateway apply that integrator's pricing and fees
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Create an order from a quote. Returns the order id plus what the user must sign: a deposit address / PSBT for onramps, or the EVM or Tron transaction otherwise.
The quote object exactly as returned by `get_quote`, e.g. {"onramp": {...}}; not a string
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http gateway https://mcp.gobob.xyz/mcp
Headers
Authorization (optional, not in the config above): Bearer <integrator API key>; optional, makes the gateway apply that integrator's pricing and feesCreate an order from a quote. Returns the order id plus what the user must sign: a deposit address / PSBT for onramps, or the EVM or Tron transaction otherwise.
| Argument | Type | Description |
|---|---|---|
| quote* | object | The quote object exactly as returned by `get_quote`, e.g. {"onramp": {...}}; not a string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"quote"
],
"properties": {
"quote": {
"type": "object",
"description": "The quote object exactly as returned by `get_quote`, e.g. {\"onramp\": {...}}; not a string",
"additionalProperties": true
}
}
}Maximum BTC (sats) an address can send to an onramp after estimated network fees.
| Argument | Type | Description |
|---|---|---|
| address* | string | Bitcoin address |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "Bitcoin address"
}
}
}Get an order's status and details.
| Argument | Type | Description |
|---|---|---|
| id* | string | Order id, source Bitcoin txid, or source EVM tx hash |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Order id, source Bitcoin txid, or source EVM tx hash"
}
}
}List orders for one or more user addresses, paginated.
| Argument | Type | Description |
|---|---|---|
| limit | integer | null | Page size |
| cursor | string | null | Cursor from a previous response's `nextCursor` |
| user_addresses* | array | User addresses (up to 20), each encoded for its own chain |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"user_addresses"
],
"properties": {
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Page size"
},
"cursor": {
"type": [
"string",
"null"
],
"description": "Cursor from a previous response's `nextCursor`"
},
"user_addresses": {
"type": "array",
"items": {
"type": "string"
},
"description": "User addresses (up to 20), each encoded for its own chain"
}
}
}Get a quote for a swap (onramp quotes are signed by the API). Pass the returned object unchanged to `create_order`.
| Argument | Type | Description |
|---|---|---|
| amount* | string | Amount to swap as an integer string in the source token's smallest unit |
| sender | string | null | Address sending the funds, encoded for the source chain. On onramps it lets create-order return a funded PSBT, which may spend the address's ordinals, inscriptions or runes as plain sats: omit it for an address holding any. |
| slippage | integer | null | Slippage tolerance in basis points (max 1000). Omit to let the gateway pick one per route. |
| dst_chain* | string | Destination chain |
| dst_token* | string | Destination token address; "0x0000000000000000000000000000000000000000" for BTC/native |
| recipient* | string | Address receiving the funds, encoded for the destination chain |
| src_chain* | string | Source chain, e.g. "bitcoin", "ethereum", "base", "bob", "tron" |
List supported swap routes (source/destination chain and token pairs).
| Argument | Type | Description |
|---|---|---|
| dst_chain | string | null | Only routes to this chain, e.g. "ethereum" |
| src_chain | string | null | Only routes from this chain, e.g. "bitcoin" |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"dst_chain": {
"type": [
"string",
"null"
],
"description": "Only routes to this chain, e.g. \"ethereum\""
},
"src_chain": {
"type": [
"string",
"null"
],
"description": "Only routes from this chain, e.g. \"bitcoin\""
}
}
}Get a quote and create an order from it in one call, returning both as `quote` and `order`. Takes the `get_quote` arguments, with `refund_address` required. Creating an order screens its addresses, so use this only once the user wants to swap, and `get_quote` to check a price.
| Argument | Type | Description |
|---|---|---|
| amount* | string | Amount to swap as an integer string in the source token's smallest unit |
| sender | string | null | Address sending the funds, encoded for the source chain. On onramps it lets create-order return a funded PSBT, which may spend the address's ordinals, inscriptions or runes as plain sats: omit it for an address holding any. |
| slippage | integer | null | Slippage tolerance in basis points (max 1000). Omit to let the gateway pick one per route. |
| dst_chain* | string | Destination chain |
| dst_token* | string | Destination token address; "0x0000000000000000000000000000000000000000" for BTC/native |
| recipient* | string | Address receiving the funds, encoded for the destination chain |
| src_chain* | string | Source chain, e.g. "bitcoin", "ethereum", "base", "bob", "tron" |
Broadcast an already-signed onramp Bitcoin transaction through the gateway. Optional: deposits are detected on-chain without it. The broadcast cannot be undone.
| Argument | Type | Description |
|---|---|---|
| order_id* | string | Onramp order id returned by `create_order` |
| bitcoin_tx_hex* | string | Hex-encoded, fully signed Bitcoin transaction paying the order's deposit address |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"bitcoin_tx_hex"
],
"properties": {
"order_id": {
"type": "string",
"description": "Onramp order id returned by `create_order`"
},
"bitcoin_tx_hex": {
"type": "string",
"description": "Hex-encoded, fully signed Bitcoin transaction paying the order's deposit address"
}
}
}Wait for an order's status to leave `inProgress`, reading it every 15 seconds for up to about 45. Returns the order as `get_order` does, as soon as its status changes or once the wait is over; call again while it is still `inProgress`. Under heavy load it may return after a single read. Reports progress when the client asks for it.
| Argument | Type | Description |
|---|---|---|
| id* | string | Order id, source Bitcoin txid, or source EVM tx hash |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Order id, source Bitcoin txid, or source EVM tx hash"
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 18, 2026.
| src_token* | string | Source token address; "0x0000000000000000000000000000000000000000" for BTC/native |
| affiliates | string | null | Affiliate fees as comma-separated `<address>:<bps>` pairs, e.g. "0xabc...:50". Addresses are EVM, except on a token swap to Tron, where a Tron address is also accepted. |
| refund_address | string | null | Refund address on the source chain. Optional here, required by create-order. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"src_chain",
"dst_chain",
"src_token",
"dst_token",
"amount",
"recipient"
],
"properties": {
"amount": {
"type": "string",
"description": "Amount to swap as an integer string in the source token's smallest unit"
},
"sender": {
"type": [
"string",
"null"
],
"description": "Address sending the funds, encoded for the source chain. On onramps it lets create-order\nreturn a funded PSBT, which may spend the address's ordinals, inscriptions or runes as\nplain sats: omit it for an address holding any."
},
"slippage": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Slippage tolerance in basis points (max 1000). Omit to let the gateway pick one per route."
},
"dst_chain": {
"type": "string",
"description": "Destination chain"
},
"dst_token": {
"type": "string",
"description": "Destination token address; \"0x0000000000000000000000000000000000000000\" for BTC/native"
},
"recipient": {
"type": "string",
"description": "Address receiving the funds, encoded for the destination chain"
},
"src_chain": {
"type": "string",
"description": "Source chain, e.g. \"bitcoin\", \"ethereum\", \"base\", \"bob\", \"tron\""
},
"src_token": {
"type": "string",
"description": "Source token address; \"0x0000000000000000000000000000000000000000\" for BTC/native"
},
"affiliates": {
"type": [
"string",
"null"
],
"description": "Affiliate fees as comma-separated `<address>:<bps>` pairs, e.g. \"0xabc...:50\". Addresses\nare EVM, except on a token swap to Tron, where a Tron address is also accepted."
},
"refund_address": {
"type": [
"string",
"null"
],
"description": "Refund address on the source chain. Optional here, required by create-order."
}
}
}| src_token* | string | Source token address; "0x0000000000000000000000000000000000000000" for BTC/native |
| affiliates | string | null | Affiliate fees as comma-separated `<address>:<bps>` pairs, e.g. "0xabc...:50". Addresses are EVM, except on a token swap to Tron, where a Tron address is also accepted. |
| refund_address* | string | Refund address on the source chain |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"src_chain",
"dst_chain",
"src_token",
"dst_token",
"amount",
"recipient",
"refund_address"
],
"properties": {
"amount": {
"type": "string",
"description": "Amount to swap as an integer string in the source token's smallest unit"
},
"sender": {
"type": [
"string",
"null"
],
"description": "Address sending the funds, encoded for the source chain. On onramps it lets create-order\nreturn a funded PSBT, which may spend the address's ordinals, inscriptions or runes as\nplain sats: omit it for an address holding any."
},
"slippage": {
"type": [
"integer",
"null"
],
"format": "uint32",
"minimum": 0,
"description": "Slippage tolerance in basis points (max 1000). Omit to let the gateway pick one per route."
},
"dst_chain": {
"type": "string",
"description": "Destination chain"
},
"dst_token": {
"type": "string",
"description": "Destination token address; \"0x0000000000000000000000000000000000000000\" for BTC/native"
},
"recipient": {
"type": "string",
"description": "Address receiving the funds, encoded for the destination chain"
},
"src_chain": {
"type": "string",
"description": "Source chain, e.g. \"bitcoin\", \"ethereum\", \"base\", \"bob\", \"tron\""
},
"src_token": {
"type": "string",
"description": "Source token address; \"0x0000000000000000000000000000000000000000\" for BTC/native"
},
"affiliates": {
"type": [
"string",
"null"
],
"description": "Affiliate fees as comma-separated `<address>:<bps>` pairs, e.g. \"0xabc...:50\". Addresses\nare EVM, except on a token swap to Tron, where a Tron address is also accepted."
},
"refund_address": {
"type": "string",
"description": "Refund address on the source chain"
}
}
}