{"_id":"@akka-finance/mcp-server","_rev":"3-a94ca80ceab6f0b6dac37c65041b2182","name":"@akka-finance/mcp-server","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@akka-finance/mcp-server","version":"1.0.0","keywords":["mcp","model-context-protocol","dex-aggregator","defi","evm","token-swap","akka-finance"],"license":"MIT","_id":"@akka-finance/mcp-server@1.0.0","maintainers":[{"name":"lkhoshnafs","email":"l.khoshnafs@akka.finance"}],"homepage":"https://akka.finance","bugs":{"url":"https://github.com/Akka-Finance/akka-mcp-server/issues"},"bin":{"akka-mcp":"dist/index.js"},"dist":{"shasum":"291cb23078e60157cb2d869f9df7490f798c3466","tarball":"https://registry.npmjs.org/@akka-finance/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":72,"integrity":"sha512-J9JvcK6oHDswC7buk2U/4GMaYNXs6wRVAZ5KropW09t/lF1IRLeZXByzdAnRFBwzGyMsx9E6dYl1NWMhDnw9tg==","signatures":[{"sig":"MEUCIB5nLSj3gVtZQK2QmaJEKrBTOzMq+DFipL2fpBK3TQM7AiEAjZv1y3aJMNbrMQaskpPfbmZV8m2MCtut7G2Y16XJNsk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":92679},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"adbb980df374898b1447a253294156ad96696975","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc","start":"node dist/index.js","start:http":"node dist/index.js --transport=http","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"lkhoshnafs","email":"l.khoshnafs@akka.finance"},"repository":{"url":"git+https://github.com/Akka-Finance/akka-mcp-server.git","type":"git"},"_npmVersion":"11.8.0","description":"MCP server for AKKA DEX aggregator — swap quotes, routes, and execution across EVM chains","directories":{},"_nodeVersion":"24.13.1","dependencies":{"zod":"^3.24.0","express":"^5.1.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","vitest":"^3.0.0","typescript":"^5.6.0","@types/node":"^22.0.0","@types/express":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.0_1780322722051_0.008395989526890357","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@akka-finance/mcp-server","version":"1.0.1","keywords":["mcp","model-context-protocol","dex-aggregator","defi","evm","token-swap","akka-finance"],"license":"MIT","_id":"@akka-finance/mcp-server@1.0.1","maintainers":[{"name":"lkhoshnafs","email":"l.khoshnafs@akka.finance"}],"homepage":"https://akka.finance","bugs":{"url":"https://github.com/Akka-Finance/akka-mcp-server/issues"},"bin":{"akka-mcp":"dist/index.js"},"dist":{"shasum":"1a5b1dbcb10c1ebc66869d49d9a2051854be7de1","tarball":"https://registry.npmjs.org/@akka-finance/mcp-server/-/mcp-server-1.0.1.tgz","fileCount":72,"integrity":"sha512-XVqnfi0lvPsSfSiabqJOypDr0lwPqdGZJt1GP0xiJviv3xUG2HmItXDGEo44FQzbcXqDBXtjthytiirhhFU9aw==","signatures":[{"sig":"MEYCIQCKumsK03cKUIysTmFUn/3g+a3DyQkm8tzHADoksLZLoQIhAIMd8wz5BtBHfpvlkYd++bqTAZRE6Afih7xCfd84O2tD","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":92729},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"97d3d1b0b0e458a370dc1cfddcaa70dc168f440c","mcpName":"io.github.Akka-Finance/mcp-server","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc","start":"node dist/index.js","start:http":"node dist/index.js --transport=http","test:watch":"vitest","prepublishOnly":"npm run build"},"_npmUser":{"name":"lkhoshnafs","email":"l.khoshnafs@akka.finance"},"repository":{"url":"git+https://github.com/Akka-Finance/akka-mcp-server.git","type":"git"},"_npmVersion":"11.8.0","description":"MCP server for AKKA DEX aggregator — swap quotes, routes, and execution across EVM chains","directories":{},"_nodeVersion":"24.13.1","dependencies":{"zod":"^3.24.0","express":"^5.1.0","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","vitest":"^3.0.0","typescript":"^5.6.0","@types/node":"^22.0.0","@types/express":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.1_1780323304831_0.12018489296220491","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@akka-finance/mcp-server","version":"1.0.2","mcpName":"io.github.Akka-Finance/mcp-server","description":"MCP server for AKKA DEX aggregator — swap quotes, routes, and execution across EVM chains","type":"module","bin":{"akka-mcp":"dist/index.js"},"main":"./dist/index.js","scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js","start:http":"node dist/index.js --transport=http","test":"vitest run","test:watch":"vitest","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","express":"^5.1.0","zod":"^3.24.0"},"devDependencies":{"@types/express":"^5.0.0","@types/node":"^22.0.0","tsx":"^4.19.0","typescript":"^5.6.0","vitest":"^3.0.0"},"engines":{"node":">=18.0.0"},"keywords":["mcp","model-context-protocol","dex-aggregator","defi","evm","token-swap","akka-finance"],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/Akka-Finance/akka-mcp-server.git"},"homepage":"https://akka.finance","bugs":{"url":"https://github.com/Akka-Finance/akka-mcp-server/issues"},"gitHead":"2a24e0e8774002730a863e9f91687ae45863fa23","types":"./dist/index.d.ts","_id":"@akka-finance/mcp-server@1.0.2","_nodeVersion":"24.13.1","_npmVersion":"11.8.0","dist":{"integrity":"sha512-ZHwiv0ULkPHwLEg2E4y4SPXPyf4IuCMrO0D/0RL9FPqEc+qtUZaPT94GIaHDGPoLtK2s1pngYMYMKZsmE9tg7w==","shasum":"893ff262d1cc562a01302a4e0e49fbb11e38303b","tarball":"https://registry.npmjs.org/@akka-finance/mcp-server/-/mcp-server-1.0.2.tgz","fileCount":72,"unpackedSize":93165,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGrv5Csd7iXITzJ2xxUzICTUrvcieT9AiGvzPKAGofRBAiEAoZ+31lbtrtjUF1d5ama064pcot9splV4xqbPA5d6tBk="}]},"_npmUser":{"name":"lkhoshnafs","email":"l.khoshnafs@akka.finance"},"directories":{},"maintainers":[{"name":"lkhoshnafs","email":"l.khoshnafs@akka.finance"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_1.0.2_1780550170563_0.22329124789845434"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-01T14:05:21.854Z","modified":"2026-06-04T05:16:10.847Z","1.0.0":"2026-06-01T14:05:22.237Z","1.0.1":"2026-06-01T14:15:04.990Z","1.0.2":"2026-06-04T05:16:10.720Z"},"bugs":{"url":"https://github.com/Akka-Finance/akka-mcp-server/issues"},"license":"MIT","homepage":"https://akka.finance","keywords":["mcp","model-context-protocol","dex-aggregator","defi","evm","token-swap","akka-finance"],"repository":{"type":"git","url":"git+https://github.com/Akka-Finance/akka-mcp-server.git"},"description":"MCP server for AKKA DEX aggregator — swap quotes, routes, and execution across EVM chains","maintainers":[{"name":"lkhoshnafs","email":"l.khoshnafs@akka.finance"}],"readme":"# @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","readmeFilename":"README.md"}