1inch.com

1inch Business MCP Server — provides SDK examples and documentation search. ## SDK Examples For code implementations, use list_examples + get_example: - Intent/Fusion swaps: "@1inch-examples/intent-swap" (EVM: src/evm/, Solana: src/solana/) - Limit orders: "@1inch-examples/limit-order" - Cross-chain swaps: "@1inch-examples/cross-chain-swap" ## Documentation Search Use search for API endpoint details not covered by examples. Always prefer example code over documentation snippets. ## Authentication Initialize HTTP 200 is **not** login — that is the mcp-free / anonymous identity. Public tools work without a real org. Paid tools need a real organization (OAuth or API key), not mcp-free. All tools are always listed so you know they exist. Some require OAuth to run: - **Public (no auth):** search, list_examples, get_example, aqua. - **Public (no auth), when enabled:** walletconnect — non-custodial wallet pairing/signing available to every user, including unauthenticated. - **Requires OAuth:** authenticate, swap, orderbook, product_api (and debug when enabled). **Before** paid tools, call `authenticate`. If the host returns HTTP 401, complete OAuth (`mcp_auth` / connect this server), then call `authenticate` again until it returns `{ authenticated: true, ... }`. Do not treat a PaymentRequired / x402 tool result as login. Do not skip `authenticate` because initialize succeeded. ## Swap Workflow Use the "swap" tool to execute token swaps (requires authentication). Two approaches: - **Shortcut**: Call swap directly (omit quoteOnly). Omit preferredType to let the tool pick a type, or set preferredType (classic, fusion, crosschain) to choose explicitly. Set dstChain for cross-chain. - **Full flow**: Call swap with quoteOnly=true to compare quotes and receive a recommended type, then execute with the chosen preferredType. The response includes a nextSteps array — follow those instructions to complete the swap: - Classic: sign the tx with eth_sendTransaction, wait for receipt. If an approve step is returned, sign that first, then call swap again. - Fusion/cross-chain: sign the typedData with eth_signTypedData_v4, then call swap again with signedOrder and orderHash to submit. ## Limit orders (Orderbook) Use the "orderbook" tool (requires authentication) for limit orders. Recommended flow: 1. **build**: Provide maker/taker assets, amounts, maker address → server builds order, returns EIP-712 typedData to sign. 2. **create**: After signing typedData, submit with orderHash + signature + orderData. Also supports list (query orders) and cancel (on-chain cancellation guidance). No SDK needed on the client. ## Product API Use the "product_api" tool to call any 1inch product API endpoint (Portfolio, Orderbook, Spot Price, Token, Gas Price, etc.) with the user's OAuth credentials. Requires authentication — call authenticate first; initialize 200 is still anonymous. ## Aqua strategies Use the "aqua" tool for 1inch Aqua strategies (shared-liquidity market making). Analytics actions are read-only and need no OAuth. Read the resource file://1inch-mcp/guides/aqua-workflow for examples and maker/taker flows. ## WalletConnect Use the "walletconnect" tool to pair with the user's EVM and/or Solana wallet for signatures and transactions. No authentication is required — it is non-custodial and the user approves every request in their own wallet. Unauthenticated callers should persist the `walletSessionToken` returned by `connect` and pass it back on later calls to keep the session across MCP session rotation. For swap and orderbook, optional execute=true can submit or sign in one step when a WalletConnect session is active.