1inch MCP
Doc search, intent & cross-chain swaps, limit orders, portfolio, spot prices, gas & all APIs.
| Endpoint | https://api.1inch.com/mcp/protocol (streamable-http) |
|---|---|
| Registry version | 1.0.0 |
| Now | 10 tools · grade D (63) · pin ts_d18c5bb0d017191ad5ef5e6f27ff830b · protocol 2025-06-18 |
| First / last listed | 2026-11-08 01:58 UTC / 2026-11-08 01:58 UTC |
| Grade over time | 2026-11-08: D (63), 10 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: search list_examples get_example authenticate swap orderbook product_api aqua walletconnect debug
search | Search 1inch documentation and API reference params: query*, limit, page, include_body |
list_examples | List all available SDK code examples. Returns example names that can be used with get_example tool. params: none |
get_example | Get the full source code of an SDK example. Use list_examples first to see available examples. params: name*, file |
authenticate | Call this to start or confirm 1inch Business login. HTTP 401 means you are still anonymous (initialize 200 is not login). After OAuth, call again until the result is authenticated: true with organizationId. Then use swap, orderbook, product_api, or debug. Do not treat a PaymentRequired / x402 result as login. params: none |
swap | [Requires authentication] Call the authenticate tool first to start or confirm 1inch Business login (initialize 200 is still anonymous). If authenticate or this tool returns HTTP 401, complete OAuth, then retry. Swap tokens via 1inch. Supports classic (on-chain), Fusion (intent/gasless), and cross-chain swaps. Omit preferredType and the tool picks a type for you; set preferredType (classic, fusion params: src*, dst*, amount*, chain*, from*, quoteOnly, preferredType, dstChain, slippage, gasPrice, preset, signedOrder, orderHash, execute |
orderbook | [Requires authentication] Call the authenticate tool first to start or confirm 1inch Business login (initialize 200 is still anonymous). If authenticate or this tool returns HTTP 401, complete OAuth, then retry. Limit orders via the 1inch Orderbook API (v4.1).
IMPORTANT: The "action" parameter is REQUIRED. Must be one of: "build", "create", "list", "cancel".
Actions with example parameters:
1. params: action*, chain*, listMode, makerAddress, makerAsset, takerAsset, makingAmount, takingAmount, expirationSeconds, orderHash, signature, orderData, order, limit, cursor, statuses, sortBy, execute |
product_api | [Requires authentication] Call the authenticate tool first to start or confirm 1inch Business login (initialize 200 is still anonymous). If authenticate or this tool returns HTTP 401, complete OAuth, then retry. Call any 1inch product API endpoint using the authenticated user's credentials (base URL is the unified gateway, e.g. https://api.1inch.com).
Call authenticate first. Anonymous sessions g params: method, path*, query, body |
aqua | 1inch Aqua (shared-liquidity market making): position analytics plus maker position writes.
Write actions (OAuth, or WalletConnect + signed 1inch ToS (pass walletSessionToken after MCP session rotation); non-custodial — the user's wallet signs): create_position (two-phase: call once for a preview + previewRef, then again with confirmed:true), close_position (confirmed:true; closing is permanent). params: action*, address, chainId, status, limit, cursor, sort, maker, app, strategyHash, granularity, tokens, priceRange, feeBpsIn, openingPrice, previewRef, confirmed, strategy, walletSessionToken, execute |
walletconnect | Pair and use an EVM and/or Solana wallet via WalletConnect v2. **No authentication required** — available to every user (including unauthenticated/anonymous). Non-custodial: the server never holds keys and the user approves every signature/transaction in their own wallet. **Pairing proposal** is controlled per request via optional `pairingTarget` on `action: "connect"`: `eth` (default, eip155 only params: action*, method, params, chainId, solanaChainId, tx, sessionTtlDays, pairingTarget, walletSessionToken, address |
debug | [Requires authentication] Call the authenticate tool first to start or confirm 1inch Business login (initialize 200 is still anonymous). If authenticate or this tool returns HTTP 401, complete OAuth, then retry. Look up production API request logs for your 1inch Business organization to troubleshoot integration issues. Results are always scoped to your authenticated organization.
Two modes:
1) By params: requestId, startTime, endTime, logLevel, limit |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.