LikeFolio MCP: consumer demand data for AI agents

LikeFolio measures what everyday consumers buy, download, search, and say, and turns it into daily demand scores on 500+ US stocks. This MCP server puts that data inside Claude, Cursor, VS Code, ChatGPT, or any MCP client as native tools: Main Street (measured consumer demand) vs Wall Street (analyst sentiment), the divergences between them, dated divergence outcomes, and up to a decade of history. Every payload carries as-of dates and citation URLs.

Server URL: https://likefolio.ai/mcp/http (stateless Streamable HTTP) Registry name: ai.likefolio/consumer-demand Docs: likefolio.ai/docs/mcp · Manifest: /.well-known/mcp.json

Get a key

One email at likefolio.ai/developers gets you a free key. No card. Free keys include 2,000 credits per month, 7-day delayed data, and the top-100 coverage universe. Paid tiers add live data, full coverage, deeper history, and the divergence-events log. Tool calls burn the same credits as the REST API: one meter, one rate card (live rate card).

Quickstart

Claude Code

claude mcp add --transport http likefolio https://likefolio.ai/mcp/http \
  --header "X-API-Key: lf_your_key"

claude.ai / Claude Desktop: Settings → Connectors → Add custom connector:

https://likefolio.ai/mcp/http?api_key=lf_your_key

(The custom-connector form has no header field, so the key rides in the URL there.)

Cursor (~/.cursor/mcp.json)

{"mcpServers": {"likefolio": {
    "url": "https://likefolio.ai/mcp/http",
    "headers": {"X-API-Key": "${env:LIKEFOLIO_API_KEY}"}}}}

VS Code (.vscode/mcp.json)

{"inputs": [{"type": "promptString", "id": "likefolio-key",
             "description": "LikeFolio API key", "password": true}],
 "servers": {"likefolio": {
    "type": "http", "url": "https://likefolio.ai/mcp/http",
    "headers": {"X-API-Key": "${input:likefolio-key}"}}}}

Any other client

{"mcpServers": {"likefolio": {
    "url": "https://likefolio.ai/mcp/http",
    "headers": {"X-API-Key": "lf_your_key"}}}}

Tools

Tool	What it returns	Credits
get_scores	Latest Main Street, Wall Street, LikeFolio Score, and divergence gap for one ticker, with as-of date and citation URL	1
get_score_history	Daily score history with per-row provenance flags; depth grows with tier	5
screen_stocks	The covered universe ranked by LikeFolio Score, with all three scores per row	5
get_divergences	Today's widest consumer-vs-analyst gaps, ranked, with percentile and days-at-extreme	5
get_divergence_events	Dated divergence-extreme onsets with realized forward returns, wins and losses both (Quant tier)	10
get_upcoming_earnings	Covered names reporting in the next N days with current demand reads	2
get_track_record	LikeFolio's public closed model-portfolio record: totals, win rate, average return	1
get_dataset_info	Machine-readable dataset dictionary: fields, coverage, history depth, vintages, restatement policy	free

All tools are read-only and idempotent. Rejected calls charge zero credits: tier 403s, malformed-parameter 400s, and coverage fences all bill nothing.

Provenance and citations

Every payload carries as_of dates and a citation_url. Agents should cite both. Score history rows carry provenance flags (estimated=true marks model-backfilled rows), and get_dataset_info documents point-in-time vintages and the restatement policy. Call it first to understand the data before analysis.

Troubleshooting

• Initialize works, tool calls 401. Some clients have dropped custom headers on follow-up POSTs. Authenticate in the URL instead with ?api_key=lf_your_key, and rotate the key from likefolio.ai/console if it ever leaks.
• GET /mcp/http returns 405. Expected: the server is stateless Streamable HTTP. Clients speak POST.
• 403 on get_divergence_events. That tool needs a Quant-tier key. The rejection charges zero credits.

Links

Developer portal · API docs · MCP guide · For models: llms.txt · Privacy · Terms

License

This repository (manifests and docs) is MIT licensed. The data served by the API is licensed separately; see likefolio.ai/developers.