explaingit

marketcaper/mcp

Analysis updated 2026-05-18

★ 94Audience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A public MCP server that gives AI agents live finance data: asset snapshots, cross-asset comparisons, and hosted stock heatmap images, each with a source citation.

Mindmap

mindmap
  root((Marketcaper MCP))
    What it does
      Live asset data
      Cross asset comparisons
      Cited sources
      Heatmap images
    Tech stack
      MCP protocol
      Hosted API
    Use cases
      Finance bots
      Newsletters
      Research assistants
    Audience
      Bot builders
      Content creators
    Limits
      Rate limited
      No trading data

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate a cited Bitcoin vs Ethereum comparison for a social post.

USE CASE 2

Build a Telegram or Discord bot reply with sourced market data.

USE CASE 3

Add a stock heatmap image to a newsletter's markets section.

USE CASE 4

Answer cross-market size questions without relying on stale model memory.

What is it built with?

MCP

How does it compare?

marketcaper/mcpai272/speakeraisparkedu/knowledge-base
Stars949494
Language—Python—
Setup difficultyeasymoderateeasy
Complexity2/52/51/5
Audiencedeveloperpm foundergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Just point an MCP-compatible client at the hosted endpoint, no local install needed.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Marketcaper MCP is a server that gives AI agents access to live finance data, built to plug into tools like Claude, Cursor, Codex, and other MCP-compatible clients. Instead of relying on a language model's outdated training data, an AI agent can call this server to get current asset prices, cross-asset comparisons, and even ready-made images like stock heatmaps. The project exposes four main tools: one that looks up a single asset and its current size context, one that compares two assets side by side, one that builds a full comparison pack with short copy and citations, and one that returns a stock heatmap along with an optional hosted image. Every piece of data comes with a source link, and the project asks that anyone using its output in generated content credit that source. It is aimed at people building things like social-content bots, Telegram or Discord finance bots, newsletters, research assistants, and coding assistants that need to mention real, current market figures. For example, a bot could use it to post a comparison of Bitcoin versus Ethereum with a citation attached, or a newsletter could pull in a heatmap image for its markets section. The README is clear about what this is not: it is not a trading system, not an investment adviser, not a portfolio tracker, not a technical-analysis feed, and not a bulk data extraction tool. It should not be used to scrape every asset at once, automate trades, or run high-frequency workflows. No API key is needed to use the public, read-only MCP endpoint, though there are limits: 60 tool calls per minute per IP address, and 10 hosted images per day per IP address. Heatmap images are generated on demand and are dark-themed only, and fetching one can take up to about 20 seconds. Setup is a matter of pointing an MCP-compatible client, such as Cursor or Codex, at the hosted endpoint URL, no local installation or server hosting is required. The project is released under the MIT license, so it can be used freely, including for commercial purposes.

Copy-paste prompts

Prompt 1
Connect to the Marketcaper MCP server and get a cited comparison of BTC vs ETH.
Prompt 2
Use the get_stock_heatmap tool to fetch a US market cap heatmap image.
Prompt 3
Set up Marketcaper MCP in my Cursor mcp.json and test the get_asset_snapshot tool.
Prompt 4
Build a Telegram bot reply using compare_assets_pack for NVDA vs AAPL.

Frequently asked questions

What is mcp?

A public MCP server that gives AI agents live finance data: asset snapshots, cross-asset comparisons, and hosted stock heatmap images, each with a source citation.

What license does mcp use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is mcp to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is mcp for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

Alternatives & similar repos