Skip to main content
Glama
Merkl MCP Server

Merkl MCP Server

by domechn

Merkl MCP Server

An MCP server exposing Merkl Opportunities endpoints using @modelcontextprotocol/sdk.

Setup

  • Node.js 18+ recommended

  • Install deps

npm install

Optionally set environment variables:

  • MERKL_BASE_URL (default: https://api.merkl.xyz)

  • MERKL_API_KEY (Bearer token if you have one; public endpoints work without it)

Related MCP server: polskidegen-hl-tracker

Run (local)

  • Dev server:

npm run dev
  • Start once:

npm run build
npm start
  • Smoke test (direct HTTP call, not MCP):

npm run smoke

Tools exposed

  • opportunities-search

  • opportunities-get

  • opportunities-campaigns

  • opportunities-count

  • opportunities-bins-apr

  • opportunities-bins-tvl

  • opportunities-aggregate

  • opportunities-aggregate-max

  • opportunities-aggregate-min

Use with an MCP-compatible client

This server uses the stdio transport. Point your MCP client to run the command and read/write on stdio:

  • Command:

npx merkl-mcp
  • Or locally via repo:

npm start

Set env vars as needed (e.g. MERKL_API_KEY). The server will register tools listed above.

Note: Requires Node 18+. Enable debug logs by setting MERKL_DEBUG=1.

One-line npx startup

After publishing as merkl-mcp to npm (or using npm link), you can start the server with:

npx merkl-mcp

If dist/server.js is missing, the CLI will build automatically on first run.

Connect to Claude Desktop (macOS)

Claude Desktop supports MCP over stdio. Add this server to Claude's config and restart the app.

  1. Create or edit config file

  • Path: ~/Library/Application Support/Claude/claude_desktop_config.json

  1. Use the published package (one-line npx)

{
  "mcpServers": {
    "merkl": {
      "command": "npx",
      "args": ["-y", "merkl-mcp"],
      "env": {
        "MERKL_API_KEY": "(Optional) YOUR_API_KEY_OR_REMOVE_IF_UNUSED"
      }
    }
  }
}
  1. Or run from local repo

{
  "mcpServers": {
    "merkl": {
      "command": "node",
      "args": ["dist/src/server.js"],
      "cwd": "./merkl-mcp",
      "env": {
        "MERKL_API_KEY": "(Optional) YOUR_API_KEY_OR_REMOVE_IF_UNUSED"
      }
    }
  }
}
  1. Restart Claude Desktop

  • Start a new chat; the tool named merkl should appear in the Tools list.

Troubleshooting

  • Ensure Node.js 18+ is installed and available to Claude's environment.

  • Remove MERKL_API_KEY if you don't have one; public endpoints work without it.

  • Check Claude logs if tools don't appear; verify the config file path and JSON syntax.

Publish to npm

Set the name in package.json (already set up for you via bin aliases) and publish:

npm login   # if not already
npm publish --access public

Then users can run:

npx merkl-mcp
# or the short alias
npx merkl-mcp

Available Tools

13 tools
campaigns-countCount CampaignsC

GET /v4/campaigns/count

Inputs: name, tags, test, type, +27 more. Returns: count

campaigns-getGet CampaignD

GET /v4/campaigns/{id}

Inputs: id (required), test, point, tokenTypes, +1 more. Returns: campaign

get-current-timestampGet Current TimestampC

Retrieves the current timestamp.

Inputs: no named parameters. Returns: timestamp

opportunities-aggregateAggregate FieldD

GET /v4/opportunities/aggregate/{field}

Inputs: field (required), name, tags, test, +23 more. Returns: buckets

opportunities-aggregate-maxAggregate MaxD

GET /v4/opportunities/aggregate/max/{field}

Inputs: field (required), name, tags, test, +23 more. Returns: value

opportunities-aggregate-minAggregate MinD

GET /v4/opportunities/aggregate/min/{field}

Inputs: field (required), name, tags, test, +23 more. Returns: value

opportunities-bins-aprAPR BinsC

GET /v4/opportunities/bins/apr

Inputs: name, tags, test, type, +21 more. Returns: bins

opportunities-bins-tvlTVL BinsD

GET /v4/opportunities/bins/tvl

Inputs: name, tags, test, type, +21 more. Returns: bins

opportunities-campaignsOpportunity CampaignsD

GET /v4/opportunities/{id}/campaigns

Inputs: id (required), test, point, campaigns, +2 more. Returns: opportunity

opportunities-countCount OpportunitiesC

GET /v4/opportunities/count

Inputs: name, tags, test, type, +22 more. Returns: count

opportunities-getGet OpportunityD

GET /v4/opportunities/{id}

Inputs: id (required), test, point, campaigns, +2 more. Returns: opportunity

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.6/5.0

    Scored across 13 tools

    Disambiguation4/5

    Most tools are clearly separated by resource (campaigns vs opportunities) and action (search, get, count). The aggregate/max/min family is slightly overlapping in purpose, and get-current-timestamp is unrelated to the domain, but an agent can still distinguish the primary operations.

    Naming Consistency4/5

    The set uses kebab-case consistently and mostly follows a predictable resource-action or resource-subresource-action pattern. The main deviation is get-current-timestamp, which reverses the verb-noun ordering used elsewhere.

    Tool Count5/5

    With 13 tools, the server is well-scoped for a read-only API surface covering campaigns and opportunities. Each tool maps to a distinct query capability without excessive bloat.

    Completeness4/5

    The surface covers search, get, count, aggregation, and bin queries for opportunities, plus search/get/count for campaigns. It appears complete for a read-only API, though a few less-common query endpoints may still be missing.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server that exposes unified AI-friendly tools over Messari's standardized lending subgraphs on The Graph. One natural-language query → fan out across 40+ lending protocols on multiple chains → get back structured, comparable data.
      19
      9 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for Hyperliquid that provides read-only on-chain wallet analytics. Enables natural-language queries about positions, fills, funding, and realized PnL for any public address.
      8
      33 npm
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Universal MCP server for Mantle yield data, enabling users to fetch health status, dashboard summaries, and detailed opportunity information through natural language.
      7
      -
    • A
      license
      B
      quality
      D
      maintenance
      MCP server to query Polymarket prediction market data via The Graph subgraphs and REST APIs, enabling AI agents to search markets, get live prices, order books, on-chain analytics, and trader profiles.
      32
      MIT