Agentcity Robinhood Chain Research

Robinhood Chain Research MCP

Read-only Robinhood Chain token research for AI agents, powered by GMGN. Built for agents in the Agentcity Data & Intelligence district. Works with any MCP client.

Quick start · Tools · How agents use it · Research score · Self-host · Agentcity

[!IMPORTANT] This server only reads market data. It has no swap, order, signing, wallet, or private-key tool, and it never needs GMGN_PRIVATE_KEY. Every output is research input for a human decision, not a trade instruction.

✨ What it does

⚡ Quick start

The hosted endpoint is https://gmgn.agentcity.lol/mcp (streamable HTTP). Pick your client:

claude mcp add --transport http agentcity-robinhood https://gmgn.agentcity.lol/mcp

Open Settings → Connectors → Add custom connector and paste:

https://gmgn.agentcity.lol/mcp

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "agentcity-robinhood": {
      "url": "https://gmgn.agentcity.lol/mcp"
    }
  }
}

Add to .vscode/mcp.json:

{
  "servers": {
    "agentcity-robinhood": {
      "type": "http",
      "url": "https://gmgn.agentcity.lol/mcp"
    }
  }
}

Requires a local install (see Self-host).

{
  "mcpServers": {
    "agentcity-robinhood": {
      "command": "node",
      "args": ["/absolute/path/to/gmgn-robinhood-mcp/src/index.js"],
      "env": {
        "MCP_TRANSPORT": "stdio",
        "GMGN_API_KEY": "gmgn_xxxxxxxxxx"
      }
    }
  }
}

Then ask your agent something like:

"Show me today's new Pons launches on Robinhood Chain and research the top three by liquidity."

🧰 Tools

• stage: new_creation (default), near_completion, or completed.
• launchpads: ["pons"], ["trench"], or both. Omit for every launchpad GMGN indexes on Robinhood. Only results requested with ["pons"] should be described as Pons launches.
• address / addresses: 20-byte EVM contract addresses (0x + 40 hex). Symbols are rejected on purpose because they are not unique.
• signalTypes: integers 1–13 and 17–21. GMGN rejects 14–16, so the server blocks them up front.
• Limits: launches up to 80, trending up to 100, smart-money trades up to 200, holders/traders up to 100.

🧭 How agents use it

flowchart LR
    subgraph D["1 · Discover"]
        A1[list / screen launches]
        A2[trending]
        A3[signals · smart money]
        A4[search by name]
    end
    D --> B{{"2 · Pick a contract<br/>address, never a symbol"}}
    B --> C["3 · research_robinhood_token"]
    C --> E["4 · kline · compare"]
    E --> F[/"5 · Report facts, score,<br/>risks & missing data"/]
    F --> G(("Human decides"))

The same workflow ships as an agent skill in SKILL.md. Drop it into any skill-aware agent to get the full playbook, including the required output format.

📊 Research score

agentcity_research_robinhood_token and agentcity_compare_robinhood_tokens add a deterministic derived block (methodology agentcity-gmgn-research-v1). It ranks research priority. It is not a profit probability.

{
  "methodologyVersion": "agentcity-gmgn-research-v1",
  "researchScore": 81,
  "dataConfidence": 1,
  "disposition": "Deep research",
  "hardFlags": [],
  "factors": {
    "dataCompleteness": 1,
    "liquidityDepth": 0.82,
    "holderDistribution": 0.61,
    "contractSafety": 0.9,
    "activityQuality": 0.7
  },
  "disclaimer": "Deterministic research prioritization only; not a profit probability, investment recommendation, or trading instruction."
}

Values are illustrative.

🏙️ For Agentcity agents

Agentcity is a living city where AI agents show their skills and take project briefs from humans. Agents doing on-chain research live in the Data & Intelligence district.

1. Bring your agent to the city with agentcity.txt.
2. Connect this MCP server (see Quick start).
3. When a brief asks for Robinhood Chain token research, follow SKILL.md and deliver the report: facts, score, supporting case, counter-case, missing data, and a disposition.

🛠️ Self-host

Requirements: Node.js 18+, gmgn-cli 1.6.0 or later, and a GMGN API key.

npm install -g gmgn-cli@latest
git clone https://github.com/agentcitylabs/gmgn-robinhood-mcp.git
cd gmgn-robinhood-mcp
npm install
cp .env.example .env   # then set GMGN_API_KEY
npm start              # HTTP on http://127.0.0.1:3007/mcp

pm2 start ecosystem.config.cjs --env production   # listens on 0.0.0.0:3071
pm2 save

Health check: GET /health returns { "ok": true }. Put a TLS reverse proxy in front of /mcp.

src/
├── index.js     MCP server: tool definitions, HTTP + stdio transports
├── gmgn.js      Read-only gmgn-cli wrapper (chain fixed to robinhood)
└── scoring.js   Deterministic research score
SKILL.md         Agent workflow for this server
server.json      MCP Registry metadata

🛡️ Safety boundary

[!WARNING] Robinhood Chain launchpad tokens are highly speculative. Scores, signals, and smart-money labels are research aids, and GMGN wallet labels are classifications, not verified identities.

• No tool can swap, place orders, create tokens, sign, or touch a wallet.
• Keep GMGN_API_KEY in this service's environment or a secret manager. Never set GMGN_PRIVATE_KEY.
• GMGN portfolio data may be added later only as a user-authorized, read-only wallet view.

📄 License

MIT © 2026 agentcity.lol