@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:

config.json

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

Claude Code

Terminal

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

Cursor

Add to .cursor/mcp.json:

config.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:

config.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:

Terminal

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

bash

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

Terminal

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.

Code

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