Merkl MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Merkl MCP Server show me the top opportunities by APR"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Merkl MCP Server
An MCP server exposing Merkl Opportunities endpoints using @modelcontextprotocol/sdk.
Setup
Node.js 18+ recommended
Install deps
npm installOptionally 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 devStart once:
npm run build
npm startSmoke test (direct HTTP call, not MCP):
npm run smokeTools 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-mcpOr locally via repo:
npm startSet 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-mcpIf 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.
Create or edit config file
Path:
~/Library/Application Support/Claude/claude_desktop_config.json
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"
}
}
}
}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"
}
}
}
}Restart Claude Desktop
Start a new chat; the tool named
merklshould appear in the Tools list.
Troubleshooting
Ensure Node.js 18+ is installed and available to Claude's environment.
Remove
MERKL_API_KEYif 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 publicThen users can run:
npx merkl-mcp
# or the short alias
npx merkl-mcpAvailable Tools
13 toolscampaigns-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
campaigns-searchRetrieve Multiple CampaignsC
This endpoint enables you to search for campaigns by providing specific criteria through query parameters.
Inputs: name, page, sort, tags, +22 more. Returns: results
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
opportunities-searchRetrieve Multiple OpportunitiesC
This endpoint enables you to search for opportunities by providing specific criteria through query parameters.
Inputs: name, page, sort, test, +26 more. Returns: results
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for AI agents to discover campaigns by humans and donate USDC directly on Base.
MCP server for Boson Protocol — on-chain agentic commerce for physical & digital goods.
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP 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.199 npm1MIT
- AlicenseAqualityDmaintenanceMCP 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.833 npmMIT
- FlicenseAqualityDmaintenanceUniversal MCP server for Mantle yield data, enabling users to fetch health status, dashboard summaries, and detailed opportunity information through natural language.7-
- AlicenseBqualityDmaintenanceMCP 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.32MIT