Model Context Protocol (MCP) Server

Connect ChainLens directly to agentic environments like Claude Code, Cursor, Windsurf, or Zed. Published as an open stdio server package on npm: chainlens-research.

Client Quick Setup

Claude Code Setup

Run from your terminal:

claude mcp add chainlens-research \
  -- env CHAINLENS_API_KEY=clrs_<your-key> \
  MCP_API_URL=https://research-api.chainlens.net \
  MCP_TIMEOUT=300000

Cursor / ~/.claude.json Config

Add to config file:

"chainlens-research": {
  "command": "npx",
  "args": ["-y", "chainlens-research"],
  "env": {
    "CHAINLENS_API_KEY": "clrs_<your-key>",
    "MCP_API_URL": "https://research-api.chainlens.net",
    "MCP_TIMEOUT": "300000"
  }
}

Tools Catalog

Tool Name	Capability	Latency	Recommended Timeout
chainlens_search	Raw multi-engine web search without LLM synthesis	2–10s	60s
chainlens_ask	Q&A with web grounding — depth=fast: single-pass; depth=deep: multi-step reasoning; depth=research: exhaustive multi-source report, quality mode, 1,500+ words (60–180s, timeout ≥300s)	10–180s	≥120s
chainlens_wide_research	Comparative matrix across up to 50 entities with citations	60–120s	≥300s
chainlens_contents	Token-efficient web extraction & markdown conversion from URLs	2–15s	60s
chainlens_code_search	High-signal code snippet retrieval across GitHub, docs & registries	5–20s	60s
chainlens_chats	List research chat sessions or read one session history (pass chatId)	<5s	30s
chainlens_monitor	Manage recurring monitors — action=create/trigger (requires monitorId for trigger), or action=list/get/delete/runs for CRUD	<5–30s	60s
chainlens_pulse	Pulse news feed (action=feed) or angle-based deep research (action=research with itemId + angleId)	<5–180s	≥300s (research)
chainlens_usage	Credit balance (action=balance) or recent credit transactions (action=ledger, optional limit param)	<5s	30s
chainlens_discover	Discover trending articles by topic (tech, ai, finance, science, security, startup) — public endpoint, no auth required	<5s	30s
chainlens_evidence	Evidence pack for a completed message — claims, confidence scores, source citations (messageId UUID required)	<5s	30s

Timeout Configuration

Crucial Timeout Setting: Most MCP clients default to a 60s timeout. Intensive tools like chainlens_ask (depth=deep), chainlens_ask (depth=research), and chainlens_wide_research perform deep multi-page crawls and synthesize large reports, which require setting MCP_TIMEOUT=300000 (5 minutes) in your MCP environment.