# Connect HyperDD to your agent

HyperDD serves two read-only MCP tools at `https://hyperdd.com/mcp`: `list_ideas` and `get_memo`. The ten selected ticker memos are free. Other memos and the ideas list require an active subscription.

## Connect

For free memos, register the endpoint without a token. To unlock more research, [sign in with Google](https://hyperdd.com/subscribe), subscribe through Stripe, then create an agent key on your [account page](https://hyperdd.com/account). Put it in the `HYPERDD_TOKEN` environment of your client process. If you lose it, sign in again to revoke it and create another. Do not paste keys into shared files or logs. Inspect an existing `hyperdd` registration before changing it.

Codex free setup:

```sh
codex mcp add hyperdd --url https://hyperdd.com/mcp
```

Codex paid setup, after inspecting and replacing an existing entry:

```sh
codex mcp add hyperdd --url https://hyperdd.com/mcp \
  --bearer-token-env-var HYPERDD_TOKEN
```

Claude Code free setup:

```sh
claude mcp add --transport http hyperdd https://hyperdd.com/mcp
```

For paid access add `--header "Authorization: Bearer $HYPERDD_TOKEN"` to the Claude command. Claude stores the header in local configuration; protect that file. GUI clients need the key in their own launch environment. Static bearer authentication is not OAuth. If needed, set `tool_timeout_sec = 120` in the existing Codex entry without replacing unrelated configuration.

## Install the companion skill

[Download SKILL.md](https://hyperdd.com/skills/hyperdd/SKILL.md). Review it before placing it at `.agents/skills/hyperdd/SKILL.md` for Codex or `.claude/skills/hyperdd/SKILL.md` for Claude Code. Reload skill discovery. Installing a skill does not register the MCP server.

## Verify

`tools/list` returns only `list_ideas` and `get_memo` without a token. A direct check is:

```sh
curl --fail --max-time 120 https://hyperdd.com/mcp \
  -H 'Content-Type: application/json' -H 'Accept: application/json' \
  -H 'MCP-Protocol-Version: 2026-07-28' -H 'Mcp-Method: tools/list' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

A paid tool call without an active subscriber key returns a tool error with a subscribe URL. JSON-RPC `-32602` means an invalid tool name or argument. Operational CPE tools are unavailable through HyperDD even when named directly.

## Tool results

`list_ideas(limit?, cursor?, revision?)` requires a subscription and returns `publication_revision`, `ideas`, and `next_cursor`. Continue with the same revision.

`get_memo(ticker, start?, max_chars?, revision?)` returns retained memo text, `publication_revision`, `evidence_status`, `total_chars`, and `next_start`. AAPL, MSFT, AMZN, GOOGL, META, NVDA, TSLA, SNDK, MU, and TSM are free; GOOG maps to GOOGL. SNDK is eligible for free access but currently has no published memo. Other tickers require a subscription. Follow `next_start` with the same revision. A missing ticker returns `has_page: false`.

Research may be older than today's market or source corpus. Idea source markers may refer to different company memos and are not resolved links. Results enter the host agent's context. No portfolio records or source-download URLs are exposed.