About Agentcity Robinhood Chain Research
Agentcity Robinhood Chain Research is a read-only MCP server for researching Robinhood Chain tokens, built for Agentcity agents and other MCP clients. Its tools combine launch discovery, market data, due-diligence details, and a deterministic research score; it does not trade or access wallets.
Key features
- 01Discover and screen launchpad tokens
- 02Resolve names and symbols to addresses
- 03Retrieve token research and scoring
- 04View trends, signals, and smart-money trades
- 05Compare tokens and generate daily briefs
Use cases
- 01Find new Robinhood Chain launches
- 02Research a token before human review
- 03Compare contract-address-based research packets
- 04Prepare a scheduled market brief
MCP support
Exposes read-only Robinhood Chain launch, token, market, and research tools to MCP clients. It supports hosted streamable HTTP and local HTTP or stdio transports.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://gmgn.agentcity.lol/mcpclaude mcp add --transport http agentcitylabs-gmgn-robinhood https://gmgn.agentcity.lol/mcp{"mcpServers":{"agentcitylabs-gmgn-robinhood":{"type":"http","url":"https://gmgn.agentcity.lol/mcp"}}}Open in Cursor{"servers":{"agentcitylabs-gmgn-robinhood":{"type":"http","url":"https://gmgn.agentcity.lol/mcp"}}}Open in VS Code{"mcpServers":{"agentcitylabs-gmgn-robinhood":{"type":"http","url":"https://gmgn.agentcity.lol/mcp"}}}{"mcpServers":{"agentcitylabs-gmgn-robinhood":{"serverUrl":"https://gmgn.agentcity.lol/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
10| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | |
| stage | enum | No | new_creation | near_completion | completed |
| launchpads | array | No | Restrict to GMGN launchpad platforms on Robinhood; omit for all launchpads. |
| minLiquidityUsd | number | No |
Details
From the project README
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
| 🚀 Discover launches | New, near-completion, and graduated tokens across Robinhood Chain launchpads, with an optional Pons-only or Trench-only filter. |
| 🔎 Resolve tokens | Turn a name or symbol into candidate contract addresses before any research runs. |
| 🧪 Due diligence | Info, security, pool, holders, and top traders in one call, plus a deterministic research score. |
| 🐋 Smart-money context | Recent trades by GMGN-tagged smart-money and KOL wallets, and GMGN market signals. |
| 📰 Daily brief | New launches and 24h trending in one payload, ready for a scheduled agent run. |
⚡ Quick start
The hosted endpoint is https://gmgn.agentcity.lol/mcp (streamable HTTP). Pick your client:
Claude Code
claude mcp add --transport http agentcity-robinhood https://gmgn.agentcity.lol/mcp
Claude Desktop / claude.ai
Open Settings → Connectors → Add custom connector and paste:
https://gmgn.agentcity.lol/mcp
Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"agentcity-robinhood": {
"url": "https://gmgn.agentcity.lol/mcp"
}
}
}
VS Code (Copilot agent mode)
Add to .vscode/mcp.json:
{
"servers": {
"agentcity-robinhood": {
"type": "http",
"url": "https://gmgn.agentcity.lol/mcp"
}
}
}
Local stdio (any client)
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
| Tool | What it returns | Key inputs |
|---|---|---|
agentcity_list_robinhood_launches | Launchpad tokens by stage | stage, limit, minLiquidityUsd, launchpads |
agentcity_screen_robinhood_launchpads | Launchpad tokens after a GMGN server-side quality preset | profile (safe · smart-money · strict), maxRugRatio, minSmartMoneyCount, launchpads |
agentcity_search_robinhood_token | Candidate tokens for a name, symbol, or address | query |
agentcity_robinhood_trending | Market ranking | interval (1m → 24h), limit |
agentcity_research_robinhood_token | Full due-diligence packet + research score | address, holderLimit |
agentcity_robinhood_token_kline | OHLCV candles | address, resolution (30s → 1d) |
agentcity_compare_robinhood_tokens | Side-by-side packets with scores | addresses (2–5) |
agentcity_robinhood_smart_money | Recent smart-money or KOL trades | source (smartmoney · kol), side, limit |
agentcity_robinhood_signals | GMGN market signals | signalTypes, minMarketCapUsd, maxMarketCapUsd |
agentcity_robinhood_daily_brief | New launches + 24h trending (+ smart money) | launchLimit, trendingLimit, includeSmartMoney |
Input details
stage:new_creation(default),near_completion, orcompleted.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: integers1–13and17–21. GMGN rejects14–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.
| Factor | Weight | Signal |
|---|---|---|
| Data completeness | 20 | Liquidity, holders, top-10 share, and rug ratio are all present |
| Liquidity depth | 25 | Pool liquidity, capped at $50k |
| Holder distribution | 25 | Lower top-10 holder share scores higher |
| Contract safety | 20 | Rug ratio, discounted when source is not verified |
| Activity quality | 10 | Zero when GMGN flags wash trading |
| Disposition | Rule |
|---|---|
| 🟢 Deep research | Score ≥ 70 and no hard flags |
| 🟡 Watchlist | Score 45–69 and no hard flags |
| ⚪ Insufficient data | Score < 45 and no hard flags |
| 🔴 Reject from research queue | Any hard flag: wash trading, rug ratio > 0.3, or top-10 holders > 50% |
Example derived block
{
"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.
- Bring your agent to the city with agentcity.txt.
- Connect this MCP server (see Quick start).
- 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
| Variable | Default | Purpose |
|---|---|---|
GMGN_API_KEY | — | Required. Read-only GMGN API key |
GMGN_CLI_PATH | gmgn-cli | Path to the GMGN CLI binary |
MCP_TRANSPORT | http | http or stdio |
HOST | 127.0.0.1 | HTTP bind address |
PORT | 3007 | HTTP port |
Run in production with pm2
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.
Project layout
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_KEYin this service's environment or a secret manager. Never setGMGN_PRIVATE_KEY. - GMGN portfolio data may be added later only as a user-authorized, read-only wallet view.
📄 License
MIT © 2026 agentcity.lol
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.