Skip to main content
AKKA provides an official MCP server that lets AI agents get swap quotes, compare DEX prices, and build unsigned transactions — all through natural language.

​
What is MCP?

The Model Context Protocol is an open standard that connects AI assistants to external tools. With AKKA’s MCP server, an AI agent can:
  • Get the best swap quote across 25+ DEXes
  • Compare prices across individual liquidity pools
  • Build unsigned swap and approval transactions
  • Look up token details and supported chains
The server is a thin client that calls the AKKA REST API. It does not hold private keys or execute transactions — it only returns unsigned transaction data.

​
Prerequisites

An AKKA API key is required. Get your API key here.

​
Install

Add to your claude_desktop_config.json:
{
  "mcpServers": {
    "akka-dex": {
      "command": "npx",
      "args": ["-y", "@akka-finance/mcp-server"],
      "env": {
        "AKKA_API_KEY": "your-api-key"
      }
    }
  }
}

​
Available tools

Once connected, your AI agent has access to these tools:
ToolDescription
akka_get_quoteGet the best swap quote across all supported DEXes
akka_get_swapBuild an unsigned swap transaction
akka_dex_compareCompare quotes across individual DEX pools
akka_get_spenderGet the router contract address for token approval
akka_get_approve_txBuild an ERC-20 approve transaction
akka_check_allowanceCheck current token spending allowance
akka_list_tokensList tradeable tokens on a chain
akka_get_tokenGet token details by address
akka_list_chainsList all supported chains

​
Example conversations

Once the MCP server is connected, you can ask your AI agent things like:
You: “What’s the best rate for swapping 1 ETH to USDC on Arbitrum?”The agent calls akka_get_quote with the correct chain ID, token addresses, and amount in wei, then shows you the expected output.
You: “Compare prices for 1000 USDC to WETH across all DEXes on Base”The agent calls akka_dex_compare and presents a table showing which DEX offers the best rate.
You: “Build a swap transaction for 0.5 HYPE to USDC on HyperEVM for wallet 0xabc…”The agent calls akka_get_quote first, confirms the rate with you, then calls akka_get_swap to return the unsigned transaction data you can sign and broadcast.

​
Configuration

The MCP server can be configured via environment variables:
VariableDefaultDescription
AKKA_API_BASEhttps://api.akka.financeAKKA API base URL
AKKA_API_KEYrequiredAPI key for AKKA Finance API
AKKA_MCP_TRANSPORTstdioTransport: stdio or http
AKKA_MCP_PORT3100Port for HTTP transport
AKKA_TIMEOUT15000Request timeout in ms

​
HTTP transport

For remote or web-based agents, run the server with HTTP transport: 
npx @akka-finance/mcp-server --transport=http --port=3100
This exposes a Streamable HTTP endpoint at http://localhost:3100/mcp.

​
Architecture

AI Agent (Claude, Cursor, VS Code, etc.)
  ↕ MCP Protocol (stdio or HTTP)
AKKA MCP Server (@akka-finance/mcp-server)
  ↕ HTTP REST
AKKA Finance API (api.akka.finance)
  ↕ On-chain
25+ DEXes across EVM chains
The MCP server translates natural language tool calls into AKKA API requests and formats the responses for the AI agent. All swap and approve tools return unsigned transaction data — signing and broadcasting is always the user’s responsibility.