Give your AI agent fresh market data and something worth posting.
Connect Marketcaper to OpenClaw, Hermes, ChatGPT, Claude, or any MCP-compatible agent. Create cited market comparisons, daily stock heatmaps, and ready-to-publish financial content with shareable images.
Marketcaper is the market-data and visual-content layer for agents. It supplies facts, comparisons, images, and citations; your agent decides what to create or publish.
From one tool call to cited finance content
These are the workflows Marketcaper MCP is designed to power first.
Turn market questions into posts
Ask for BTC vs ETH, NVIDIA vs Apple, or XRP at Bitcoin size and receive cited text, canonical URLs, and share-ready PNGs.
Answer finance communities with sources
Let community bots answer what-if price questions, market-cap comparisons, and sector heatmap requests without guessing from stale model memory.
Generate visual market recaps
Create daily opening summaries, weekly heatmap recaps, and comparison-of-the-week sections with images ready for email or Substack.
Connect the same endpoint to the clients your agents already use
Use one public read-only MCP endpoint across agent platforms and developer tools.
Register the remote MCP endpoint and let an agent build finance content workflows.
Setup docsUse Marketcaper inside scheduled agents for market cards, Telegram drafts, and research prompts.
Setup docsDrop the endpoint into mcp.json for cited finance data while building or researching.
Add the remote MCP server and use it when tasks need current comparison context.
Cited financial content, not another bulk data API
Marketcaper MCP stays focused on the output agents need: facts, visuals, links, and attribution.
Current snapshots, not model memory
Agents can resolve assets, compare live sizes, and cite canonical Marketcaper pages instead of relying on outdated training data.
Images built into the workflow
Comparison and heatmap tools can return hosted PNG image URLs, so content agents can publish something visual, not just a paragraph.
Source links travel with the answer
Responses include source_url, canonical_url, and citation_text so every generated post, bot reply, or newsletter card stays traceable.
Not a bulk market-data feed
Marketcaper MCP is for snapshots, comparisons, heatmaps, and cited content workflows, not trading, backtesting, or bulk extraction.
Use these URLs in agents, registries, and docs
These are the canonical Marketcaper MCP and discovery URLs.
Public pair pages are readable HTML
If an AI client can fetch a URL but cannot use MCP, valid Marketcaper pair pages still expose the comparison directly.
source_url, canonical_url, citation_text, and hosted image metadata.image_url in the same structured contract.Current heatmap images for agents
Use get_stock_heatmap when an AI client needs a current market or sector heatmap image. It returns a capped summary plus a hosted PNG, not a bulk stock feed.
get_stock_heatmap
Required input is view: choose classic for the sector tile map or bubble for the bubble heatmap.
Use universe: "global" for global top stocks.
Heatmap MCP images are dark theme only, so exports stay consistent with manual dark heatmap screenshots.
{
"view": "classic",
"universe": "us",
"metric": "marketCap",
"timeframe": "1D",
"category": "Financial Services",
"response_format": "json"
}Four focused tools for cited content workflows
The MCP API stays narrow and stable: snapshots, comparisons, automation packs, and stock heatmap images.
Get asset snapshot
Resolve one Marketcaper asset and return its live market cap snapshot. Always cite the returned source_url when using the data.
Compare assets
Compare two Marketcaper assets and return the live what-if market cap scenario, canonical pair URL, and optional hosted image URL. Hosted images are PNG, generated on demand, share a 10 images/day/IP limit, and may require a longer timeout than the MCP JSON call. Always cite the returned source_url when using the data.
Compare assets pack
Compare two Marketcaper assets and return the same cited comparison data plus a ready-to-publish short post and share payload with the hosted comparison image URL. Always cite the returned source_url when using the data.
Get stock heatmap
Return a current Marketcaper stock heatmap summary plus a hosted dark-theme PNG image URL. Supports US or global universes, classic or bubble views, optional sector/category filtering, and capped summary rows. Hosted images share a 10 images/day/IP limit. This is not a bulk feed extraction tool.
Citations are part of the product
Every response points back to a canonical Marketcaper page so comparisons are easy to source and verify.
Share-ready hosted images
When comparison or heatmap tools include a hosted image URL, the response points to a public PNG export.
get_asset_snapshot
Single-asset lookups return the resolved asset identity plus a specific Marketcaper source URL you can cite.
{
"asset": "btc",
"response_format": "json"
}{
"asset": {
"slug": "btc",
"symbol": "BTC",
"name": "Bitcoin",
"category": "crypto",
"basis_label": "Market Cap"
},
"source_name": "Marketcaper.com",
"source_url": "https://marketcaper.com/btc",
"canonical_url": "https://marketcaper.com/btc",
"citation_text": "Data from https://marketcaper.com/btc"
}compare_assets
Pair comparisons return the canonical pair page, what-if pricing context, citation fields, and an optional hosted PNG image with explicit metadata.
{
"asset_a": "btc",
"asset_b": "eth",
"include_image": true,
"response_format": "json"
}{
"title": "Bitcoin vs Ethereum Market Cap Comparison",
"comparison_type": "price-comparison",
"price_at_target_market_cap": 12653,
"price_if": 12653,
"asset_a_name": "Bitcoin",
"asset_b_name": "Ethereum",
"source_name": "Marketcaper.com",
"source_url": "https://marketcaper.com/btc/eth",
"canonical_url": "https://marketcaper.com/btc/eth",
"image_url": "https://marketcaper.com/api/mcp/images/btc/eth",
"image": {
"url": "https://marketcaper.com/api/mcp/images/btc/eth",
"format": "png",
"mime_type": "image/png",
"width": 1380,
"height": 840,
"generation_mode": "on_demand",
"timeout_seconds_recommended": 20
},
"citation_text": "Data from https://marketcaper.com/btc/eth"
}compare_assets_pack
This agent-friendly tool keeps cited comparison data and adds a ready-to-publish short post plus a share payload.
{
"asset_a": "icp",
"asset_b": "orcl",
"response_format": "json"
}{
"title": "Internet Computer vs Oracle Market Cap Comparison",
"comparison_type": "price-comparison",
"price_at_target_market_cap": 2059.45,
"price_if": 2059.45,
"asset_a_name": "Internet Computer",
"asset_b_name": "Oracle Corporation",
"source_name": "Marketcaper.com",
"source_url": "https://marketcaper.com/icp/orcl",
"canonical_url": "https://marketcaper.com/icp/orcl",
"image_url": "https://marketcaper.com/api/mcp/images/icp/orcl",
"image": {
"url": "https://marketcaper.com/api/mcp/images/icp/orcl",
"format": "png",
"mime_type": "image/png",
"width": 1380,
"height": 840,
"generation_mode": "on_demand",
"timeout_seconds_recommended": 20
},
"short_post": "If ICP matched the market cap of Oracle Corporation, it would be $2,059. Source: https://marketcaper.com/icp/orcl",
"share_payload": {
"text": "If ICP matched the market cap of Oracle Corporation, it would be $2,059. Source: https://marketcaper.com/icp/orcl",
"url": "https://marketcaper.com/icp/orcl",
"image_url": "https://marketcaper.com/api/mcp/images/icp/orcl"
},
"citation_text": "Data from https://marketcaper.com/icp/orcl"
}Connect major AI clients
Use the same Marketcaper endpoint everywhere. Some clients use JSON config files, while others use a UI or one-line CLI command.
Manual custom connector
Add a custom MCP connector and use this server URL:
https://marketcaper.com/api/mcpOfficial setup references: OpenAI MCP docs and full MCP connectors in ChatGPT.
Claude CLI / Anthropic Messages API
claude mcp add --transport http marketcaper https://marketcaper.com/api/mcpFor Claude artifacts and direct Messages API use, point to https://marketcaper.com/api/mcp and pass response_format: "json" when you want deterministic parser-friendly output.
fetch("https://api.anthropic.com/v1/messages", {
method: "POST",
headers: {
"Content-Type": "application/json",
"x-api-key": "YOUR_ANTHROPIC_API_KEY",
"anthropic-version": "2023-06-01",
"anthropic-beta": "mcp-client-2025-04-04"
},
body: JSON.stringify({
model: "claude-sonnet-4-20250514",
max_tokens: 1200,
mcp_servers: [{ type: "url", url: "https://marketcaper.com/api/mcp", name: "marketcaper" }],
messages: [{
role: "user",
content: "Use compare_assets with asset_a="btc", asset_b="eth", include_image=true, response_format="json". Return the tool result JSON."
}]
})
});const toolResult = data.content.find((block) => block.type === "mcp_tool_result");
const parsed = JSON.parse(toolResult.content[0].text);
console.log(parsed.price_if, parsed.source_url, parsed.image?.mime_type, parsed.image?.timeout_seconds_recommended);cursor mcp.json
{
"mcpServers": {
"marketcaper": {
"url": "https://marketcaper.com/api/mcp"
}
}
}mcp.json
{
"servers": {
"marketcaper": {
"type": "http",
"url": "https://marketcaper.com/api/mcp"
}
}
}Add the remote server in one line
codex mcp add marketcaper --url https://marketcaper.com/api/mcpWell-known server card
Registries and scanners can use this JSON document to understand the live Marketcaper MCP server without guessing.
https://marketcaper.com/.well-known/mcp/server-card.json