# Multibagger: Developer API & MCP reference

Programmatic access to Multibagger's growth-stock research: a REST API and an MCP server. Everything a
user can do on the site: per-company scores and analysis (whole or by category; search via MCP), live on-demand
analysis, head-to-head comparison, the Dig Deeper AI analyst, and the full growth-stock list.

Base URL: https://multibagger.app

## Plans and credits

- Single-company access is on the Investor plan; bulk pulls (the full list) and a commercial-use license
  are on the Analyst plan: https://multibagger.app/upgrade
- Read endpoints cost data-credits; analyze / compare / ask charge analysis credits, the same as the site.
- Derived research only; underlying market data (prices, market cap, growth rates) is view-only and is not
  redistributed.

## Authentication

Create a key in your account settings (https://multibagger.app/account): it is shown once. Send it as a
bearer token on every request:

```bash
curl https://multibagger.app/api/v1/list -H "Authorization: Bearer mb_live_xxxxxxxx"
```

Keys carry your access. Keep them secret, and revoke a leaked key from your account.

## REST endpoints

### GET /api/v1/list : (Analyst plan)

The full current growth-stock list: every company with our four scores (MGI = Multibagger Growth Index,
Value, Opportunity, Threat) and the six dimension scores. Add `?format=csv` for CSV. This is the bulk
extract; costs 1 data-credit per company.

### GET /api/v1/research

The index of our published research rankings (the ~100 living lists at multibagger.app/research): slug,
title, lens, member count, median, joined-this-week, and each list's URL. 1 data-credit.

### GET /api/v1/research/{slug}

One research ranking: the ranked members with our scores and each company's qualifying line, this week's
entries and exits, and the intro. Add `?format=text` for a share-ready plain-text block (top 25 with the
attribution link baked in). 1 data-credit per member. Any plan.

### GET /api/v1/company/{symbol}

One company's derived research: the four scores, the six dimensions (score + written note), overview,
competitors, segments, business traits, and our valuation take. Returns `404` if we have not published an
analysis for it yet (run `POST /api/v1/analyze` first). Add `?section=<name>` to pull just one category;
valid sections: `moat`, `runway`, `growth`, `financials`, `management`, `risks`, `valuation`,
`segments`, `competitors`, `overview`, `scores`. 1 data-credit per pull.

### POST /api/v1/analyze

Run the live Dig Deeper six-dimension analysis on any company and get the full result. Body:
`{ "symbol": "NVDA" }`. Metered on your analysis credits, like the site's Analyze.

### POST /api/v1/compare

Head-to-head comparison of two companies. Body: `{ "a": "NVDA", "b": "AMD" }`. BOTH must already be
analyzed; a `409` names the one that is not, so run `/api/v1/analyze` on it first. Analysis credits.

### POST /api/v1/ask

Ask the Dig Deeper AI analyst. Body: `{ "question": "...", "symbol": "NVDA" }`. Include `symbol` for a
company-specific answer (with web search + SEC filings); omit it for a general question. Analysis credits.

### POST /api/v1/report

File a bug or suggestion. Body: `{ "message": "...", "category": "bug" }`. Free.

## MCP server

Connect any MCP client (Claude, agents) to plug our research into your own tools. Streamable HTTP;
authenticate with the same key.

```json
{
  "mcpServers": {
    "multibagger": {
      "url": "https://multibagger.app/api/mcp",
      "headers": { "Authorization": "Bearer mb_live_xxxxxxxx" }
    }
  }
}
```

Tools mirror everything a user can do:

- `search_companies`: search the universe
- `get_company`: one company's research (optional `section`)
- `get_growth_list`: the full list (Analyst plan)
- `list_rankings`: the index of the ~100 research rankings
- `get_ranking`: one ranking's members, scores and weekly changes (optional `format: "text"` for a share-ready block)
- `analyze`: run the live six-dimension analysis
- `compare_companies`: head-to-head
- `ask`: the AI analyst, with optional company context
- `report_bug`: file a bug or suggestion

The action tools (analyze / compare / ask) charge the same credits as the site.

---

Research information only, not investment advice. Our derived research and scores are yours to use under
the terms of your plan and our commercial terms; underlying market data is view-only and is not
redistributed.