# Akka Mcp Server

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-akka-finance-akka-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Akka-Finance](https://agentstack.voostack.com/s/akka-finance)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 1.0.1
- **License:** MIT
- **Upstream author:** [Akka-Finance](https://github.com/Akka-Finance)
- **Source:** https://github.com/Akka-Finance/akka-mcp-server

## Install

```sh
agentstack add mcp-akka-finance-akka-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# @akka-finance/mcp-server

MCP server for the [AKKA Finance](https://akka.finance) DEX aggregator — swap quotes, routes, and execution across EVM chains.

[](https://www.npmjs.com/package/@akka-finance/mcp-server)
[](LICENSE)

## Prerequisites

An AKKA API key is required. Get one at [docs.akka.finance/authentication](https://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

| Tool | Description |
|------|-------------|
| `akka_get_quote` | Get the best swap quote across 25+ DEXes |
| `akka_get_swap` | Build an unsigned swap transaction |
| `akka_dex_compare` | Compare quotes across individual DEX pools |
| `akka_get_spender` | Get the router contract address for token approval |
| `akka_get_approve_tx` | Build an ERC-20 approve transaction |
| `akka_check_allowance` | Check current token spending allowance |
| `akka_list_tokens` | List tradeable tokens on a chain |
| `akka_get_token` | Get token details by address |
| `akka_list_chains` | List all supported chains |

## Supported Chains

| Chain ID | Network | Native Token |
|----------|---------|-------------|
| 999 | HyperEVM (Hyperliquid) | HYPE |
| 1 | Ethereum | ETH |
| 8453 | Base | ETH |
| 42161 | Arbitrum | ETH |
| 56 | BNB Chain | BNB |

## Configuration

Configuration via environment variables or CLI arguments:

| Env Variable | CLI Arg | Default | Description |
|-------------|---------|---------|-------------|
| `AKKA_API_BASE` | `--api-base` | `https://api.akka.finance` | AKKA API base URL |
| `AKKA_API_KEY` | `--api-key` | **required** | API key for AKKA Finance API |
| `AKKA_MCP_TRANSPORT` | `--transport` | `stdio` | Transport: `stdio` or `http` |
| `AKKA_MCP_PORT` | `--port` | `3100` | Port for HTTP transport |
| `AKKA_TIMEOUT` | `--timeout` | `15000` | Request 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`](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.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

```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](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.

```
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

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Akka-Finance](https://github.com/Akka-Finance)
- **Source:** [Akka-Finance/akka-mcp-server](https://github.com/Akka-Finance/akka-mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v1.0.1 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **1.0.1** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-akka-finance-akka-mcp-server
- Seller: https://agentstack.voostack.com/s/akka-finance
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.