HEY Research Lab

Official14 tools

by hey-research-lab · TypeScript

Evidence-backed Robinhood Chain research: builders, ships, contracts, changes, market context.

io.github.hey-research-lab/hey-research MCP Server

This MCP server provides “Evidence-backed Robinhood Chain research,” focused on topics including builders, ships, contracts, and changes, along with broader market context. The server description emphasizes an evidence-oriented approach to documenting developments and their surrounding environment for technical audiences.

🛠️ Key Features

Evidence-backed research on Robinhood Chain
Coverage areas: builders, ships, contracts, changes, market context

🚀 Use Cases

Reference materials for developers tracking Robinhood Chain ecosystem activity
Context gathering for analyzing contract and market-related changes

⚡ Developer Benefits

Structured focus on builders, ships, and contracts
Supports understanding how changes relate to market context

Topics

api-clientdeveloper-toolshey-researchmcpopen-sourcerobinhood-chainsdktypescript

Captured live from the server via tools/list.

find_projects

Which Robinhood Chain project is this name, $TICKER or 0x contract, and is anyone building it? A full 0x address is a contract lookup: its ships in 30 days, the last one with its source. Or browse who is shipping now, back from dormancy, accelerating or building ahead of market attention. Surfaces: building-with-token: verified shipping, active or resumed, with a token whose market is live. still-building: verified activity continuing through a market drawdown HEY tracked. under-the-radar: eligible under HEY's Under the Radar rule (status shipping, active or resumed; Build Momentum at least 30; at least 2 meaningful events in the last 30 days, one of them a ship rather than a commit summary; a fresh reading of an active market, not a thin one or only a launch curve, for the project's own token) and a positive Discovery Gap — market-attention percentile below the build percentile; a positive gap alone is not enough, and it does not bound attention itself. shipping-now: status SHIPPING. most-active: shipping, active or resumed, by Build Momentum. new-builders: recorded in the last 7 days. back-from-dormancy: status RESUMED, narrowed to verified builders native to the chain (status=RESUMED gives every resumed project). utility, memes: by kind. shipping-in-silence: eligible under the Under the Radar rule AND below the 40th market-attention percentile. accelerating: more meaningful events in 30 days than in the 30 before. builder-radar: the Builder Radar, ranked by verified development, on-chain use and research, never price. shipping-in-silence and accelerating take no other argument (at most 100 rows); builder-radar takes query, radar, limit and offset. Not a ranking by price: a market sort is context, and rows without the figure follow in activity order.

Parameters18

query	string	optional	Name, $TICKER or 0x contract (or its start).
surface	string	optional
radar	string	optional	With surface=builder-radar: a Radar view.
kind	string	optional
status	string	optional	Activity status.
narrative	string	optional	Narrative slug, e.g. "ai-agents".
launchpad	string	optional	e.g. "pons", "virtuals".
has	array	optional	Facts every row must carry.
stage	string	optional	Token launch stage.
minLiquidity	number	optional	USD; unknown is excluded, never zero.
maxMarketCap	number	optional	USD, on the card's valuation reading.
minMarketCap	number	optional
minVolume	number	optional	24h volume, USD.
age	string	optional	Since the first pool opened.
deployed	string	optional	Since the contract was deployed.
sort	string	optional	Default activity; shipped = newest ship first; shipped7d / shipped30d = most meaningful ships in the last 7 / 30 days.
limit	integer	optional	Default 24.
offset	integer	optional	The offset a previous answer gave.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "Name, $TICKER or 0x contract (or its start)."
    },
    "surface": {
      "type": "string",
      "enum": [
        "building-with-token",
        "still-building",
        "under-the-radar",
        "shipping-now",
        "most-active",
        "new-builders",
        "back-from-dormancy",
        "utility",
        "memes",
        "shipping-in-silence",
        "accelerating",
        "builder-radar"
      ]
    },
    "radar": {
      "type": "string",
      "enum": [
        "all",
        "pons",
        "virtuals",
        "other-launch",
        "no-token",
        "new",
        "established",
        "most-improved",
        "development",
        "onchain",
        "resumed"
      ],
      "description": "With surface=builder-radar: a Radar view."
    },
    "kind": {
      "type": "string",
      "enum": [
        "UTILITY",
        "MEME",
        "HYBRID",
        "INFRASTRUCTURE",
        "RWA",
        "APPLICATION",
        "OTHER"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "SHIPPING",
        "ACTIVE",
        "QUIET",
        "DORMANT",
        "RESUMED",
        "UNKNOWN"
      ],
      "description": "Activity status."
    },
    "narrative": {
      "type": "string",
      "maxLength": 80,
      "description": "Narrative slug, e.g. \"ai-agents\"."
    },
    "launchpad": {
      "type": "string",
      "maxLength": 40,
      "description": "e.g. \"pons\", \"virtuals\"."
    },
    "has": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "token",
          "x",
          "marketCap",
          "launchpad",
          "liveMarket",
          "verifiedToken",
          "trading",
          "github"
        ]
      },
      "description": "Facts every row must carry."
    },
    "stage": {
      "type": "string",
      "enum": [
        "curve",
        "graduated",
        "dex"
      ],
      "description": "Token launch stage."
    },
    "minLiquidity": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "USD; unknown is excluded, never zero."
    },
    "maxMarketCap": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "USD, on the card's valuation reading."
    },
    "minMarketCap": {
      "type": "number",
      "exclusiveMinimum": 0
    },
    "minVolume": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "24h volume, USD."
    },
    "age": {
      "type": "string",
      "enum": [
        "day",
        "week",
        "month",
        "older"
      ],
      "description": "Since the first pool opened."
    },
    "deployed": {
      "type": "string",
      "enum": [
        "day",
        "week",
        "month",
        "older"
      ],
      "description": "Since the contract was deployed."
    },
    "sort": {
      "type": "string",
      "enum": [
        "activity",
        "shipped",
        "shipped7d",
        "shipped30d",
        "marketCap",
        "newest",
        "liquidity",
        "volume24h"
      ],
      "description": "Default activity; shipped = newest ship first; shipped7d / shipped30d = most meaningful ships in the last 7 / 30 days."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 48,
      "description": "Default 24."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "The offset a previous answer gave."
    }
  },
  "additionalProperties": false
}

get_project_snapshot

Where does this Robinhood Chain project stand? One read by slug — the Research Summary, identity, activity status and Build Momentum, last ships, market context with its kind or why it is withheld, on-chain use, 7-day usage (distinct caller addresses, not people), verification, HoodLock locks, latest changes, freshness and what HEY does not know. Context blocks, never building: paid promotion (presence and dates), DefiLlama protocol economics (measured, not tracked or unread), developer footprint. Not price advice.

Parameters1

slug

string

required

A project slug, e.g. "agentos".

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "A project slug, e.g. \"agentos\"."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

get_changes

What changed on Robinhood Chain today or this week, or for one project or contract? The change ledger: releases, ships, status moves, contract deploys and upgrades, verification, sources, unlocks — one event per change with its own time and precision, when HEY first knew, and its evidence. Newest first; for today pass detectedSince; to follow, pass after=c1.0 and keep each cursor. A retraction means HEY no longer makes that claim. Facts, never causes.

Parameters10

project	string	optional	A project slug.
contract	string	optional	<chainId>:<address>.
domain	array	optional
type	array	optional
since	string	optional	ISO date: events whose own time is at or after it (events with no source time are left out).
until	string	optional
detectedSince	string	optional	ISO instant: start a sync at the first event HEY recorded at or after it.
after	string	optional	Sync forward from this cursor (c1.0 is the start).
before	string	optional	Browse older than this cursor.
limit	integer	optional	Default 30.

Raw schema

{
  "type": "object",
  "properties": {
    "project": {
      "type": "string",
      "maxLength": 120,
      "description": "A project slug."
    },
    "contract": {
      "type": "string",
      "pattern": "^\\d{1,10}:0x[0-9a-fA-F]{40}$",
      "description": "<chainId>:<address>."
    },
    "domain": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "build",
          "contract",
          "market",
          "token",
          "research",
          "lock",
          "market_integrity"
        ]
      }
    },
    "type": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "build.release",
          "build.code_activity",
          "build.ship",
          "build.status_changed",
          "build.dormant",
          "build.resumed",
          "build.accelerating",
          "build.slowing",
          "contract.deployed",
          "contract.followup_deployed",
          "contract.implementation_changed",
          "contract.source_verified",
          "contract.source_unverified",
          "contract.interface_changed",
          "contract.usage_changed",
          "contract.method_first_observed",
          "contract.method_resumed",
          "market.status_changed",
          "market.liquidity_moved",
          "market.volume_spike",
          "market.distribution_changed",
          "token.launch_stage_changed",
          "token.verification_changed",
          "research.published",
          "research.builder_verified",
          "research.owner_verified",
          "research.source_added",
          "research.source_unavailable",
          "research.source_restored",
          "research.source_changed",
          "research.narrative_assigned",
          "lock.unlock_due",
          "lock.observed",
          "lock.withdrawn",
          "market_integrity.event"
        ]
      }
    },
    "since": {
      "type": "string",
      "maxLength": 40,
      "description": "ISO date: events whose own time is at or after it (events with no source time are left out)."
    },
    "until": {
      "type": "string",
      "maxLength": 40
    },
    "detectedSince": {
      "type": "string",
      "maxLength": 40,
      "description": "ISO instant: start a sync at the first event HEY recorded at or after it."
    },
    "after": {
      "type": "string",
      "maxLength": 64,
      "description": "Sync forward from this cursor (c1.0 is the start)."
    },
    "before": {
      "type": "string",
      "maxLength": 64,
      "description": "Browse older than this cursor."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Default 30."
    }
  },
  "additionalProperties": false
}

get_project_timeline

What did this project ship, and when? Builds, releases, code, contract deploys, upgrades and interface changes, token verification, locks and unlocks, each with how precisely HEY knows its time. Lenses: everything, build, code, onchain, market, locks. Paged with the before cursor.

Parameters4

slug	string	required	A project slug, e.g. "agentos".
lens	string	optional
limit	integer	optional	Default 30.
before	string	optional	The cursor the previous answer gave.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "A project slug, e.g. \"agentos\"."
    },
    "lens": {
      "type": "string",
      "enum": [
        "everything",
        "build",
        "code",
        "onchain",
        "market",
        "locks"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Default 30."
    },
    "before": {
      "type": "string",
      "maxLength": 400,
      "description": "The cursor the previous answer gave."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

explain_fact

Why does HEY say a project is Shipping, Dormant or Still Building, or show a figure? The value, FACT, DERIVED or UNKNOWN, the rule and version, the winning source, the inputs, the lineage and the evidence ids. Omit fact to list what can be explained; source.counted takes a source id.

Parameters3

slug	string	required	A project slug, e.g. "agentos".
fact	string	optional
source	string	optional	With fact=source.counted: the source id.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "A project slug, e.g. \"agentos\"."
    },
    "fact": {
      "type": "string",
      "enum": [
        "market.valuation",
        "market.status",
        "activity.status",
        "build.momentum",
        "discovery_gap",
        "still_building",
        "research.level",
        "token.verification",
        "source.counted",
        "market_integrity.state"
      ]
    },
    "source": {
      "type": "string",
      "maxLength": 80,
      "description": "With fact=source.counted: the source id."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

get_evidence

What backs this claim? Open the record a HEY answer cited by its typed id — ship:, signal:, abi:, impl:, lock:, source:, claim:, state:, integrity:, narrative:, method:, sourcechange:, security:, v4hook: — as a receipt: what it claims, its source URL, when it happened at what precision, when HEY knew, how it is backed. A withdrawn record says so.

Parameters1

string

required

A typed evidence id, e.g. "ship:2ac87a66-…".

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[a-z_]+:[A-Za-z0-9:._-]{1,200}$",
      "description": "A typed evidence id, e.g. \"ship:2ac87a66-…\"."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

get_token_market

Does this token still trade? Context beside the building, from HEY's daily index: current reading (valuation kind, provider), price, liquidity, volume and trades by day, lifecycle (deploy, launchpad claim, stage, first trade), pools and depth, supply concentration (shares only, no addresses), contract checks. include=["moves"] adds each day-on-day valuation move with the building events published before it — a sequence, never a cause. Not price advice.

Parameters4

slug	string	required	A project slug, e.g. "agentos".
days	integer	optional	Days of history; default 30.
include	array	optional
min_change_pct	integer	optional	With moves: smallest move in percent; default 25.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "A project slug, e.g. \"agentos\"."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 400,
      "description": "Days of history; default 30."
    },
    "include": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "moves"
        ]
      }
    },
    "min_change_pct": {
      "type": "integer",
      "minimum": 5,
      "maximum": 500,
      "description": "With moves: smallest move in percent; default 25."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

get_contract

Who made this Robinhood Chain contract, and is it a known project's? Project, creation, deployer (the only account named, with a count of other tracked projects' tokens it deployed), verified source and whose code it is (template, bytecode match or its own), Sourcify's answer, proxy and implementation history, interface changes, 7 days of calls per method (counts, names withheld; a selector's signature candidate — a guess, never a name). Address (chainId default 4663) or slug for all of a project's. An unread proxy is "not read", never "not a proxy". Not a safety verdict.

Parameters3

address	string	optional
chainId	integer	optional	Default 4663.
slug	string	optional	A project slug, for all of its contracts.

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^0[xX][a-fA-F0-9]{40}$"
    },
    "chainId": {
      "type": "integer",
      "description": "Default 4663."
    },
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "A project slug, for all of its contracts."
    }
  },
  "additionalProperties": false
}

get_v4_hook

Who built this Robinhood Chain Uniswap v4 hook? The project HEY ties it to and why (named only while listed; never a creator account), declared callbacks (not a safety verdict), source, hooklist entry, pools by week and unknowns.

Parameters1

address

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^0[xX][a-fA-F0-9]{40}$"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false
}

project_diff

What changed for this project between two dates (YYYY-MM-DD, at most 400 days apart)? Releases and meaningful ships, status, Build Momentum, valuation and liquidity then and now, and the changes recorded — each from the nearest persisted point with its date and basis. Never a cause.

Parameters3

slug	string	required	A project slug, e.g. "agentos".
from	string	required
to	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "A project slug, e.g. \"agentos\"."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "slug",
    "from",
    "to"
  ],
  "additionalProperties": false
}

ask_hey

Asking something else about one project? Put it in free text, by slug, in English or Malay ("did they ship this month?"). HEY answers only from its record, every line tagged FACT, DERIVED or UNKNOWN with its source. Building only; no view on price.

Parameters2

slug	string	required	A project slug, e.g. "agentos".
question	string	required	The question, in the reader's words.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "A project slug, e.g. \"agentos\"."
    },
    "question": {
      "type": "string",
      "minLength": 3,
      "maxLength": 280,
      "description": "The question, in the reader's words."
    }
  },
  "required": [
    "slug",
    "question"
  ],
  "additionalProperties": false
}

chain_overview

How active is Robinhood Chain as a whole? view: days (default; trades, volume, tokens, transactions, launches, ships per day), this-week, weekly-report (an ISO week, or the latest), unlocks (scheduled HoodLock unlocks with proof), build-market (Build Momentum beside market attention). Aggregates only; nobody is named.

Parameters3

view	string	optional
days	integer	optional	days: 1–400 (default 14); unlocks: 1–365 ahead (default 30).
week	string	optional	weekly-report: e.g. 2026-W37.

Raw schema

{
  "type": "object",
  "properties": {
    "view": {
      "type": "string",
      "enum": [
        "days",
        "this-week",
        "weekly-report",
        "unlocks",
        "build-market"
      ]
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 400,
      "description": "days: 1–400 (default 14); unlocks: 1–365 ahead (default 30)."
    },
    "week": {
      "type": "string",
      "pattern": "^\\d{4}-W\\d{2}$",
      "description": "weekly-report: e.g. 2026-W37."
    }
  },
  "additionalProperties": false
}

research_answer

Is this Robinhood Chain project still being built, what did it ship, what changed, is this contract its own? One bounded answer. capability: research_project or builder_status (project slug; find_projects resolves a name or $TICKER); what_changed (project or chain, 1–30 days); verify_project (address, project?); compare_builders (2–4, no winner); unknowns (every coverage state). Claims FACT/DERIVED/UNKNOWN with freshness and evidence ids. Not price advice or a safety verdict.

Parameters8

capability	string	required
project	string	optional
projects	array	optional
address	string	optional
days	integer	optional
types	array	optional
limit	integer	optional
building	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "capability": {
      "type": "string",
      "enum": [
        "research_project",
        "what_changed",
        "builder_status",
        "verify_project",
        "compare_builders",
        "unknowns"
      ]
    },
    "project": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "projects": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      },
      "minItems": 2,
      "maxItems": 4
    },
    "address": {
      "type": "string",
      "pattern": "^0[xX][a-fA-F0-9]{40}$"
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    },
    "types": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-z_]+\\.[a-z_]+$"
      },
      "minItems": 1,
      "maxItems": 20
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "building": {
      "type": "string",
      "const": "only"
    }
  },
  "required": [
    "capability"
  ],
  "additionalProperties": false
}

market_integrity

What happened to this project's tracked token market — liquidity against the level it held, trading, a pool migration — beside its builder activity, and where do the two disagree? It describes the token market, never whether development stopped, and never calls a project a rug or safe.

Parameters1

slug

string

required

A project slug, e.g. "agentos".

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "A project slug, e.g. \"agentos\"."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

apps/mcp/README.md8 KBView on GitHub

@hey-research-lab/mcp

npx -y @hey-research-lab/mcp          # Node 20 or newer

Or use the hosted endpoint, which needs nothing installed: claude mcp add --transport http hey-research https://heyresearch.xyz/mcp.

HEY Research as tools an assistant can call, over the Model Context Protocol. HEY is the builder-discovery layer for Robinhood Chain; it answers one question — which projects are still building, what have they shipped, and which of them are not yet getting much market attention? — from a public, source-backed record.

The tools read the same public API anyone can curl, so they can say nothing the API does not.

Hosted

claude mcp add --transport http hey-research https://heyresearch.xyz/mcp

Streamable HTTP, stateless and read-only. Add --header "Authorization: Bearer hey_…" to read with your key's allowance. See docs/MCP.md for what the endpoint does and does not do.

Local (stdio)

npx -y @hey-research-lab/mcp

Node 20 or newer — the floor @modelcontextprotocol/sdk brings with it.

Claude Code

claude mcp add hey-research -- npx -y @hey-research-lab/mcp

Claude Desktop — in claude_desktop_config.json:

json

{
  "mcpServers": {
    "hey-research": {
      "command": "npx",
      "args": ["-y", "@hey-research-lab/mcp"]
    }
  }
}

Environment

Variable	Purpose
`HEY_API_URL`	Another HEY to read, e.g. `http://localhost:3000` when developing. Default `https://heyresearch.xyz`. Anything but https is refused except on localhost, because the key rides on every request.
`HEY_API_KEY`	An API key from heyresearch.xyz/account. Names your integration and gives it its own per-minute bucket instead of the one every caller on your address shares, with a monthly allowance; a free key keeps the anonymous per-minute figure, a holder key gets more. No tool is gated behind it. Sent as a bearer token, never logged.
`HEY_MARKET_INTEGRITY`	Set to `public` only when the HEY you read publishes Market Integrity; `market_integrity` is offered only then. Unset, the server offers thirteen tools.
`HEY_MCP_PROFILE`	`research` serves the research profile (round 4): builder intelligence first — `research_answer` (which still carries its contract's labelled market context), `find_projects` by identity, `get_changes` without market events, `get_project_timeline`, `explain_fact`, `get_evidence`, `get_contract`, `get_v4_hook`. Unset, the full set. Hosted: `https://heyresearch.xyz/mcp/research`.

The thirteen tools

Tool	What it answers
`find_projects`	Find a project by name, ticker or contract, or browse a surface — `still-building`, `under-the-radar` (eligible under the Under the Radar rule, with a positive Discovery Gap), `back-from-dormancy`, `shipping-in-silence`, `accelerating`, `builder-radar`, … — with the catalogue's filters. A `0x…` address is the contract lookup: is anyone building it, its ships in 30 days, the last one and its source.
`get_project_snapshot`	One project in one read: identity, build, market with its valuation kind or why it is withheld, on-chain, verification, locks, latest changes, freshness, and what HEY does not know.
`get_changes`	The change ledger: what changed chain-wide or on one project, one event per change with its own time and precision, when HEY knew, and its evidence; a cursor to follow along.
`get_project_timeline`	One project's evidence on one axis, paged with a cursor.
`explain_fact`	Why HEY shows a figure: the rule, the source, the inputs, the lineage, the evidence ids.
`get_evidence`	One typed evidence id (`ship:`, `signal:`, `abi:`, `impl:`, `lock:`, `source:`, `claim:`, `state:`, `integrity:` (while Market Integrity is public), `narrative:`, `method:`, `sourcechange:`, `security:`, `v4hook:`) as a receipt.
`get_token_market`	One token's market from HEY's daily index, lifecycle, pools, supply concentration (shares only), contract checks; `include: ["moves"]` adds the valuation moves with what shipped before each.
`get_contract`	A contract as a research entity — creation, deployer, verified source, proxy and implementation history, interface counts, activity, and for a Uniswap v4 hook HEY stores its callbacks and attribution.
`get_v4_hook`	Who built a Robinhood Chain Uniswap v4 hook: the project HEY ties it to and on what basis (named only while HEY lists the hook; never a creator account), the callbacks its address declares (never a safety verdict), source and proxy as read, Uniswap's hooklist entry as context, pools on tracked tokens by week, and what HEY does not know.
`project_diff`	What changed for one project between two dates, never a cause.
`ask_hey`	A free-text question about one project, answered only from HEY's record.
`chain_overview`	The chain day by day, this week, an archived weekly report, scheduled HoodLock unlocks, or Build Momentum beside market attention.
`research_answer`	HEY's agent contract (AgentIntelligenceResponse v1) for one of six capabilities — `research_project`, `what_changed`, `builder_status`, `verify_project`, `compare_builders`, `unknowns` — the answer first, then claims tagged FACT, DERIVED or UNKNOWN, what HEY does not know, freshness and evidence ids. A source's words are quoted as data.

Plus market_integrity where the site publishes it.

Folded on 2026-09-30 and still callable, unlisted, until 2026-12-31: lookup_token (use find_projects with the address), compare_projects (use research_answer with compare_builders) and get_project_coverage (use research_answer with unknowns). Each answers as before, plus one line naming its replacement.

Every tool returns typed structuredContent beside its text and declares an outputSchema: research_answer returns the AgentIntelligenceResponse v1 itself; every other tool returns { schema: "hey.mcp-api-answer", api, data, notice }, the public API object it rendered. Resources (hey://project/{slug}, hey://project/{slug}/timeline, hey://project/{slug}/coverage, hey://contract/{chainId}/{address}, hey://changes/latest) and eight prompts (deep_research_project, what_changed_since, explain_metric, investigate_contract, what_changed_today, compare_project_usage, explain_project_evidence, monitor_project) come with them.

Every answer quotes a source's words «…» (a name, a ticker, a release title) as data, tags its lines FACT, DERIVED or UNKNOWN, says how many it showed of how many and how to read on, names a valuation by its kind, carries the source, and links the JSON it was rendered from. Nothing is rendered as zero or "n/a" where HEY has no figure.

What it will not say

HEY records public building activity. It is not investment advice, it does not predict or rank by price, and it holds no wallet data. The only account any tool names is a contract's deployer: get_token_market names it beside one token's supply-concentration summary (shares only), and get_contract names it with how many other tracked projects' tokens the same account deployed — a count, never a profile, called a launch service only on HEY's own shared-deployer rule. Still Building is a narrow claim — verified activity continuing through a market drawdown HEY tracked — and the server never states it without its meaning.

From source

The tools live in packages/mcp-core of the public HEY Research repository; this package is their stdio entry point and bundles them, with @hey-research-lab/sdk, into one file.

pnpm --filter @hey-research-lab/mcp build && node apps/mcp/dist/index.js

Licence

Install

Tools (14)

find_projectsget_project_snapshotget_changesget_project_timelineexplain_factget_evidenceget_token_marketget_contract

Configuration

Environment variables

HEY_API_KEYsecret

Optional HEY API key: names your integration and gives it its own per-minute bucket with a monthly allowance; a free key keeps the anonymous per-minute figure. Nothing private is behind it.

HEY_MCP_PROFILE

Optional: research for the research profile (builder intelligence first); default full.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "hey-research": {
      "command": "npx",
      "args": [
        "-y",
        "@hey-research-lab/mcp@0.3.0"
      ],
      "env": {
        "HEY_API_KEY": "<YOUR_HEY_API_KEY>",
        "HEY_MCP_PROFILE": "<YOUR_HEY_MCP_PROFILE>"
      }
    }
  }
}

io.github.hey-research-lab/hey-research MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

Topics

find_projects

get_project_snapshot

get_changes

get_project_timeline

explain_fact

get_evidence

get_token_market

get_contract

get_v4_hook

project_diff

ask_hey

chain_overview

research_answer

market_integrity

@hey-research-lab/mcp

Hosted

Local (stdio)

Environment

The thirteen tools

What it will not say

From source

Licence

Install

Configuration

Related servers