MCP Server (AI Agents)

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

Claude Desktop
Claude Code
Cursor
VS Code

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"
      }
    }
  }
}

claude mcp add akka-dex -e AKKA_API_KEY=your-api-key -- npx -y @akka-finance/mcp-server

Add to .cursor/mcp.json:

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

Add to .vscode/mcp.json:

{
  "servers": {
    "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:

Tool	Description
`akka_get_quote`	Get the best swap quote across all supported DEXes
`akka_get_swap`	Build an unsigned swap transaction
`akka_dex_compare`	Compare quotes across individual DEX pools
`akka_get_spender`	Get the router contract address for token approval
`akka_get_approve_tx`	Build an ERC-20 approve transaction
`akka_check_allowance`	Check current token spending allowance
`akka_list_tokens`	List tradeable tokens on a chain
`akka_get_token`	Get token details by address
`akka_list_chains`	List all supported chains

Example conversations

Once the MCP server is connected, you can ask your AI agent things like:

Get a swap quote

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.

Compare DEX prices

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.

Build a swap transaction

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:

Variable	Default	Description
`AKKA_API_BASE`	`https://api.akka.finance`	AKKA API base URL
`AKKA_API_KEY`	required	API key for AKKA Finance API
`AKKA_MCP_TRANSPORT`	`stdio`	Transport: `stdio` or `http`
`AKKA_MCP_PORT`	`3100`	Port for HTTP transport
`AKKA_TIMEOUT`	`15000`	Request 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.

Getting Started

Guides

Resources

What is MCP?

Prerequisites

Install

Available tools

Example conversations

Configuration

HTTP transport

Architecture

Links

​What is MCP?

​Prerequisites

​Install

​Available tools

​Example conversations

​Configuration

​HTTP transport

​Architecture

​Links

What is MCP?

Prerequisites

Install

Available tools

Example conversations

Configuration

HTTP transport

Architecture

Links