Skip to content

Solana Venum MCP ​

Use @venumdev/mcp when you want coding agents or trading agents to call Venum through a stable MCP tool surface instead of wiring raw Solana RPC and HTTP flows by hand.

The MCP server exposes Venum execution primitives for:

  • health checks
  • price lookups
  • pool discovery
  • token discovery
  • swap quotes
  • swap builds
  • local signing and submission
  • transaction status

Install ​

Run without installing:

bash
pnpm dlx @venumdev/mcp

Install globally:

bash
pnpm add -g @venumdev/mcp
venum-mcp

Install locally:

bash
pnpm add @venumdev/mcp

API Key ​

Most MCP tools require a Venum API key.

If you already configured the CLI, the MCP server reuses it automatically:

bash
venum config set api-key <your-key>

You can also pass environment variables directly to the MCP process:

bash
VENUM_API_KEY=<your-key>
VENUM_API_URL=https://api.venum.dev

How It Works ​

The current server is intentionally thin:

  1. The MCP client sends a tool call.
  2. @venumdev/mcp invokes @venumdev/cli in --json mode.
  3. The server returns the parsed result back to the agent.

That keeps the tool contract stable while the broader Venum SDK and agent surface evolves.

Tool Surface ​

Current MCP tools:

  • health
  • price
  • prices
  • pools
  • tokens
  • quote
  • swap_build
  • swap_sign_and_submit
  • tx_status

Example MCP Config ​

If your machine already has a saved Venum CLI config:

json
{
  "mcpServers": {
    "venum": {
      "command": "pnpm",
      "args": ["dlx", "@venumdev/mcp"]
    }
  }
}

If you want to pass the API key directly:

json
{
  "mcpServers": {
    "venum": {
      "command": "pnpm",
      "args": ["dlx", "@venumdev/mcp"],
      "env": {
        "VENUM_API_KEY": "<your-key>"
      }
    }
  }
}

With a global install:

json
{
  "mcpServers": {
    "venum": {
      "command": "venum-mcp"
    }
  }
}