HEY Research Lab

{
  "name": "HEY Research Lab",
  "url": "https://heyresearch.xyz/api/a2a",
  "description": "HEY Research Lab is the public record of building on Robinhood Chain (chain id 4663) \u2014 every ship with its source. It records project identity, builder activity, releases, contracts, on-chain use, market context and changes, each with its source, and serves them through a public API, a TypeScript SDK and a hosted MCP server. Use HEY when you need evidence-backed information about Robinhood Chain projects: who is building, what they shipped, their contracts, what changed and when, market context with its reading date, and where HEY has no evidence. Read-only and deterministic: every answer is HEY's public API JSON for the same question, with evidence ids. The same record is served as a public API at https://heyresearch.xyz/api with its OpenAPI document at https://heyresearch.xyz/openapi.json and as a hosted MCP server at https://heyresearch.xyz/mcp over Streamable HTTP, with a research profile at https://heyresearch.xyz/mcp/research (builder intelligence first: no market-move, Under the Radar or valuation tool, and the ledger without market events; research_answer still carries the market context of HEY's agent contract (the valuation with its kind, source and reading date, and the market status), labelled context only and never a builder judgement, and one project's Under the Radar state with its Discovery Gap or why it is not measured). $HEY is HEY's token: contract 0xb33eb16782776b4d738c0fd643577cb0284db610 on Robinhood Chain (chain id 4663). HEY Research Lab is the product's brand name and the name of its own project record; it is spelled one way everywhere. No wallet analytics, PnL, smart-money or whale labels, wallet profiles or \"follow this wallet\". No investment advice, price prediction, valuation opinion or buy/sell signal. No paid placement in organic ranking; holding $HEY never changes a ranking. No provider call in a read: every answer comes from HEY's own tables.",
  "version": "1.0.0",
  "documentationUrl": "https://heyresearch.xyz/developers/agents",
  "iconUrl": "https://heyresearch.xyz/hey-mark.png",
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/plain"
  ],
  "skills": [
    {
      "id": "research_project",
      "name": "Research one project",
      "description": "Is this Robinhood Chain project still being built, and what did it ship? One project's important state from HEY's record: identity, builder activity, market context with its reading date and valuation kind, on-chain use, verification, locks, the newest changes, freshness and coverage. Input: {\"skill\":\"research_project\",\"project\":\"<slug>\"}, or \"q\" (a name or $TICKER) or \"address\" (a 0x contract) in place of the slug \u2014 exactly one. Or plain text: a project's name, ticker or 0x contract, looked up through HEY's search \u2014 one exact match is researched, several are listed as candidates, none is not_found; HEY never guesses. Add \"contract\":\"agent-intelligence-v1\" for HEY's AgentIntelligenceResponse v1 (answer, tagged claims, unknowns, freshness, evidence ids).",
      "tags": [
        "robinhood-chain",
        "project-research",
        "builder-activity",
        "evidence"
      ],
      "examples": [
        "{\"skill\":\"research_project\",\"project\":\"chit\"}",
        "research_project chit"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "compare_projects",
      "name": "Compare projects",
      "description": "How do these projects' building records compare? Two to four published projects side by side with the page's own figures and gates. No winner is named. Input: {\"skill\":\"compare_projects\",\"projects\":[\"<slug>\",\"<slug>\"]}. Add \"contract\":\"agent-intelligence-v1\" for HEY's AgentIntelligenceResponse v1 (answer, tagged claims, unknowns, freshness, evidence ids). The contract compares builder metrics over 30 days only.",
      "tags": [
        "robinhood-chain",
        "comparison"
      ],
      "examples": [
        "{\"skill\":\"compare_projects\",\"projects\":[\"digitaldon\",\"anyroute\"]}"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "what_changed",
      "name": "What changed",
      "description": "What changed on Robinhood Chain today or this week, or for one project? Changes HEY recorded on its canonical ledger, chain-wide or for one project, newest first or synced from a cursor. Input: {\"skill\":\"what_changed\",\"project\":\"<slug>\",\"detectedSince\":\"<ISO>\",\"after\":\"<cursor>\",\"limit\":20}; every field optional. Add \"contract\":\"agent-intelligence-v1\" for HEY's AgentIntelligenceResponse v1 (answer, tagged claims, unknowns, freshness, evidence ids). With the contract: {\"project\"?, \"days\": 1\u201330, \"types\"?: [\"build.release\", \u2026], \"limit\": 1\u201350, \"building\"?: \"only\"}; \"building\":\"only\" keeps the changes that count as building, and {\"brief\": true} alone is the week on the whole chain (chain_brief), both answered with the contract whether or not it is named.",
      "tags": [
        "changes",
        "monitoring",
        "evidence"
      ],
      "examples": [
        "{\"skill\":\"what_changed\",\"project\":\"chit\",\"limit\":10}",
        "what_changed"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "explain_fact",
      "name": "Explain a published fact",
      "description": "Why does HEY say a project is Shipping, Dormant or Still Building, or show a figure? The rule, the inputs, the lineage and the evidence ids, from persisted evaluations. Facts: market.valuation, market.status, activity.status, build.momentum, discovery_gap, still_building, research.level, token.verification, source.counted, market_integrity.state, build.change. Input: {\"skill\":\"explain_fact\",\"project\":\"<slug>\",\"fact\":\"<fact>\"}; without fact, the facts HEY can explain. Add \"contract\":\"agent-intelligence-v1\" for HEY's AgentIntelligenceResponse v1 (answer, tagged claims, unknowns, freshness, evidence ids). With the contract the answer is builder_status: activity status with its methodology, inputs, evidence and excluded context.",
      "tags": [
        "explainability",
        "evidence",
        "methodology"
      ],
      "examples": [
        "{\"skill\":\"explain_fact\",\"project\":\"chit\",\"fact\":\"activity.status\"}"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "check_project_coverage",
      "name": "Check what HEY knows",
      "description": "What does HEY not know about this project? Per dimension, whether HEY measured it: MEASURED, NO_SOURCE, NOT_ENOUGH_YET, STALE, SOURCE_UNAVAILABLE, NOT_APPLICABLE, NOT_RESEARCHED, ERROR or WITHHELD (with an optional stateDetail: PARTIAL or MAPPING_BLOCKED) \u2014 states, never a score. Use before concluding anything from an absence. Input: {\"skill\":\"check_project_coverage\",\"project\":\"<slug>\"}. Add \"contract\":\"agent-intelligence-v1\" for HEY's AgentIntelligenceResponse v1 (answer, tagged claims, unknowns, freshness, evidence ids). With the contract each gap is UNKNOWN, NOT_MEASURED, NOT_VERIFIED, STALE or INSUFFICIENT_EVIDENCE.",
      "tags": [
        "coverage",
        "evidence-gaps"
      ],
      "examples": [
        "{\"skill\":\"check_project_coverage\",\"project\":\"chit\"}"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    },
    {
      "id": "investigate_contract",
      "name": "Investigate a contract",
      "description": "Who made this Robinhood Chain contract, and is it a known project's? The contract as HEY recorded it: project, creation, deployer, proxy and implementation history, verified source, interface counts and seven-day activity, each with whether HEY measured it. Input: {\"skill\":\"investigate_contract\",\"address\":\"0x\u2026\"}. Add \"contract\":\"agent-intelligence-v1\" for HEY's AgentIntelligenceResponse v1 (answer, tagged claims, unknowns, freshness, evidence ids). With the contract, and optionally \"project\":\"<slug>\", the answer is VERIFIED, UNVERIFIED, CONTRACT_MISMATCH or UNKNOWN attribution.",
      "tags": [
        "contracts",
        "robinhood-chain"
      ],
      "examples": [
        "{\"skill\":\"investigate_contract\",\"address\":\"0xd523a627030509021cc39b6d7c8543417d3e50d8\"}"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json",
        "text/plain"
      ]
    }
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "extensions": [
      {
        "uri": "https://heyresearch.xyz/developers/agents#discover",
        "params": {
          "api": {
            "base": "https://heyresearch.xyz/api",
            "openapi": "https://heyresearch.xyz/openapi.json"
          },
          "mcp": {
            "endpoint": "https://heyresearch.xyz/mcp",
            "transport": "streamable-http",
            "npmPackage": "@hey-research-lab/mcp",
            "registryName": "io.github.hey-research-lab/hey-research",
            "researchEndpoint": "https://heyresearch.xyz/mcp/research"
          },
          "brand": "HEY Research Lab",
          "chain": {
            "name": "Robinhood Chain",
            "chainId": 4663
          },
          "token": {
            "caip10": "eip155:4663:0xb33eb16782776b4d738c0fd643577cb0284db610",
            "status": "live",
            "symbol": "$HEY",
            "chainId": 4663,
            "profile": "https://heyresearch.xyz/api/hey/profile",
            "contract": "0xb33eb16782776b4d738c0fd643577cb0284db610"
          },
          "domain": "heyresearch.xyz",
          "llmsTxt": "https://heyresearch.xyz/llms.txt",
          "nameNote": "HEY Research Lab is the product's brand name and the name of its own project record; it is spelled one way everywhere.",
          "agentCard": "https://heyresearch.xyz/.well-known/agent-card.json",
          "projectRecordName": "HEY Research Lab"
        },
        "required": false,
        "description": "Data only, changes no request or response: HEY Research Lab's machine identity \u2014 brand and project-record name, domain, chain, the $HEY contract (null before launch, with the reason), the hosted MCP endpoints (full and research profile), the public API and OpenAPI document."
      }
    ]
  },
  "protocolVersion": "0.3.0",
  "provider": {
    "organization": "HEY Research Lab",
    "url": "https://heyresearch.xyz/"
  }
}