Server data from the Official MCP Registry
MCP server for AKKA Finance DEX aggregator — swap quotes, routes, and execution
About
MCP server for AKKA Finance DEX aggregator — swap quotes, routes, and execution
Security Report
This MCP server is a well-structured thin client for the AKKA DEX aggregator API. Authentication is properly handled via environment variable API keys, and the server correctly returns unsigned transaction data without executing swaps or holding private keys. Permissions align well with its purpose as a DeFi quote and transaction builder. Minor code quality observations exist around error handling breadth, but no security vulnerabilities or dangerous patterns were identified. Supply chain analysis found 6 known vulnerabilities in dependencies (2 critical, 3 high severity). Package verification found 1 issue.
7 files analyzed · 11 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: AKKA_API_BASE
Environment variable: AKKA_API_KEY
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-akka-finance-mcp-server": {
"env": {
"AKKA_API_KEY": "your-akka-api-key-here",
"AKKA_API_BASE": "your-akka-api-base-here"
},
"args": [
"-y",
"@akka-finance/mcp-server"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
@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
Reviews
No reviews yet
Be the first to review this server!
More Finance MCP Servers
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.
Google Workspace MCP
Freeby Taylorwilsdon · Productivity
Control Gmail, Calendar, Docs, Sheets, Drive, and more from your AI
