This server enables AI agents to interact with the AKKA Finance DEX aggregator for token swaps, price quotes, and transaction building across multiple EVM blockchains. It generates unsigned transaction data only — it does not hold private keys or execute transactions directly.
Get swap quotes (akka_get_quote): Fetch the best swap quote across 25+ DEXes for a token pair, including expected output amounts and gas estimates.
Build swap transactions (akka_get_swap): Generate a complete unsigned swap transaction with routing data, gas estimates, and slippage tolerance settings.
Compare DEX prices (akka_dex_compare): Compare AKKA's aggregated route against the top 3 individual DEX pool quotes.
Get router/spender address (akka_get_spender): Retrieve the AKKA Router contract address that requires ERC-20 approval before swapping.
Build approve transactions (akka_get_approve_tx): Generate an unsigned ERC-20 approval transaction for the AKKA Router, with optional unlimited approval.
Check token allowance (akka_check_allowance): Query how many tokens the AKKA Router is authorized to spend from a given wallet.
List tradeable tokens (akka_list_tokens): Browse available tokens on a chain, including symbols, addresses, decimals, USD prices, and verification status (with pagination and filtering).
Get token details (akka_get_token): Look up detailed information for a specific token by its contract address.
List supported chains (akka_list_chains): Discover all supported networks — HyperEVM (999), Ethereum (1), Base (8453), Arbitrum (42161), and BNB Chain (56) — along with their chain IDs and native token symbols.
MCP server for the AKKA Finance DEX aggregator — swap quotes, routes, and execution across EVM chains.
An AKKA API key is required. Get one at docs.akka.finance/authentication.
Related MCP server: web3agent
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 mcp add akka-dex -e AKKA_API_KEY=your-api-key -- npx -y @akka-finance/mcp-serverAdd 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"
}
}
}
}Tool | Description |
| Get the best swap quote across 25+ DEXes |
| Build an unsigned swap transaction |
| Compare quotes across individual DEX pools |
| Get the router contract address for token approval |
| Build an ERC-20 approve transaction |
| Check current token spending allowance |
| List tradeable tokens on a chain |
| Get token details by address |
| List all 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 via environment variables or CLI arguments:
Env Variable | CLI Arg | Default | Description |
|
|
| AKKA API base URL |
|
| required | API key for AKKA Finance API |
|
|
| Transport: |
|
|
| Port for HTTP transport |
|
|
| Request timeout in ms |
For remote/web-based agents:
npx @akka-finance/mcp-server --transport=http --port=3100Exposes a Streamable HTTP endpoint at http://localhost:3100/mcp.
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.
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 outputnpx @modelcontextprotocol/inspector node dist/index.jsThis 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 chainsMIT
Check how many tokens the AKKA Router is currently allowed to spend from a wallet. Use this to determine if an approval transaction is needed before swapping. Returns "0" if no approval has been granted. Native token swaps (src = 0xeee...eee) never need approval.
Inputs: chainId (required), tokenAddress (required), walletAddress (required).
Compare swap quotes across individual DEX pools for a token pair. Returns AKKA's aggregated quote alongside the top 3 individual pool quotes, showing how the aggregated route outperforms single-pool swaps. Useful for explaining the routing advantage to users.
Inputs: chainId (required), src (required), dst (required), amount (required).
Generate an ERC-20 approve transaction for the AKKA Router. Returns unsigned transaction data (to, data, value) to be signed and sent. Required before swapping ERC-20 tokens (not needed for native tokens). If amount is omitted, grants unlimited approval.
Inputs: chainId (required), tokenAddress (required), amount.
Get the best swap quote from AKKA DEX aggregator. Returns the expected output amount for swapping tokens on supported EVM chains. Use this to check prices before executing a swap. Amounts are in wei (the token's smallest unit). Use akka_list_chains to find valid chain IDs.
Inputs: chainId (required), src (required), dst (required), amount (required), +2 more.
Get the AKKA Router contract address that needs token approval before swapping ERC-20 tokens. Users must approve this address to spend their tokens. Not needed for native token swaps.
Inputs: chainId (required).
Generate a ready-to-sign swap transaction via AKKA DEX aggregator. Returns complete unsigned transaction data (to, data, value, gas) that the user must sign and broadcast. IMPORTANT: This does NOT execute the swap — it only builds the transaction. Use akka_get_quote first to check the expected output amount.
Inputs: chainId (required), src (required), dst (required), amount (required), +4 more.
Get detailed information about a specific token by its contract address, including symbol, name, decimals, logo, verification status, and USD price.
Inputs: chainId (required), address (required).
List all blockchain networks supported by AKKA DEX aggregator, including chain IDs, network names, and native token symbols. Use this when a user asks about supported chains or needs to find the right chain ID.
Inputs: _.
List available tokens for swapping on a given chain. Returns token symbols, names, addresses, decimals, USD prices, and verification status. Use this to discover tradeable tokens or look up a token's contract address by symbol.
Inputs: chainId (required), page, limit, verified.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 9 tools
Each tool targets a distinct operation: checking allowances, comparing DEX pools, generating approvals, getting quotes, retrieving spender address, building swap transactions, and querying tokens/chains. There is no overlap in functionality.
All tool names follow the consistent pattern 'akka_<verb>_<noun>' with verbs like check, compare, get, list, and descriptive nouns. No naming style variations.
With 9 tools, the server covers essential operations for a DEX aggregator: listing chains/tokens, querying quotes, handling approvals, and building swap transactions. The count is balanced and not excessive.
The tool set covers the full workflow from discovering supported chains and tokens, checking allowances, obtaining quotes, generating approval transactions, to building swap transactions. The only missing piece (broadcasting) is intentionally left to the user.
Delora MCP server for cross-chain quotes, supported chains, tokens, and tools.
MCP server for Boson Protocol — on-chain agentic commerce for physical & digital goods.
Multi-aggregator swap router for AI agents on Base. 10 bps fee. MCP-native, non-custodial.
23-in-1 MCP server: EVM tx simulator, funding rate arb, macro radar, swap calldata & security.
