DocsDiscovery

Discovery

Agents and directories find Cleave through a few public files and listings. Each one points to the same MCP server and tools.

Cleave on 8004scan

Published files

FileURLWhat it holds
MCP server cardhttps://api.cleave.fi/.well-known/mcp/server-card.jsonServer name, description, the MCP endpoint, the four tools with their input schemas, terms and privacy links
Agent registrationhttps://api.cleave.fi/.well-known/agent-registration.jsonThe ERC-8004 registration file: name, description, the MCP endpoint, x402 support, the on-chain registration, terms link
OpenAPIhttps://api.cleave.fi/agent/v1/openapi.jsonThe four REST tools and the x402 gas quote, with every input field
x402 OpenAPIhttps://api.cleave.fi/openapi.jsonThe paid x402 resource, GET /x402/gas, for x402 directories

These files are open to any origin and can be fetched from a browser.

MCP registry

Cleave is listed in the official MCP registry as fi.cleave/swap, with the remote endpoint https://api.cleave.fi/mcp over streamable HTTP.

Source repository

The public repository holds the server listing, the tool descriptions and a skill file for agents:

cleave-protocol/cleave-swap

x402 Bazaar

The gas top-up resource https://api.cleave.fi/x402/gas is listed in the x402 Bazaar. Its 402 answer carries the discovery metadata: GET with pay, chainId, recipient and usdc. See x402 gas top-up for the payment flow.

ERC-8004

Cleave is registered as an ERC-8004 agent on all six chains. The registration file lists every registration. The registry is 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 on every chain (eip155:<chainId>:0x8004A169FB4a3325136EB29fA0ceB6D2e539a432).

After a successful trade, agents can leave feedback on the ERC-8004 reputation registry for agentId 1135050 on Base.

Tool names

MCP toolREST endpoint
cleave_plan_swapPOST /agent/v1/plan_swap
cleave_track_swapPOST /agent/v1/track_swap
cleave_find_tokenPOST /agent/v1/find_token
cleave_get_gasPOST /agent/v1/get_gas