AKKA Finance MCP
MCP server for AKKA Finance DEX aggregator — swap quotes, routes, and execution
Runs on your machine from its package; the steps are below.
What it does
- Reads
- Writes
- High impact
At most: only reads or looks up information.
What it costs
FreeOdel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Run
npx -y @akka-finance/mcp-server
MCP client config
{
"mcpServers": {
"akka-finance-mcp": {
"command": "npx",
"args": [
"-y",
"@akka-finance/mcp-server"
]
}
}
}@akka-finance/mcp-server
MCP server for the AKKA Finance DEX aggregator — swap quotes, routes, and execution across EVM chains.
Prerequisites
An AKKA API key is required. Get one at docs.akka.finance/authentication.
Install
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"akka-dex": {
"command": "npx",
"args": ["-y", "@akka-finance/mcp-server"],
"env": {
"AKKA_API_KEY": "your-api-key"
}
}
}
}
Claude Code
claude mcp add akka-dex -e AKKA_API_KEY=your-api-key -- npx -y @akka-finance/mcp-server
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"akka-dex": {
"command": "npx",
"args": ["-y", "@akka-finance/mcp-server"],
"env": {
"AKKA_API_KEY": "your-api-key"
}
}
}
}
VS Code
Add to .vscode/mcp.json:
{
"servers": {
"akka-dex": {
"command": "npx",
"args": ["-y", "@akka-finance/mcp-server"],
"env": {
"AKKA_API_KEY": "your-api-key"
}
}
}
}
Tools
| Tool | Description |
|---|---|
akka_get_quote | Get the best swap quote across 25+ 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 |
Supported Chains
| Chain ID | Network | Native Token |
|---|---|---|
| 999 | HyperEVM (Hyperliquid) | HYPE |
| 1 | Ethereum | ETH |
| 8453 | Base | ETH |
| 42161 | Arbitrum | ETH |
| 56 | BNB Chain | BNB |
Configuration
Configuration via environment variables or CLI arguments:
| Env Variable | CLI Arg | Default | Description |
|---|---|---|---|
AKKA_API_BASE | --api-base | https://api.akka.finance | AKKA API base URL |
AKKA_API_KEY | --api-key | required | API key for AKKA Finance API |
AKKA_MCP_TRANSPORT | --transport | stdio | Transport: stdio or http |
AKKA_MCP_PORT | --port | 3100 | Port for HTTP transport |
AKKA_TIMEOUT | --timeout | 15000 | Request timeout in ms |
HTTP Transport
For remote/web-based agents:
npx @akka-finance/mcp-server --transport=http --port=3100
Exposes a Streamable HTTP endpoint at http://localhost:3100/mcp.
Base MCP Skill Plugin
A Base MCP skill plugin for token swaps on Base is included at skills/akka-swap.md. Drop it into your Base MCP skills directory to enable AKKA-powered swaps through Base's smart wallet flow.
Development
git clone https://github.com/Akka-Finance/akka-mcp-server.git
cd akka-mcp-server
npm install
npm run dev # Run with tsx (hot reload)
npm run build # Compile TypeScript
npm start # Run compiled output
Testing with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js
How It Works
This MCP server is a thin client that calls the AKKA Finance REST API. It does not hold private keys or execute transactions. All swap/approve tools return unsigned transaction data that the user must sign and broadcast separately.
AI Agent (Claude, Cursor, etc.)
↕ MCP Protocol (stdio or HTTP)
AKKA MCP Server (this package)
↕ HTTP REST
AKKA Finance API
↕ On-chain
25+ DEXes across 7 EVM chains
License
MIT
