English Français العربية

io.github.Akka-Finance/mcp-server

السجل الرسمي المالية والمدفوعات

MCP server for AKKA Finance DEX aggregator — swap quotes, routes, and execution

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @akka-finance/mcp-server
Claude Code 
claude mcp add io-github-akka-finance-mcp-server -e 'AKKA_API_BASE=<AKKA_API_BASE>' -e 'AKKA_API_KEY=<your akka_api_key>' -- npx -y @akka-finance/mcp-server@1.0.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "io-github-akka-finance-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@akka-finance/mcp-server@1.0.2"
            ],
            "env": {
                "AKKA_API_BASE": "<AKKA_API_BASE>",
                "AKKA_API_KEY": "<your akka_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • AKKA_API_BASE Base URL of the AKKA Finance API
  • AKKA_API_KEY إلزامي سري API key for AKKA Finance API

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @akka-finance/mcp-server
  2. Prerequisites
  3. Install
  4. Tools
  5. Supported Chains
  6. Configuration
  7. Base MCP Skill Plugin
  8. Development
  9. How It Works
  10. License

@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

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

الأسئلة الشائعة

ما هو io.github.Akka-Finance/mcp-server؟

MCP server for AKKA Finance DEX aggregator — swap quotes, routes, and execution

كيف أثبّت io.github.Akka-Finance/mcp-server؟

يعمل على جهازك. في Claude Code: claude mcp add io-github-akka-finance-mcp-server -e 'AKKA_API_BASE=<AKKA_API_BASE>' -e 'AKKA_API_KEY=<your akka_api_key>' -- npx -y @akka-finance/mcp-server@1.0.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Akka-Finance/mcp-server إلى مفتاح API؟

نعم. يتطلب AKKA_API_KEY، وتضبطها في إعداداته.

هل io.github.Akka-Finance/mcp-server مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.Akka-Finance/mcp-server؟

ينشره Akka-Finance. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.