Akka Finance

io.github.Akka-FinancePublished by GitHub account Akka-Financev1.0.2Updated Oct 24, 2026

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

The publisher's own server: Finance Foundation

VerifiedSTDIODesktop onlyFinanceDeveloper Tools

Overview

AI-generated overview

Local MCP server for the AKKA Finance DEX aggregator that lets an assistant fetch swap quotes, compare DEX pools, and build unsigned swap and approval data.

What you can do
Get best swap quotes across many DEXes and compare quotes across individual pools, with token and chain listings for supported networks and token lookup by address. Build unsigned swap transactions and ERC-20 approve transactions. Look up the router spender address and check current token spending allowances. It is a thin client over the AKKA Finance REST API and does not hold keys or execute transactions.
When to use it
Useful when an assistant should help research swap routes and pricing across EVM chains, or prepare unsigned swap and approval transactions for a user to sign and broadcast in their own wallet.
Requirements
Runs locally via npx with Node.js. Requires an AKKA API key supplied as the AKKA_API_KEY environment variable or the --api-key argument. Optional settings include AKKA_API_BASE, AKKA_MCP_TRANSPORT, AKKA_MCP_PORT and AKKA_TIMEOUT. Network access to the AKKA Finance API is needed.
Before you install
Requires an AKKA API key, which is stored in the client configuration. It returns unsigned transaction data only; the user must review, sign and broadcast transactions separately, and mistakes in swap or approval data can cost funds. Requests and query details are sent to the AKKA Finance API.

Installation

In SourceWeft

  1. Open Akka Finance in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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:

json
{  "mcpServers": {    "akka-dex": {      "command": "npx",      "args": ["-y", "@akka-finance/mcp-server"],      "env": {        "AKKA_API_KEY": "your-api-key"      }    }  }}

Claude Code

bash
claude mcp add akka-dex -e AKKA_API_KEY=your-api-key -- npx -y @akka-finance/mcp-server

Cursor

Add to .cursor/mcp.json:

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:

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:

bash
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

bash
git clone https://github.com/Akka-Finance/akka-mcp-server.gitcd akka-mcp-servernpm installnpm run dev        # Run with tsx (hot reload)npm run build      # Compile TypeScriptnpm start          # Run compiled output

Testing with MCP Inspector

bash
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 RESTAKKA Finance API  ↕ On-chain25+ DEXes across 7 EVM chains

License

MIT

Source: README.md at commit 2a24e0e

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Finance integrations

Finance Foundation

foundation.financeOfficial publisher

A remote MCP server for open financial reference data: look up companies, markets, funds and assets, resolve identifiers, traverse a knowledge graph and read a

Streamable HTTPWeb executable
Finance7 toolsOct 24, 2026

FYN

fyi.fynOfficial publisher

Read-only personal finance for AI agents: budgets, receipts, net worth, bills. OAuth 2.1.

Streamable HTTPWeb executableAuth
Data & AnalyticsCredential requiredNov 3, 2026

Korea Finance Factcheck

Published by GitHub account hs85-newbie

Fact-checks numbers in Korean finance writing against DART, Bank of Korea ECOS and US Treasury

STDIODesktop only
Finance5 toolsNov 7, 2026

Apizie Finance

Published by GitHub account nafadza14

Apizie Finance is a remote MCP server giving assistants cited access to official financial and economic data from SEC EDGAR, FRED, ECB, Treasury, GLEIF and…

Streamable HTTPWeb executableAuth
Data & AnalyticsCredential requiredNov 1, 2026

Finance MCP

Published by GitHub account aowang-ai

Hosted MCP server that lets an assistant discover, inspect and run finance data tools covering US stocks, SEC filings, macro series, crypto and prediction…

Streamable HTTPWeb executable
Data & Analytics3 toolsOct 25, 2026