Back to Browse

Akka MCP Server

FinanceModerate5.2MCP RegistryLocal
Free

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

5.2
Moderate5.2Moderate Risk

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.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Base URL of the AKKA Finance APIOptional

Environment variable: AKKA_API_BASE

API key for AKKA Finance APIRequired

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 GitHub

From 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.

npm version License: MIT

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

ToolDescription
akka_get_quoteGet the best swap quote across 25+ DEXes
akka_get_swapBuild an unsigned swap transaction
akka_dex_compareCompare quotes across individual DEX pools
akka_get_spenderGet the router contract address for token approval
akka_get_approve_txBuild an ERC-20 approve transaction
akka_check_allowanceCheck current token spending allowance
akka_list_tokensList tradeable tokens on a chain
akka_get_tokenGet token details by address
akka_list_chainsList all supported chains

Supported Chains

Chain IDNetworkNative Token
999HyperEVM (Hyperliquid)HYPE
1EthereumETH
8453BaseETH
42161ArbitrumETH
56BNB ChainBNB

Configuration

Configuration via environment variables or CLI arguments:

Env VariableCLI ArgDefaultDescription
AKKA_API_BASE--api-basehttps://api.akka.financeAKKA API base URL
AKKA_API_KEY--api-keyrequiredAPI key for AKKA Finance API
AKKA_MCP_TRANSPORT--transportstdioTransport: stdio or http
AKKA_MCP_PORT--port3100Port for HTTP transport
AKKA_TIMEOUT--timeout15000Request 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!