# HyperDD — research ideas and company memos

> Two read-only MCP tools: `list_ideas` for retained themes, and `get_memo` for a published memo by ticker. Ten selected company memos are free; other memos and the ideas list require a subscription. Responses identify the publication revision.

MCP endpoint: https://hyperdd.com/mcp
Transport: stateless JSON-RPC over HTTP POST.
Authentication: none for the free ten; subscribers sign in with Google, pay through Stripe, and create a bearer key on their account page.

## Set up your agent

1. Read and install the [HyperDD companion skill](https://hyperdd.com/skills/hyperdd/SKILL.md).
2. Register the [MCP endpoint](https://hyperdd.com/mcp.md). No token is needed for free memos. [Subscribe](https://hyperdd.com/subscribe) for other symbols and ideas.
3. Verify `tools/list` returns only `list_ideas` and `get_memo`.

The skill and MCP connection are separate. The [copyable setup prompt](https://hyperdd.com/guide) provides a short agent handoff.

## Tools

- `list_ideas(limit?, cursor?, revision?)`: subscriber-only paginated idea and theme summaries. Limit defaults to 25, maximum 50. Continue with `next_cursor` and the same `publication_revision`.
- `get_memo(ticker, start?, max_chars?, revision?)`: bounded memo text for one ticker. AAPL, MSFT, AMZN, GOOGL, META, NVDA, TSLA, SNDK, MU, and TSM are free; GOOG resolves to GOOGL. Other tickers need an active subscription. Start defaults to 0; max_chars defaults to 12000, maximum 64000. Continue with `next_start` and the same `publication_revision`. An unknown ticker reports `has_page: false`.

These are retained research publications, not live market data or investment advice. An unavailable publication is explicit; do not invent missing ideas, memo text, or portfolio holdings.