{
  "markdown": "# @akka-finance/mcp-server\n\nMCP server for the [AKKA Finance](https://akka.finance) DEX aggregator — swap quotes, routes, and execution across EVM chains.\n\n[![npm version](https://img.shields.io/npm/v/@akka-finance/mcp-server)](https://www.npmjs.com/package/@akka-finance/mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\n\n## Prerequisites\n\nAn AKKA API key is required. Get one at [docs.akka.finance/authentication](https://docs.akka.finance/authentication).\n\n## Install\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"akka-dex\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@akka-finance/mcp-server\"],\n      \"env\": {\n        \"AKKA_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add akka-dex -e AKKA_API_KEY=your-api-key -- npx -y @akka-finance/mcp-server\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"akka-dex\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@akka-finance/mcp-server\"],\n      \"env\": {\n        \"AKKA_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### VS Code\n\nAdd to `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"akka-dex\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@akka-finance/mcp-server\"],\n      \"env\": {\n        \"AKKA_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `akka_get_quote` | Get the best swap quote across 25+ DEXes |\n| `akka_get_swap` | Build an unsigned swap transaction |\n| `akka_dex_compare` | Compare quotes across individual DEX pools |\n| `akka_get_spender` | Get the router contract address for token approval |\n| `akka_get_approve_tx` | Build an ERC-20 approve transaction |\n| `akka_check_allowance` | Check current token spending allowance |\n| `akka_list_tokens` | List tradeable tokens on a chain |\n| `akka_get_token` | Get token details by address |\n| `akka_list_chains` | List all supported chains |\n\n## Supported Chains\n\n| Chain ID | Network | Native Token |\n|----------|---------|-------------|\n| 999 | HyperEVM (Hyperliquid) | HYPE |\n| 1 | Ethereum | ETH |\n| 8453 | Base | ETH |\n| 42161 | Arbitrum | ETH |\n| 56 | BNB Chain | BNB |\n\n## Configuration\n\nConfiguration via environment variables or CLI arguments:\n\n| Env Variable | CLI Arg | Default | Description |\n|-------------|---------|---------|-------------|\n| `AKKA_API_BASE` | `--api-base` | `https://api.akka.finance` | AKKA API base URL |\n| `AKKA_API_KEY` | `--api-key` | **required** | API key for AKKA Finance API |\n| `AKKA_MCP_TRANSPORT` | `--transport` | `stdio` | Transport: `stdio` or `http` |\n| `AKKA_MCP_PORT` | `--port` | `3100` | Port for HTTP transport |\n| `AKKA_TIMEOUT` | `--timeout` | `15000` | Request timeout in ms |\n\n### HTTP Transport\n\nFor remote/web-based agents:\n\n```bash\nnpx @akka-finance/mcp-server --transport=http --port=3100\n```\n\nExposes a Streamable HTTP endpoint at `http://localhost:3100/mcp`.\n\n## Base MCP Skill Plugin\n\nA Base MCP skill plugin for token swaps on Base is included at [`skills/akka-swap.md`](skills/akka-swap.md). Drop it into your Base MCP skills directory to enable AKKA-powered swaps through Base's smart wallet flow.\n\n## Development\n\n```bash\ngit clone https://github.com/Akka-Finance/akka-mcp-server.git\ncd akka-mcp-server\nnpm install\nnpm run dev        # Run with tsx (hot reload)\nnpm run build      # Compile TypeScript\nnpm start          # Run compiled output\n```\n\n### Testing with MCP Inspector\n\n```bash\nnpx @modelcontextprotocol/inspector node dist/index.js\n```\n\n## How It Works\n\nThis MCP server is a thin client that calls the [AKKA Finance REST API](https://api.akka.finance/docs). 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.\n\n```\nAI Agent (Claude, Cursor, etc.)\n  ↕ MCP Protocol (stdio or HTTP)\nAKKA MCP Server (this package)\n  ↕ HTTP REST\nAKKA Finance API\n  ↕ On-chain\n25+ DEXes across 7 EVM chains\n```\n\n## License\n\nMIT\n",
  "bytes": 4034,
  "sha": "f0f303917703880b8968311cb2b55932c3493d142faa298f89f86fa9dbe8fb4c",
  "repo_slug": "akka-finance/akka-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_akka_finance_mcp_server_e5e88536/readme"
}