ChangeNOW

Working · 3.7 s

io.changenow/crypto-swapv2.1.1 Domain verified

Quote, create and track cross-chain crypto swaps. Non-custodial exchange, no account, no KYC.

Crypto & Web3

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.changenow.io/mcp

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.

check_swap_status Read-only

Follow an existing order by id: where it stands, what the deposit and payout amounts turned out to be, the transaction hashes, and a plain-language explanation of what the current stage means and what happens next. Use it after create_swap, and again whenever the user asks where their swap is.

idstring, required

Order id returned by create_swap.

sub_idstring

Sub order id, for an order the provider split in two.

Tools (7)

check_swap_status

read-only

Argument	Type	Description
id*	string	Order id returned by create_swap.
sub_id	string	Sub order id, for an order the provider split in two.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Order id returned by create_swap."
    },
    "sub_id": {
      "type": "string",
      "description": "Sub order id, for an order the provider split in two."
    }
  },
  "additionalProperties": false
}

create_swap

Create a real swap order and return the deposit address the user has to send funds to. This call moves no money by itself, but the order is real: it exists in support, it can expire, and a fixed rate is locked against it. Quote the swap first, validate the recipient address, and confirm the amount and the address with the user before calling this. If the user has not explicitly approved both, use swap_link instead and let them confirm on the page. The answer names who executes the order, and that has to be relayed: some orders are routed to a partner aggregator rather than ChangeNOW.

Argument	Type	Description
to*	string	Asset the user receives, canonical id, for example "usdt.trx".
from*	string	Asset the user sends, canonical id, for example "eth.eth".
memo	string	Memo or destination tag for the recipient address, when the asset needs one.
address*	string	Address that receives the swapped asset. Check it with validate_address first; a wrong network here loses the funds.
rate_id	string	The rate_id from quote_swap with rate_type "fixed". Required for a fixed rate order. It holds for about two minutes, so quote again right before this call if the user needed time to decide.
amount_to	string	Amount the user wants to receive. Requires rate_id from quote_swap.
promo_code	string	Promo code to apply, if the user has one.
amount_from	string	Amount the user sends. Pass this or amount_to, never both.
refund_memo	string	Memo for the refund address.
contact_email	string	Optional email for status notifications about this order.
refund_address

get_asset

Everything needed to build a swap for one asset: the canonical id, the legacy ticker used in website links, decimals, whether a memo is required and what the receiving side calls it, the address format, the token contract and the warnings to relay to the user. Minimum and maximum amounts are not here because they belong to the pair, not to the asset: get them from quote_swap.

read-only

Argument	Type	Description
asset*	string	Canonical id "usdt.trx". A legacy ticker "usdttrc20" or a page slug "tether-trc20" is also accepted.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "asset"
  ],
  "properties": {
    "asset": {
      "type": "string",
      "description": "Canonical id \"usdt.trx\". A legacy ticker \"usdttrc20\" or a page slug \"tether-trc20\" is also accepted."
    }
  },
  "additionalProperties": false
}

list_assets

Find the assets ChangeNOW can exchange and turn what the user said into a canonical asset id. Search by ticker, name or network, filter by network, by fiat or crypto, and by whether a fixed rate is possible. Always call this before quoting: the same ticker exists on several networks and only the canonical id "ticker.network" identifies one of them. When has_more is false the response is the complete answer and no paging is needed.

read-only

Argument	Type	Description
q	string	Substring search over canonical id, legacy ticker, name and network. Case insensitive. Example: "usdt", "bitcoin", "tron".
kind	string	crypto for swappable coins and tokens, fiat for currencies that can only start a purchase, all for both.
limit	integer	How many assets to return. Default 50, maximum 500.
cursor	string	Cursor from next_cursor of the previous page. Only needed when has_more is true.
network	string	Keep only assets on this network, for example "eth", "trx", "sol".
popular	boolean	Return the short curated list. Use this to answer "what can I swap" without paging.
fixed_rate	boolean	Keep only assets the catalogue flags as fixed rate capable. The flag is a hint: a pair flagged false can still get a fixed rate, so confirm with quote_swap rather than filtering a user out.

quote_swap

Ask what a swap would give, in either direction: pass amount_from to learn what the user receives, or amount_to to learn what the user must send. Returns the rate, the pair minimum and maximum, who would execute the order, and the warnings to relay. With rate_type "fixed" it also returns the rate_id that create_swap needs; that lock lasts about two minutes, so quote again right before creating the order. A fixed rate is not offered on every pair and the tool says so rather than quietly falling back to a float rate. Nothing is created and no funds move.

read-only

Argument	Type	Description
to*	string	Asset the user receives, canonical id, for example "usdt.trx".
from*	string	Asset the user sends, canonical id, for example "btc.btc".
amount_to	string	Amount the user wants to receive, as a decimal string. The answer then says how much to send.
rate_type	string	float: the rate is settled when the deposit arrives. fixed: the rate is held until valid_until, about two minutes, and returns the rate_id create_swap needs, usually at a slightly worse rate. Ask for fixed whenever the user wants a guaranteed number; if this pair cannot hold one the answer says so instead of quietly returning a float rate.
promo_code	string	Promo code to apply, if the user has one.
amount_from

swap_link

Build a changenow.io link with the pair, the amount, the recipient address and the memo already filled in, so the user checks the numbers on the real page and presses Confirm themselves. Opening the link creates nothing. This is the recommended way to finish a swap: the user sees the rate and the address with their own eyes, which no amount of care in a chat transcript can replace. Use create_swap instead only when the user has explicitly approved this exact amount and address.

read-only

Argument	Type	Description
to*	string	Asset the user receives, canonical id.
from*	string	Asset the user sends, canonical id.
memo	string	Memo or destination tag to prefill.
locale	string	Two letter locale for the page, for example "es". English needs no locale.
address	string	Recipient address to prefill. The user can still change it on the page.
amount_to	string	Amount to prefill as the amount received. Implies a fixed rate on the page.
rate_type	string	Which rate the page opens with.

validate_address

Check a recipient address, and its memo when the asset needs one, against the format the network requires, before any order exists. Call this on every address the user gives. A valid-looking address on the wrong network is the one mistake in a swap that destroys the funds with no way back, so when the address belongs to another network the answer names that network instead of just refusing. A few assets carry no address format in the catalogue; for those the answer says the address could not be checked rather than calling it valid.

read-only

Argument	Type	Description
memo	string	Memo or destination tag, when the asset needs one.
asset*	string	Asset that will be received at this address, canonical id.
address*	string	Recipient address to check.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "asset",
    "address"
  ],
  "properties": {
    "memo": {
      "type": "string",
      "description": "Memo or destination tag, when the asset needs one."
    },
    "asset": {
      "type": "string",
      "description": "Asset that will be received at this address, canonical id."
    },
    "address": {
      "type": "string",
      "description": "Recipient address to check."
    }
  },
  "additionalProperties": false
}