Meridian MCP

Meteora DLMM LP agent tools as an MCP server for Claude Code, Gemini CLI, or any MCP-compatible AI assistant.

Instead of the AI guessing — it uses your live wallet, real pool data, and actual Meteora SDK to deploy positions, check PnL, close positions, and more.

What you can do

Once set up, just talk to Claude Code naturally:

• "What are my current positions and their PnL?"
• "Deploy 0.5 SOL into the best meme pool right now"
• "Close the CHIBI-SOL position and swap to SOL"
• "Check holders and narrative for this token: [mint]"
• "What pools are trending right now?"
• "Change my take profit to 15%"

Prerequisites

• Node.js 18+
• A Solana wallet private key (base58)
• Helius API key — helius.dev (free tier works)
• OpenRouter API key — openrouter.ai (only needed for --with-crons)

Installation

Step 1 — Run the setup wizard

npx meridian-mcp init

This will ask for:

• Wallet private key — base58 encoded (the same one your agent uses)
• OpenRouter API key — skip if you're not using cron jobs
• Helius API key — used for RPC calls
• Solana RPC URL — leave blank to auto-use Helius

Config is saved to ~/.meridian/ on your machine.

Step 2 — Add to Claude Code

Open or create ~/.claude/settings.json and add:

{
  "mcpServers": {
    "meridian": {
      "command": "npx",
      "args": ["meridian-mcp"]
    }
  }
}

Step 3 — Restart Claude Code

Close and reopen Claude Code. You should see a 🔧 tool indicator showing Meridian tools are available.

That's it — start chatting.

Optional: Run with cron jobs

If you want autonomous management and screening cycles running alongside the MCP server (replaces running node index.js separately):

{
  "mcpServers": {
    "meridian": {
      "command": "npx",
      "args": ["meridian-mcp", "--with-crons"]
    }
  }
}

Requires OpenRouter API key set during init.

Optional: Dry run mode (no real transactions)

{
  "mcpServers": {
    "meridian": {
      "command": "npx",
      "args": ["meridian-mcp", "--dry-run"]
    }
  }
}

All deploy/close/swap calls will simulate without sending transactions.

Data directory

Everything is stored in ~/.meridian/:

~/.meridian/
  .env                  # wallet key, API keys
  user-config.json      # your settings (deploy amount, models, thresholds)
  lessons.json          # agent lessons
  pool-memory.json      # pool history
  state.json            # position state
  smart-wallets.json    # tracked wallets
  strategy-library.json # LP strategies
  token-blacklist.json  # blacklisted tokens

Override location with env var: MERIDIAN_DATA_DIR=/custom/path npx meridian-mcp

Gemini CLI

Same setup — add to your Gemini CLI MCP config:

{
  "mcpServers": {
    "meridian": {
      "command": "npx",
      "args": ["meridian-mcp"]
    }
  }
}

Troubleshooting

Tools not showing in Claude Code

• Make sure settings.json is valid JSON (no trailing commas)
• Restart Claude Code fully after editing

"Cannot find module" error

• Run npx meridian-mcp init first to ensure setup is complete
• Make sure Node.js 18+ is installed: node --version

Transaction errors

• Check your wallet has enough SOL for gas
• Verify your RPC URL is working
• Try --dry-run to test without real transactions

"Wallet private key not found"

• Run npx meridian-mcp init again
• Check ~/.meridian/.env exists and has WALLET_PRIVATE_KEY=...

Security

• Your wallet private key is stored locally in ~/.meridian/.env — never shared
• The MCP server runs locally on your machine — no remote servers involved
• Use --dry-run to test before committing real funds