# HEY Research Lab
**Category:** ⚖️ Legal
**Repository:** https://github.com/hey-research-lab/hey-research-open
**Views:** 0
**Installs:** 0
**Upvotes:** 0
**Directory Page:** https://allmcps.com/mcp/hey-research-lab
## Description
Evidence-backed Robinhood Chain research: builders, ships, contracts, changes, market context.
## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):
```json
"mcpServers": {
"hey-research-lab": {
"command": "npx",
"args": ["-y","hey-research-lab"]
}
}
```
## Documentation & README
# HEY Research Lab
**Find who's actually building on Robinhood Chain.**
[](https://github.com/hey-research-lab/hey-research-open/actions/workflows/ci.yml)
[](LICENSE)
[](https://nodejs.org)
[](https://www.typescriptlang.org)
[](https://heyresearch.xyz/pulse)
[](https://heyresearch.xyz)
[Site](https://heyresearch.xyz) · [Public API](https://github.com/hey-research-lab/hey-research-open/blob/HEAD/docs/PUBLIC_API.md) · [MCP server](https://github.com/hey-research-lab/hey-research-open/blob/HEAD/docs/MCP.md) · [Sources](https://github.com/hey-research-lab/hey-research-open/blob/HEAD/docs/SOURCE_REGISTRY.md) · [Changelog](https://github.com/hey-research-lab/hey-research-open/blob/HEAD/CHANGELOG.md)
## The question
Not *which wallet bought* and not *which token is pumping*, but:
> **Which projects are still building, what have they shipped, and which of them is nobody looking at?**
Every answer on HEY is a fact with the source it came from. There is no score of a project's
worth, no grade, no verdict, and the words *rug* and *scam* appear nowhere in the product — an
end-to-end test asserts it.
## What it looks like
| Explore the catalogue | One project's evidence |
| --- | --- |
|  |  |
| Builder Radar | HEY Signal |
| --- | --- |
|  |  |
More surfaces: Pulse, Ships, Scout, Bounties, Developers, Methodology, mobile
| Pulse — the chain, day by day | Ships — what landed |
| --- | --- |
|  |  |
| Scout — earn by finding evidence | Bounties — set in dollars, paid in HEY |
| --- | --- |
|  |  |
| Developers | Methodology — every rule, stated |
| --- | --- |
|  |  |
| Home, 375px | A project, 375px |
| --- | --- |
| 
| 
|
Captured from production on 20 September 2026.
## In this repository
This is the published half of HEY: the parts that stand on their own and are safe to read.
| Path | What it is |
| --- | --- |
| [`packages/sources`](https://github.com/hey-research-lab/hey-research-open/blob/HEAD/packages/sources) | Every public-data adapter HEY reads — GitHub, Blockscout, Sourcify (verification and its signature database), DEX Screener, GeckoTerminal, CoinGecko, launchpads, feeds, npm, deps.dev, OSV — each with saved fixtures and contract tests. The tests fail on a real network call. All of them go through one fetch guard (private-address and DNS-rebinding checks, redirect and credential rules, size, time and content-type limits) and bounded HTML and XML parsers, tested against hostile pages and feeds. |
| [`packages/scoring`](https://github.com/hey-research-lab/hey-research-open/blob/HEAD/packages/scoring) | Activity status, Build Momentum, Still Building and Under the Radar, deterministic and versioned. They read no price and no balance, and that is tested. |
| [`packages/sdk`](https://github.com/hey-research-lab/hey-research-open/blob/HEAD/packages/sdk) | `@hey-research-lab/sdk`, the typed client over the public API. No dependencies, ESM and CJS, Node 18 or a browser. |
| [`packages/mcp-core`](https://github.com/hey-research-lab/hey-research-open/blob/HEAD/packages/mcp-core) | The MCP tools, renderers, resources and prompts with no transport: fourteen read-only tools, each answer tagged FACT, DERIVED or UNKNOWN. |
| [`apps/mcp`](https://github.com/hey-research-lab/hey-research-open/blob/HEAD/apps/mcp) | `@hey-research-lab/mcp`, the stdio entry point that bundles them. Node 20. The same tools are hosted at `https://heyresearch.xyz/mcp`. |
| [`packages/config`](https://github.com/hey-research-lab/hey-research-open/blob/HEAD/packages/config) | Environment schema and chain constants. |
| [`packages/ui`](https://github.com/hey-research-lab/hey-research-open/blob/HEAD/packages/ui) | The presentation components — cards, chips, status, formatting. |
| [`docs/`](https://github.com/hey-research-lab/hey-research-open/blob/HEAD/docs) | The public API, the MCP server, the source registry, and every data source with what it refuses and why. |
The ingestion pipeline, the quality gate, the database schema, the web app and the operations
tooling stay in the private repository.
## Quickstart
Use the packages from npm (published 27 September 2026):
```bash
npm i @hey-research-lab/sdk # the typed client
claude mcp add hey-research -- npx -y @hey-research-lab/mcp # the MCP server
```
Or build this tree:
```bash
pnpm install
pnpm lint && pnpm typecheck && pnpm test # 686 tests, no network
pnpm --filter @hey-research-lab/sdk build # packages/sdk/dist
pnpm --filter @hey-research-lab/mcp build # apps/mcp/dist/index.js
```
## Use the API
No key needed for the read API. 120 requests a minute anonymously, more with a key.
**One address, one line** — the call a trading bot makes:
```bash
curl "https://heyresearch.xyz/api/v1/scan?chain=4663&token=0xB33eb16782776b4D738c0Fd643577cb0284Db610"
```
```jsonc
{
"found": true,
"status": "shipping",
"status_label": "Shipping",
"verified_builder": true,
"activity": { "commits_30d": 100, "releases_30d": 1, "ships_30d": 3, "last_ship": "2026-09-18" },
"project_url": "https://heyresearch.xyz/project/hey-research-lab",
"cta": { "label": "See the builder on HEY", "url": "…" }
}
```
A token HEY has no published page for answers `200` with `found: false`, so a bot prints nothing
rather than guessing.
**The same thing, typed:**
```ts
import { HeyClient, HeyApiError } from '@hey-research-lab/sdk';
const hey = new HeyClient();
const card = await hey.scanCard(4663, address);
if (!card.found) return null;
for await (const project of hey.projects.items({ tab: 'still-building' })) {
console.log(project.slug, project.lastShippedAt ?? 'no ship recorded');
}
```
A listed project with a token carries `tokenMarket` — the market state the card shows — and the
single-project route sends everything the listing does. `/api/projects/{slug}/market` adds the
contract's deployer, its pools and 1% depth, and a supply-concentration summary with no addresses
(2026-09-25).
`/api/projects/{slug}/relationships` lists what a project is connected to and why HEY thinks so —
every edge with its standing and evidence, never an account and never a "partnership" — and the
snapshot's `peerContext` places some of its figures among comparable projects, one figure at a time,
never as a combined score (2026-09-28).
The snapshot (`/api/projects/{slug}/snapshot`) opens on `summary` — one answer-first line per
question (building, usage, market, contracts, security, the latest change, what HEY does not know),
each tagged `FACT`, `DERIVED` or `UNKNOWN` with its evidence ids — and carries `usage` (calls and
distinct caller addresses per day, never people, never summed into a window) and `security`
(audits, bounties, security.txt, advisories; context, never a verdict). `/api/projects/{slug}/usage`
adds the daily series (2026-09-28).
Paging follows the API's own cursor, a `429` arrives as `HeyApiError` with `retryAfterSeconds`
and is never retried for you, and an absent field means HEY does not know — never a zero.
**For an assistant** — fifteen read-only tools over the same API, hosted or on your machine, listed in the
Official MCP Registry as `io.github.hey-research-lab/hey-research`:
```bash
claude mcp add --transport http hey-research https://heyresearch.xyz/mcp
# or from npm
npx -y @hey-research-lab/mcp
# or from this repository
pnpm --filter @hey-research-lab/mcp build
claude mcp add hey-research -- node "$PWD/apps/mcp/dist/index.js"
```
Full reference: [docs/PUBLIC_API.md](https://github.com/hey-research-lab/hey-research-open/blob/HEAD/docs/PUBLIC_API.md) · [docs/MCP.md](https://github.com/hey-research-lab/hey-research-open/blob/HEAD/docs/MCP.md) ·
[docs/INTEGRATIONS.md](https://github.com/hey-research-lab/hey-research-open/blob/HEAD/docs/INTEGRATIONS.md) — the line to render, the three answers to handle,
and the four things not to do.
## For autonomous agents
From the domain alone, with no JavaScript and no cookies:
| Entry point | What it is |
| --- | --- |
| `https://heyresearch.xyz/llms.txt` | What HEY is, what it will not do, every machine entry point (llms.txt v2) |
| `https://heyresearch.xyz/.well-known/agent-card.json` | A2A 1.0 Agent Card; JSON-RPC at `/api/a2a`, six read-only skills |
| `https://heyresearch.xyz/openapi.json` | OpenAPI 3.1 for the public API |
| `https://heyresearch.xyz/mcp` | Hosted MCP (Streamable HTTP); listed in the Official MCP Registry as `io.github.hey-research-lab/hey-research` ([`apps/mcp/server.json`](https://github.com/hey-research-lab/hey-research-open/blob/HEAD/apps/mcp/server.json)) |
| `https://heyresearch.xyz/api/hey/profile` | `$HEY` as research data: each utility LIVE, PLANNED, RETIRED or UNKNOWN |
| `https://heyresearch.xyz/developers/agents` | The guide (Markdown at `/developers/agents.md`) |
An agent that forms a thesis can record it as an
[AgentResearchReceipt](https://github.com/hey-research-lab/hey-research-open/blob/HEAD/docs/AGENT_RESEARCH_RECEIPTS.md) — neutral, for any project, checked but
never stored or endorsed by HEY. HEY gives no trade instructions and runs no agents of its own.
## The badge
Any project HEY tracks can embed its own status. It updates itself, and it links back to the
evidence behind it.
[](https://heyresearch.xyz/project/hey-research-lab)
```markdown
[](https://heyresearch.xyz/project/)
```
`?theme=dark` and `?style=pill` are the other two looks. [docs/BADGES.md on the site](https://heyresearch.xyz/docs/badges).
## Rules that do not move
- **Building is not price.** Market cap, liquidity and volume are context and filters. Nothing in
`packages/scoring` reads a price or a balance; a neutrality test fails the build if it ever does.
- **Paying changes nothing organic.** Bounties, sponsorships, claims and `$HEY` holdings never move
a rank, a status or a score.
- **No wallet analytics.** No PnL, no smart-money or whale labels, no wallet profiles, no clustering
presented as a claim about people, no copy-trading. The schema guard fails the build on the words.
One exception, decided on 2026-09-14: a bubble map of a **single token's** largest balances on that
token's market page. An address there is a point on a chart of one supply — never a person, never
scored, never ranked across tokens, never an input to any status or score.
- **Absent means unknown.** A figure HEY has not measured is omitted, never published as zero.
- **Security is evidence, never a verdict.** An audit shows an audit took place; it is not a
guarantee of safety. HEY says where a report is published and where it found the link — no
score, no "safe", and "no advisory found" is a reading of one index, never a clean bill.
- **A model is never the source of truth.** AI-assisted interpretation is optional and off by
default; when on, it reads only HEY's own evidence, cites it by id, is labelled as an
interpretation, and never moves a status, a score or a rank. `AI_PROVIDER` accepts `disabled` or
`anthropic` only.
- **Every claim carries its source.** And none of them is a buy signal.
The full rules, with the thresholds they use, are on [the methodology page](https://heyresearch.xyz/methodology).
## `$HEY`, briefly
`$HEY` (`0xB33eb16782776b4D738c0Fd643577cb0284Db610` on Robinhood Chain) pays for evidence:
research bounties set in dollars and paid in HEY, claim bonds, and priority on research requests.
Holding changes what a reader pays, when they see new research and how much API the lab serves
them. It never buys a rank, a status or a score.
## How this repository is produced
A script in the private repository copies the paths listed above, generates a types-only
`@hey/db`, refuses to publish anything that must not leave, and pushes one commit per sync. Issues
and pull requests are welcome here: a change accepted here is applied privately and comes back in
the next sync.
HEY reports what teams ship and whether a tracked token still has a market. It does not predict
prices, and nothing in it is investment advice.
MIT licence. See [CHANGELOG.md](https://github.com/hey-research-lab/hey-research-open/blob/HEAD/CHANGELOG.md) for what has changed and when.