MCP Server - For Hosted Agents
Trade, manage liquidity, and build transactions via Model Context Protocol from any hosted AI agent
13 tools over the Model Context Protocol. Read-only and calldata-building only — the server never holds private keys, never signs, never broadcasts. It returns unsigned transaction objects and EIP-712 typed data for the user to sign with their own wallet.
Repository: github.com/KyberNetwork/kyberswap-mcp
What is MCP?
The Model Context Protocol is an open standard that lets AI applications connect to external tools and data sources. The KyberSwap MCP Server gives any MCP-compatible AI client access to:
Swap quotes and transaction building across 18 EVM chains
Token metadata, pricing, and security assessment
Gasless limit order creation and management
Concentrated liquidity pool discovery and zap operations
Transaction simulation and status checking
Setup
Add the server to your project or user scope:
// .mcp.json
{
"mcpServers": {
"kyberswap": {
"command": "node",
"args": ["/path/to/kyberswap-mcp/dist/index.js"]
}
}
}// claude_desktop_config.json
{
"mcpServers": {
"kyberswap": {
"command": "node",
"args": ["/path/to/kyberswap-mcp/dist/index.js"]
}
}
}Other MCP-Compatible Tools
Any client that supports the MCP specification can connect via stdio transport. Point it to the compiled server entry point at dist/index.js.
Build from Source
No API keys required. KyberSwap APIs are public.
Available Tools
Price Discovery & Market Data
get-quote
Get the best swap route from the KyberSwap Aggregator. Returns exchange rate, route details, gas estimate, USD values, price impact, and token safety warnings.
token-info
Retrieve token metadata, live USD price, and security assessment. Accepts single tokens or comma-separated lists (e.g., "USDC, WBTC, ETH").
get-pool-info
Query liquidity pools — TVL, 24h volume, APR, LP APR, earned fees. Filter by token pair, DEX protocol, or sort by metrics.
Swap Transaction Building
swap-build
Construct an unsigned swap transaction. Returns the complete transaction object (to, data, value) ready for external wallet signing. Routes expire after ~30 seconds.
swap-simulate
Dry-run a swap transaction via eth_call — no gas or funds required. Validates route validity before signing. Decodes revert reasons on failure.
swap-status
Check on-chain status of a submitted transaction. Returns receipt data, gas used, and explorer URL. Replays failed transactions to decode revert reasons.
Gasless Limit Orders
limit-order-build
Construct a gasless limit order. Returns EIP-712 typed data for wallet signing. Validates maker asset, checks price deviation from market, and returns approval requirements.
limit-order-submit
Submit a signed limit order to KyberSwap. Called after the user signs the EIP-712 data from limit-order-build. Returns the order ID.
limit-order-cancel-build
Build a gasless cancellation for one or more limit orders. Returns EIP-712 typed data to sign. Gasless window is ~90 seconds from order creation.
limit-order-cancel-submit
Submit the signed gasless cancellation.
Portfolio & Position Management
order-manager
Query limit orders for a wallet. Filter by status (open, partially filled, filled, cancelled, expired). Shows fill progress, target vs effective prices, and remaining amounts.
position-manager
Monitor liquidity positions across chains. Returns total value, unclaimed fees, 30-day APR, price ranges, and protocol details. Filter by chain, protocol, or status.
Concentrated Liquidity
zap
Build concentrated liquidity transactions — zap-in (add liquidity) or zap-out (remove liquidity). Supports tick/price bounds, full range, partial withdrawal, and NFT burning.
Workflows
Swap
Limit Order
Add Liquidity
Cancel Order
Safety Features
The MCP server includes built-in safety checks on every operation:
Honeypot detection — flags tokens with transfer restrictions
Fee-on-transfer (FOT) detection — adjusts expected amounts for taxed tokens
Price deviation checks — blocks limit orders >50% below market, warns at >10%
Price impact evaluation — warns at >1% impact, blocks at >15%
Balance sufficiency checks — verifies the sender has enough tokens
Route expiration warnings — routes are valid for ~30 seconds
Gasless cancel window tracking — warns when the 90-second free cancellation window expires
Supported Exchanges and Networks
Refer to Supported Exchanges and Networks.
Each chain has a default public RPC URL that can be overridden via environment variables (e.g., RPC_URL_ETHEREUM, RPC_URL_ARBITRUM).
Architecture
Transport
Stdio (stdin/stdout JSON-RPC) via @modelcontextprotocol/sdk. This is the standard MCP transport for local integrations.
API Services
Aggregator
aggregator-api.kyberswap.com
Swap routing and calldata building
Token API
token-api.kyberswap.com
Token metadata, pricing, honeypot detection
Limit Order
limit-order.kyberswap.com
Gasless limit order lifecycle
Earn Service
earn-service.kyberswap.com
Pool info, position management
Zap API
zap-api.kyberswap.com
Concentrated liquidity operations
All API requests include the X-Client-Id: ai-agent-mcp header and have a 15-second timeout.
On-Chain Reads
The server uses viem public clients for eth_call (simulation) and getTransactionReceipt (status checks) via the configured RPC URLs.
Key Contracts
Key Design Principle
The MCP server never holds private keys. It constructs unsigned calldata or EIP-712 typed data and returns it to the client. The user signs with their own wallet infrastructure — hardware wallet, browser extension, or external signer.
Configuration
Environment Variables
All optional. Override default RPC endpoints per chain:
RPC_URL_ETHEREUM
LlamaRPC
RPC_URL_BSC
Binance public RPC
RPC_URL_ARBITRUM
Arbitrum public RPC
RPC_URL_{CHAIN}
Chain-specific default
No wallet secrets, API keys, or other sensitive configurations are required.
Dependencies
Node.js 18+
@modelcontextprotocol/sdk^1.12.0viem^2.23.0zod^3.24.0
Resources
Repository: github.com/KyberNetwork/kyberswap-mcp
KyberSwap Skills (for local agents): github.com/KyberNetwork/kyberswap-skills
MCP Specification: modelcontextprotocol.io
Last updated
Was this helpful?