For agents

MRR Ledger is built to be read by machines. Free, CC BY 4.0, no key needed for the static endpoints.

Endpoints

`GET /api/v1/businesses.json`	All businesses with sourced metrics
`GET /api/v1/businesses/{slug}.json`	One business
`GET /api/v1/leaderboard.json`	Ranked by annualized revenue
`GET /api/v1/leaderboard.csv`	Same ranking as CSV (one row per ranked business: headline label, raw value_usd and value_text, basis, as_of, source_url, profile_url). Opens in Sheets/Excel/pandas.
`GET /api/v1/categories.json`	Category insights: id/slug, label, count, ranked_count, median_annualized_usd (among ranked), median_annualized_by_tier, members[{slug,name,rank,annualized_revenue_usd,url_profile}], method. Leaderboard deep-link `/leaderboard/?category=<slug>`. MCP `list_categories` / `get_category`.
`GET /api/v1/tags.json`	Tag insights: slug, label, count, ranked_count, median_annualized_usd (among ranked), median_annualized_by_tier, members[{slug,name,rank,annualized_revenue_usd,url_profile}], method. Sorted by count desc then label. HTML /tags/ shows count≥2 only. Leaderboard deep-link `/leaderboard/?tag=<slug>`. MCP `list_tags` / `get_tag`.
`GET /api/v1/feature.json`	Today's featured business
`GET /api/v1/features.json`	14-day feature rotation (entries, card_url, is_today)
`GET /api/v1/stats.json`	Hub totals: businesses, chartable, lessons, tiers/categories, stale counts, median annualized by tier and by category, revenue_disclosed_count / revenue_undisclosed_count, agent_native_count / agent_added_count
`GET /badge/{slug}.svg`	Embeddable 20px SVG badge: rank + raw headline metric (marks reported / last synced). `/badge/{slug}-plain.svg` = "listed", no number. URLs also on each record as `badge_url` / `badge_plain_url`.
`GET /api/v1/newsletter.json`	This week's issue: feature, new businesses, number moves, indie corner, lesson, upcoming, and paste-ready markdown
`GET /api/v1/growth.json`	Businesses with multi-point growth series
`GET /api/v1/growth.csv`	Every growth_series point as CSV (slug, as_of, label, value_usd, annualized_usd, basis, confidence, source_url, profile_url, growth_json_url). Free under CC BY 4.0. Full all-metrics history CSV stays Pro.
`GET /api/v1/growth/{slug}.json`	Dated annualized revenue points for one business
`GET /api/v1/lessons.json`	Every lesson, attributed, with keyword-tagged themes (rules included)
`GET /api/v1/insights.json`	Pricing-model buckets with medians, and time to $100M (with sources and method)
`GET /api/v1/sources.json`	Every cited source, which businesses use it, and its last automated link check
`GET /api/v1/changes.json`	Dated change log: businesses added, new sourced points, revisions (newest first)
`GET /api/v1/pricing.json`	Plans and access tiers (only Free is live)
`GET /api/v1/compare.json?a=&b=`	Compare two businesses by slug (briefs + diff). Needs the Vercel compare function; also MCP `compare_businesses`
`GET /api/v1/search.json` · `?q=&category=&tier=&verified_only=&limit=`	Substring search over name, slug, one_liner, tags, lessons. `verified_only=true` keeps only businesses whose headline figure is payment-processor verified (`headline_verification` not null). Static file = full index; query params need the Vercel search function. MCP `search_businesses` covers the same job for agents.
`/openapi.json`	OpenAPI 3.1 spec
`/llms.txt`, `/llms-full.txt`	LLM-friendly summaries
`/playbook/`	Human page: lessons library, pricing models, time to $100M
`/compare/`	Human page: side-by-side compare (?a=&b= deep links)
`/features/`	Human page: 14-day featured rotation archive
`/mcp`	MCP server (Streamable HTTP, no key). Canonical endpoint: `https://mrrledger.com/mcp` (POST JSON-RPC, answered directly; `/mcp/` also works). Tools (all read-only, annotated `readOnlyHint`): search_businesses, get_business, leaderboard, todays_feature, get_growth, search_lessons, whats_new, compare_businesses, hub_stats, list_categories, list_tags, get_tag, get_category. Resources: `mrrledger://llms.txt`, `mrrledger://leaderboard`, `mrrledger://stats`, `mrrledger://changes`
`/.well-known/mcp-server.json`	MCP Registry manifest (`server.json` format) for registries and clients

Field notes

tier (venture, indie, experiment): Tier is about funding, not size: Venture-backed = raised outside venture money (even at under $1M annualized); Indie = bootstrapped or founder-funded; Experiment = agent-run or research project.
confidence: "reported" = press-reported, not company-confirmed (amber reported pill); "self-reported" = stated by the company itself (release, founder post), not independently verified (dashed self-reported pill).
headline_verification (records, leaderboard, search and MCP briefs): how the ranked figure itself is verified, {method: "payment-processor", processor, via} when it comes from a payment-connected source (e.g. TrustMRR via Stripe), else null. Use verified_only=true on /api/v1/search.json or MCP search_businesses/leaderboard to keep only those.
verified_corroboration: when the headline is self-reported or press-reported and a payment-verified point (e.g. a TrustMRR Stripe or Paddle snapshot) also exists, this object carries it (label, value_usd, annualized_usd, as_of, source_url, source_name, source_sync_stale_since, verification). Shown as a muted "Stripe-verified …" / "Paddle-verified …" line under the headline on the leaderboard and profile. Null otherwise.
source_sync_stale_since (YYYY-MM-DD, on metrics and on each record's headline): the source page says its live data connection stopped (e.g. an expired Stripe key on TrustMRR). The value is the last synced figure; treat it as dated that day. Also listed in sources.json summary.source_sync_stale.
ownership / independent: ownership appears only when a business was acquired ({status: "acquired", acquirer, as_of, source_url}); independent is then false. Tier still describes pre-sale funding, so a bootstrapped company sold for cash stays indie. Acquired rows show a purple acquired pill, are skipped in the newsletter indie corner and the home indie grid, and are left out of stats.json median_annualized_indie_independent.
last_ownership_check (YYYY-MM-DD or null): date of the latest active ownership search recorded in data/ownership_checks.json (verdict independent / acquired / watch). Present only when we have searched; unchecked rows stay null — never invented. Profiles with a ledger entry show a muted "Ownership checked YYYY-MM-DD" line.
ownership_watch: present only when the ownership ledger verdict is watch ({verdict, checked, note, source_url?}) — sale process or for-sale signal, no closed deal. Amber watch pill on profile + leaderboard; never invents acquisitions.
agentic_origin (optional string): agent-native = product is agents / an agent platform from the start; agent-added = established product that later added agents or MCP (amber agent-added pill on profile + leaderboard); unclear or omitted when not confident. Leaderboard filter ?origin=native / ?origin=added. stats.json has agent_native_count and agent_added_count.
revenue_disclosed (boolean): true iff the business has a rankable sourced annualized revenue figure (ARR / MRR×12 / Revenue with value_usd — same rule as leaderboard membership / annualized_revenue_usd). Funding or valuation alone is false. Leaderboard filter ?rev=disclosed / checkbox Revenue disclosed only; profiles and category cards show a muted no revenue figure pill when false. stats.json has revenue_disclosed_count and revenue_undisclosed_count.
older_figure / age_days: on each record and on each leaderboard row, older_figure is true when the headline revenue metric is over 365 days old and not superseded; age_days is build date minus as_of (month precision = mid-month). Same rule as the gray revenue >12 mo old pill. Leaderboard filter ?age=fresh / checkbox Fresh revenue only keeps only rows with disclosed revenue dated within 365 days. Also on each metric and in leaderboard.csv.
related (array, on each business record): up to 4 similar businesses scored by same category, shared tags, and nearby annualized scale. Each entry has compare_url for the side-by-side page. Profiles show the same list under "Similar on the ledger".

Free: leaderboard CSV + growth-series CSV (chartable points only). Pro (planned): full all-metrics history CSV, denser history, alerts and webhooks. Higher rate limits on Agent API.