Cleave for Agents: token swaps, cross-chain swaps and gas top-ups
v1.0.1Swap, bridge and get gas on 6 EVM chains. Each plan states its outcome before you sign. No API key.
Endpoint health
online- Last checked
- 11/20/2026, 8:17:49 AM
- Latency
- 220 ms
- Consecutive failures
- 0
- Endpoint reachable: pass
- Protocol valid: pass
- MCP handshake valid: pass
Machine-readable profile
mcp-server · schema v1 · callable
mcp-server:fi.cleave%2Fswap
Connect this server
Generated config contains no credentials. Keep any required secrets in your client's local environment.
{
"mcpServers": {
"fi.cleave/swap": {
"url": "https://api.cleave.fi/mcp"
}
}
}Indexed tools
Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.
4 shown · authentication unknown
Find a token's contract address
cleave_find_token
Finds a token by symbol or contract address on Ethereum, Arbitrum, Base, BNB Chain, Polygon or Optimism and returns its address, decimals and whether it is on Cleave's token list, with a flag when it resembles a listed token. A symbol shared by several listed tokens returns up to ten candidates by address instead of picking one. An unlisted token is found only by its address and comes back flagged, without a name or symbol. It fits before cleave_plan_swap when the user names a token by symbol and the address is unknown.
Schema valid · SHA-256 04dadf6ccf6c…
View input schema
{ "type": "object", "properties": { "chainId": { "type": "integer", "enum": [ 1, 10, 56, 137, 8453, 42161 ], "description": "The chain to search on" }, "query": { "type": "string", "minLength": 1, "maxLength": 64, "description": "A symbol or a contract address" } }, "required": [ "chainId", "query" ], "additionalProperties": false }Order native gas with USDC
cleave_get_gas
Offers orders for native gas (ETH, BNB or POL) on Ethereum, Arbitrum, Base, BNB Chain, Polygon or Optimism for a wallet that holds USDC on Ethereum, Arbitrum, Base, Optimism or Polygon but has no gas to send transactions. Called with the paying chain, the receiving chain, the recipient, a USDC amount and the paying wallet (without it the offer has nothing to sign), it returns an offer: the minimum native amount, the deadline, the order and one USDC authorization for the wallet to sign; signing costs no gas. If your wallet pays for a person, ask them for the recipient; if theirs pays, it can be the recipient. Use your own only for your own gas. An offer needs 0.8 to 50 USDC (at least 5 USDC when Ethereum is the paying or receiving chain; the fee is included in the price), a recipient that accepts the native coin and is not a token contract, and, for a cross-chain order, the paying wallet or a refundTo on the paying chain; otherwise, or while the route is paused, no offer is returned and the answer says why. Called again with the offer, the signature and the same wallet, it passes the signed order to Cleave's relayer, which may submit it to a contract made for that one order, and returns a requestId for cleave_track_swap. An authorization Cleave accepts is set to end before the order deadline. Cleave does not promise to submit it before it expires, and expiry of an unused authorization is not a promise about funds already paid. No outcome or time is guaranteed, and a settled payment is not delivery. On one chain the order is written to swap the USDC toward the native coin for the recipient. From another chain it is written to bridge the USDC and swap on arrival. USDC on arrival is one possible ending if that swap fails, and it may not happen. If a bridge transfer is not filled, the USDC can come back to the order address on the paying chain, which can take hours or longer, or may not come back. Until someone sends it to the refund address, cleave_track_swap can show it as refund_pending. The relayer may not send it. When the wallet already holds some gas, cleave_plan_swap plans a swap to the native coin.
Connections
streamable-http
https://api.cleave.fi/mcp