1inch MCP

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "number",
      "minimum": 1,
      "description": "Page number for pagination (default 1)"
    },
    "limit": {
      "type": "number",
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum results per collection (default 10)"
    },
    "query": {
      "type": "string",
      "description": "Search query string"
    },
    "include_body": {
      "type": "boolean",
      "description": "Include full document body in results (default true). Set to false for smaller responses."
    }
  }
}

{
  "title": "Search documentation",
  "readOnlyHint": true
}

{
  "type": "object",
  "properties": {}
}

{
  "title": "List SDK examples",
  "readOnlyHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "file": {
      "type": "string",
      "description": "Optional: specific file path to retrieve (e.g., 'src/evm/swap-native.ts'). If omitted, returns all files."
    },
    "name": {
      "type": "string",
      "description": "Example name (e.g., '@1inch-examples/intent-swap', '@1inch-examples/limit-order')"
    }
  }
}

{
  "title": "Get SDK example source",
  "readOnlyHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

{
  "title": "Authenticate (OAuth)",
  "readOnlyHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "src",
    "dst",
    "amount",
    "chain",
    "from"
  ],
  "properties": {
    "dst": {
      "type": "string",
      "description": "Destination token address or symbol (e.g. ETH, 0x...)"
    },
    "src": {
      "type": "string",
      "description": "Source token address or symbol (e.g. USDC, 0x...)"
    },
    "from": {
      "type": "string",
      "description": "Wallet address executing the swap"
    },
    "chain": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Chain ID (e.g. 1 for Ethereum, 8453 for Base)",
      "exclusiveMinimum": 0
    },
    "amount": {
      "type": "string",
      "pattern": "^\\d+$",
      "minLength": 1,
      "description": "Amount in wei/smallest unit. Pass large amounts as a string to avoid precision loss."
    },
    "preset": {
      "enum": [
        "fast",
        "medium",
        "slow"
      ],
      "type": "string",
      "description": "Order preset for fusion/cross-chain: fast (quicker fill), medium, slow (better rate)"
    },
    "execute": {
      "type": "boolean",
      "description": "Optional. When a WalletConnect session is active, defaults to true: classic approve/swap txs, Fusion/cross-chain EIP-712 sign+submit, and native escrow sends are handled via the wallet (user confirms prompts). Set execute=false to opt out and receive unsigned calldata or manual signing steps. Set execute=true to require WalletConnect (errors if not connected)."
    },
    "dstChain": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Destination chain for cross-chain swap",
      "exclusiveMinimum": 0
    },
    "gasPrice": {
      "type": "string",
      "description": "Network gas price in wei (optional; omit for fast default)"
    },
    "slippage": {
      "type": "number",
      "maximum": 50,
      "minimum": 0,
      "description": "Slippage tolerance in % (default 0.5)"
    },
    "orderHash": {
      "type": "string",
      "description": "Order hash for submit mode"
    },
    "quoteOnly": {
      "type": "boolean",
      "description": "If true, return quote comparison only (no tx/order)"
    },
    "signedOrder": {
      "type": "string",
      "description": "Signed EIP-712 order (submit mode)"
    },
    "preferredType": {
      "enum": [
        "classic",
        "fusion",
        "crosschain"
      ],
      "type": "string",
      "description": "Preferred swap type; the tool picks one if omitted"
    }
  }
}

{
  "title": "Swap quote & execute",
  "destructiveHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "action",
    "chain"
  ],
  "properties": {
    "chain": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Chain ID (number, e.g. 1 for Ethereum). Required for every action.",
      "exclusiveMinimum": 0
    },
    "limit": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "list: page size (number, default 100, max 500)."
    },
    "order": {
      "type": "object",
      "required": [
        "orderHash",
        "signature",
        "data"
      ],
      "properties": {
        "data": {
          "type": "object",
          "description": "Limit order fields: makerAsset, takerAsset, maker, makingAmount, takingAmount, salt, extension, makerTraits, etc.",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "orderHash": {
          "type": "string",
          "pattern": "^0x[a-fA-F0-9]+$",
          "description": "Hash of the limit order typed data (EIP-712)"
        },
        "signature": {
          "type": "string",
          "minLength": 1,
          "description": "Signature from signTypedData / eth_signTypedData_v4"
        }
      },
      "description": "create (legacy): full signed order payload. Prefer orderHash + signature + orderData after build."
    },
    "action": {
      "enum": [
        "build",
        "create",
        "list",
        "cancel"
      ],
      "type": "string",
      "description": "Invalid or missing \"action\" parameter. Must be one of: \"build\", \"create\", \"list\", \"cancel\". Example: { \"action\": \"list\", \"chain\": 1, \"listMode\": \"by_maker\", \"makerAddress\": \"0x...\" }"
    },
    "cursor": {
      "type": "string",
      "description": "list: pagination cursor from a previous response."
    },
    "sortBy": {
      "enum": [
        "createDateTime",
        "takerRate",
        "makerRate",
        "makerAmount",
        "takerAmount"
      ],
      "type": "string",
      "description": "list: sort field for endpoints that support it."
    },
    "execute": {
      "type": "boolean",
      "description": "Optional. When a WalletConnect session is active, defaults to true: sign typedData and submit the order via the wallet (user confirms prompts). Set execute=false to return typed data for signing elsewhere. Set execute=true to require WalletConnect (errors if not connected)."
    },
    "listMode": {
      "enum": [
        "by_maker",
        "by_hash",
        "all"
      ],
      "type": "string",
      "description": "list: required. by_maker (needs makerAddress), by_hash (needs orderHash), or all."
    },
    "statuses": {
      "type": "string",
      "description": "list: comma-separated status filters (e.g. 1 = active). See Orderbook API docs."
    },
    "orderData": {
      "type": "object",
      "description": "create: the orderData object from the build response.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "orderHash": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]+$",
      "description": "0x-prefixed order hash. create: from the build response. list by_hash and cancel: required."
    },
    "signature": {
      "type": "string",
      "minLength": 1,
      "description": "create: EIP-712 signature from signing the typedData returned by build."
    },
    "makerAsset": {
      "type": "string",
      "minLength": 1,
      "description": "build: required — maker asset token address (0x...) or symbol (e.g. USDC). list: optional address filter."
    },
    "takerAsset": {
      "type": "string",
      "minLength": 1,
      "description": "build: required — taker asset token address (0x...) or symbol (e.g. USDT). list: optional address filter."
    },
    "makerAddress": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Maker wallet address (0x + 40 hex). build: required (the address that signs). list by_maker: required."
    },
    "makingAmount": {
      "type": "string",
      "pattern": "^\\d+$",
      "minLength": 1,
      "description": "build: required — amount of maker asset to sell in smallest units (e.g. 1000000 for 1 USDC), as a string to avoid precision loss."
    },
    "takingAmount": {
      "type": "string",
      "pattern": "^\\d+$",
      "minLength": 1,
      "description": "build: required — amount of taker asset to receive in smallest units, as a string to avoid precision loss."
    },
    "expirationSeconds": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "build: optional order expiration in seconds from now (default 604800 = 7 days).",
      "exclusiveMinimum": 0
    }
  }
}

{
  "title": "Limit orders",
  "destructiveHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "path"
  ],
  "properties": {
    "body": {
      "type": "object",
      "description": "Request body for POST requests",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "path": {
      "type": "string",
      "minLength": 1,
      "description": "API path (e.g. /portfolio/portfolio/v5.0/general/current_value — unified gateway prefix)"
    },
    "query": {
      "type": "object",
      "description": "Query parameters as key-value pairs",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "method": {
      "enum": [
        "GET",
        "POST"
      ],
      "type": "string",
      "default": "GET",
      "description": "HTTP method"
    }
  }
}

{
  "title": "Product API proxy",
  "destructiveHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "action"
  ],
  "properties": {
    "app": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "App / AquaSwapVMRouter address (strategy_* reads, close_position)."
    },
    "sort": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort direction for list/activity/volume (asc|desc)."
    },
    "limit": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Page size for list/activity/volume actions.",
      "exclusiveMinimum": 0
    },
    "maker": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Maker EVM address (strategy_* reads, create_position)."
    },
    "action": {
      "enum": [
        "maker_stats",
        "list_maker_strategies",
        "strategy_overview",
        "strategy_activity",
        "strategy_volume",
        "list_opened",
        "create_position",
        "close_position"
      ],
      "type": "string",
      "description": "Invalid or missing \"action\" parameter. Must be one of: \"maker_stats\", \"list_maker_strategies\", \"strategy_overview\", \"strategy_activity\", \"strategy_volume\", \"list_opened\", \"create_position\", \"close_position\". Example: { \"action\": \"maker_stats\", \"address\": \"0x...\" }"
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "description": "Opaque pagination cursor from a previous response."
    },
    "status": {
      "type": "array",
      "items": {
        "enum": [
          "open",
          "closed"
        ],
        "type": "string"
      },
      "description": "Filter by lifecycle status for list_maker_strategies (e.g. [\"open\"])."
    },
    "tokens": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "token",
              "amount"
            ],
            "properties": {
              "token": {
                "type": "string",
                "pattern": "^0x[a-fA-F0-9]{40}$",
                "description": "ERC-20 token address (no native 0xeee… / zero address)."
              },
              "amount": {
                "type": "string",
                "pattern": "^\\d+$",
                "minLength": 1,
                "description": "Amount to deploy in the token's smallest units (e.g. 1000000 for 1 USDC)."
              }
            }
          }
        },
        {
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^0x[a-fA-F0-9]{40}$"
          }
        }
      ],
      "description": "create_position: exactly two legs [{ token, amount }, { token, amount }] (amount in smallest units, as a string). close_position: array of token addresses to withdraw."
    },
    "address": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Maker EVM address (maker_stats, list_maker_strategies)."
    },
    "chainId": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        },
        {
          "type": "array",
          "items": {
            "type": "integer",
            "maximum": 9007199254740991,
            "exclusiveMinimum": 0
          }
        }
      ],
      "description": "EVM chain ID (number) for single-strategy / write actions, or an array of chain IDs for list/stats filters."
    },
    "execute": {
      "type": "boolean",
      "description": "Optional. When a WalletConnect session is active, defaults to true: the transaction is sent via the wallet (user confirms the prompt). Authenticated sessions may set execute=false to return calldata only. Anonymous sessions always execute via WalletConnect (execute=false is rejected). Set execute=true to require WalletConnect (errors if not connected)."
    },
    "feeBpsIn": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1,
      "description": "Optional taker fee in basis points for create_position (1-500)."
    },
    "strategy": {
      "type": "string",
      "pattern": "^0x(?:[a-fA-F0-9]{2})+$",
      "description": "Encoded strategy/order bytes (close_position)."
    },
    "confirmed": {
      "type": "boolean",
      "description": "create_position: omit to preview, pass true with previewRef to encode (create_position is two-phase: call without confirmed to receive a preview and previewRef (no calldata); review it, then call again with the same parameters, the returned openingPrice, previewRef, and confirmed: true to encode.). close_position: must be true. Closing is permanent. The position stops quoting and moves to Closed. Your tokens stay in your wallet."
    },
    "previewRef": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Short-TTL preview reference returned by the create_position preview call. Pass it back together with confirmed: true to encode; a stale, used, or mismatched ref is refused (no silent re-encode)."
    },
    "priceRange": {
      "type": "object",
      "required": [
        "rawPriceMin",
        "rawPriceMax"
      ],
      "properties": {
        "rawPriceMax": {
          "type": "string",
          "pattern": "^\\d+$",
          "minLength": 1,
          "description": "Maximum raw price P = tokenGt/tokenLt in 1e18 fixed point."
        },
        "rawPriceMin": {
          "type": "string",
          "pattern": "^\\d+$",
          "minLength": 1,
          "description": "Minimum raw price P = tokenGt/tokenLt in 1e18 fixed point."
        }
      },
      "description": "Optional concentrated-liquidity range for create_position (rawPriceMin/rawPriceMax in 1e18)."
    },
    "granularity": {
      "enum": [
        "1h",
        "1d",
        "1m",
        "1y"
      ],
      "type": "string",
      "description": "Volume series bucket (strategy_volume)."
    },
    "openingPrice": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "Opening price as a positive decimal string (token1 per token0, whole units). An XYC position opens at amount1 / amount0, so the preview derives it from the leg amounts when both tokens' decimals are known and rejects a value that disagrees with the legs. Optional on the preview call; required on the confirm call — echo the value the preview returned."
    },
    "strategyHash": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{64}$",
      "description": "Strategy hash (strategy_* reads, close_position)."
    },
    "walletSessionToken": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Optional durable WalletConnect token from walletconnect connect. Anonymous writes must pass it after MCP session rotation (or after any walletconnect call that already used it on this session). Ignored for authenticated callers. Treat as a secret."
    }
  }
}

{
  "title": "Aqua positions",
  "destructiveHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "action"
  ],
  "properties": {
    "tx": {
      "type": "object",
      "properties": {
        "to": {
          "type": "string"
        },
        "data": {
          "type": "string",
          "pattern": "^0x([a-fA-F0-9]{2})*$",
          "maxLength": 1000000
        },
        "from": {
          "type": "string"
        },
        "value": {
          "type": "string",
          "pattern": "^(0x)?[0-9a-fA-F]{1,64}$"
        },
        "chainId": {
          "anyOf": [
            {
              "type": "integer",
              "maximum": 9007199254740991,
              "exclusiveMinimum": 0
            },
            {
              "type": "string",
              "minLength": 1
            }
          ]
        },
        "namespace": {
          "enum": [
            "eip155",
            "solana"
          ],
          "type": "string"
        },
        "serializedTransaction": {
          "type": "string",
          "maxLength": 32768
        }
      },
      "description": "Required when action is \"send_transaction\". EVM or Solana shape — see `tx` field descriptions. Omit for connect, status, sign, disconnect."
    },
    "action": {
      "enum": [
        "connect",
        "status",
        "sign",
        "send_transaction",
        "accept_terms",
        "disconnect"
      ],
      "type": "string",
      "description": "Required. One of: connect (start pairing), status (session info), sign (EVM + Solana WC methods), send_transaction (EVM eth_sendTransaction or Solana solana_signAndSendTransaction), accept_terms (write to the user that they must sign the 1inch Terms of Use, then immediately call this action in the same turn to trigger the wallet prompt — required once per wallet before anonymous writes), disconnect. Only include the fields that apply to this action."
    },
    "method": {
      "enum": [
        "personal_sign",
        "eth_signTypedData_v4",
        "solana_signMessage",
        "solana_signTransaction"
      ],
      "type": "string",
      "description": "Required when action is \"sign\". EVM: personal_sign | eth_signTypedData_v4. Solana: solana_signMessage | solana_signTransaction. Omit for connect, status, send_transaction, disconnect."
    },
    "params": {
      "type": "array",
      "items": {},
      "description": "Required when action is \"sign\": exactly two items. personal_sign: [message, 0xAddress]. eth_signTypedData_v4: [0xSigner, typedDataJsonString]. solana_signMessage: [message, pubkey]. solana_signTransaction: [base64Tx, pubkey]."
    },
    "address": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Optional; only with action \"accept_terms\". EVM address that signs the Terms-of-Use acceptance; must belong to the active WalletConnect session. When omitted, the session's primary EVM account is used."
    },
    "chainId": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Optional; only when action is \"sign\" and method is personal_sign (EVM numeric chain id). Must be omitted for eth_signTypedData_v4, Solana methods, send_transaction, and other actions.",
      "exclusiveMinimum": 0
    },
    "pairingTarget": {
      "enum": [
        "eth",
        "solana",
        "both"
      ],
      "type": "string",
      "description": "Optional; only with action \"connect\". What to advertise in the WalletConnect proposal: \"eth\" (eip155 only, default), \"solana\" only, or \"both\". Many mobile wallets fail if eip155 and solana are proposed together; use \"solana\" or \"both\" only when needed."
    },
    "solanaChainId": {
      "type": "string",
      "description": "Optional; only when action is \"sign\" and method is solana_signMessage or solana_signTransaction. CAIP-2 string (e.g. solana:5eykt4…). When omitted, the server uses the first Solana chain on the session."
    },
    "sessionTtlDays": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Optional; only with action \"connect\". How long to persist this WalletConnect client state in Redis (days). Server clamps to [1, WALLETCONNECT_SESSION_TTL_DAYS_MAX] and defaults when omitted."
    },
    "walletSessionToken": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Optional durable token for ANONYMOUS (unauthenticated) sessions. `connect` mints a fresh token; store it and pass it back on status/sign/send_transaction/accept_terms/disconnect (and on a later `connect` to resume the same pairing) so the wallet session survives MCP session rotation. Treat it as a secret. Ignored for authenticated (OAuth) callers."
    }
  }
}

{
  "title": "WalletConnect (EVM + Solana)",
  "destructiveHint": true
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "number",
      "default": 50,
      "maximum": 100,
      "minimum": 1,
      "description": "Max log lines (max 100)"
    },
    "endTime": {
      "type": "string",
      "description": "RFC3339 end of query window. Defaults to now when omitted."
    },
    "logLevel": {
      "enum": [
        "info",
        "warn",
        "error"
      ],
      "type": "string",
      "description": "Filter by log level: \"info\", \"warn\", or \"error\". Omit to return all levels. Only applies to time-window mode (ignored when requestId is set)."
    },
    "requestId": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9_-]+$",
      "maxLength": 128,
      "minLength": 8,
      "description": "Production x-request-id (or correlation id) to find logs for. When set, searches JSON logs for this value scoped to your organization."
    },
    "startTime": {
      "type": "string",
      "description": "RFC3339 start of query window. With requestId, defaults to 24h before endTime."
    }
  }
}

{
  "title": "Request log lookup",
  "readOnlyHint": true
}

file://1inch-mcp/guides/swap-workflow

file://1inch-mcp/guides/swap/classic

file://1inch-mcp/guides/swap/fusion

file://1inch-mcp/guides/swap/crosschain

file://1inch-mcp/guides/swap/quote

file://1inch-mcp/guides/orderbook-workflow

file://1inch-mcp/guides/api-index

file://1inch-mcp/guides/x402-payments

file://1inch-mcp/guides/aqua-workflow

file://1inch-mcp/examples/%401inch-examples%2Fcross-chain-swap

file://1inch-mcp/examples/%401inch-examples%2Fintent-swap

file://1inch-mcp/examples/%401inch-examples%2Flimit-order

file://1inch-mcp/examples/{id}

file://1inch-mcp/walletconnect/pairing-qr/{token}