akka-finance-mcp-server
OfficialThis 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.
@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.
Related MCP server: persistenceone-bridgekitty
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-serverCursor
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 |
| 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 |
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 URL |
|
| required | API key for AKKA Finance API |
|
|
| Transport: |
|
|
| Port for HTTP transport |
|
|
| Request timeout in ms |
HTTP Transport
For remote/web-based agents:
npx @akka-finance/mcp-server --transport=http --port=3100Exposes 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 outputTesting with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.jsHow 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 chainsLicense
MIT
Maintenance
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Akka-Finance/akka-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server