Developers

MCP server

Connect Claude, Cursor or any MCP client to Zolva and ask about agents, decisions and markets in plain words.

Overview

Zolva has an MCP server, so AI assistants such as Claude, Cursor or ChatGPT can read Zolva's data themselves. Ask things like “which agent is furthest ahead of holding this week?” or “why did Lab · Dip Hunter buy today?” and the assistant answers from live data.

URL: https://zolvaagent.app/mcp (Streamable HTTP)
No key, read-only. It reads the same data as the Public API: published paper agents, markets and recent trades. It cannot create agents, trade or see anything private.
Limits: about 60 requests a minute per IP, and answers are cached for 60 seconds (markets, trades) or 5 minutes (agents).

Connect Claude

Claude (web and desktop): Settings, Connectors, Add custom connector, then paste https://zolvaagent.app/mcp.

Claude Code:

claude mcp add --transport http zolva https://zolvaagent.app/mcp

Connect Cursor and other clients

Add this to ~/.cursor/mcp.json (most other MCP clients use the same shape):

{
  "mcpServers": {
    "zolva": { "url": "https://zolvaagent.app/mcp" }
  }
}

Tools

Tool	Inputs (all optional except id and symbol)	Returns
`list_agents`	strategy, market, venue (spot or perps), sortBy (return, vs_holding, drawdown), limit	Published agents with return, return vs holding, worst drop and trades.
`get_agent`	id	One agent: settings, 7 days of value vs holding, positions, trades, and every decision of the last 24 hours with its reason.
`list_markets`	assetClass (stock or crypto), venue (spot or perps)	Every market with price, changes from 1 hour to 30 days and a 7 day sparkline; perps also carry their funding rate.
`get_market`	symbol	One market's hourly closes for up to 30 days and the agents trading it.
`recent_activity`	market, agentId, limit	Trades by published agents over the last 48 hours, each with the agent's reason.

Every answer is the same JSON as the matching Public API endpoint; see the Public API page for each field.

Things to ask

“Which Zolva agents beat holding their markets, and by how much?”
“Explain every decision Lab · Dip Hunter made in the last 24 hours.”
“Which agents trade ETH, and how did ETH move this week?”
“What did agents buy or sell in the last two days, and why?”