LobsterMCP

OpenClaw documentation, queryable by AI agents — so Claude Code stops guessing and starts knowing.

Author: Osama · License: MIT · Unofficial community tool, not affiliated with or endorsed by OpenClaw.

---

What is this?

OpenClaw is an AI agent platform for connecting LLMs to messaging channels, tools, and services. When Claude Code (or any AI agent) works on an OpenClaw project, it needs to look things up constantly: How do I configure a model? What's the JSON5 syntax for provider auth? How do I set up multi-agent routing?

LobsterMCP is an MCP server that puts the full OpenClaw documentation directly in front of your agent — 194 entries across 13 topics, indexed with BM25 search. No web lookups, no hallucinations, no asking the user to go find the docs.

---

Installation

Option 1 — Claude Code (local build)

git clone https://github.com/osamac2128/lobstermcp
cd lobstermcp
npm install && npm run build
claude mcp add lobster-mcp -s user -- node /absolute/path/to/lobstermcp/dist/index.js

Option 2 — Claude Code settings.json

{
  "mcpServers": {
    "lobster-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/lobstermcp/dist/index.js"]
    }
  }
}

---

Tools

resolve-topic

Finds the right documentation topic for your query. Call this first.

Input:  { query: "models" }

Output: {
  topics: [{
    topicId: "models",
    name: "Models & Model Selection",
    description: "Configuring primary models, fallbacks, allowlists...",
    entryCount: 5,
    confidence: 1.0,
    relatedTopics: ["providers", "configuration", "agents"]
  }]
}

query-config-docs

Returns full documentation and code examples for your query.

Input:  { query: "set primary model anthropic", topicId: "models" }

Output: Markdown with full docs, config snippets, CLI examples, and source URLs

---

Topics

Topic ID	Entries	Covers
models	5	Primary model, fallbacks, allowlists, aliases, /model command
providers	18	Anthropic, OpenAI, OpenRouter, Ollama, GLM, GitHub Copilot, and more
configuration	5	openclaw.json config file, JSON5 format, all config keys, config.patch/config.apply
gateway	21	Running the gateway, remote access, pairing, protocol, multiple gateways, ACP bridge
agents	20	Agent runtime, workspaces, AGENTS.md/SOUL.md/TOOLS.md, multi-agent routing
sessions	6	Session keys, compaction, pruning, session store
tools	16	exec, browser, web search, agent-send, slash commands, llm-task, subagents
skills-plugins	10	Creating skills (SKILL.md format), plugin manifest, ClawdHub registry
channels	23	Telegram, Discord, Slack, WhatsApp, Matrix, Signal, iMessage, and more
install	23	Installation, onboarding wizard, Docker, updating, platform guides
concepts	23	Memory, system prompts, context, streaming, queue, retry, usage tracking
security-sandbox	11	Sandboxing, elevated tools, exec approvals, tool policies
debugging	13	openclaw doctor, logs, health checks, FAQ, common issues

13 topics · 194 documentation entries

---

Example queries

resolve-topic: "how to configure a model"
→ topicId: "models"

query-config-docs: "set primary model anthropic claude", topicId: "models"
→ Full docs on agents.defaults.model.primary, fallbacks, allowlist config

resolve-topic: "anthropic api key"
→ topicId: "providers"

query-config-docs: "anthropic setup-token auth", topicId: "providers"
→ Full docs on setup-token vs API key, onboarding wizard, config snippet

resolve-topic: "run gateway background"
→ topicId: "gateway"

query-config-docs: "multi-agent routing bindings", topicId: "agents"
→ Full docs on agents.list, bindings, agentId, isolated workspaces

---

Architecture

• Search — BM25 in-memory search with Porter stemmer and field boosting (title 3×, tags 2×, description 1.5×)
• Storage — Static JSON files loaded at startup, zero runtime dependencies
• Transport — MCP stdio transport (works with any MCP-compatible client)
• Content — Sourced from official OpenClaw documentation

lobstermcp/
├── src/
│   ├── index.ts              # MCP server entry point
│   ├── tools/
│   │   ├── resolve-topic.ts  # Topic resolution tool
│   │   └── query-docs.ts     # Doc search tool
│   ├── search/
│   │   ├── engine.ts         # BM25 search engine
│   │   └── tokenizer.ts      # Porter stemmer tokenizer
│   └── store/
│       ├── index.ts          # DocStore class
│       ├── loader.ts         # Content file loader
│       └── types.ts          # Shared types
├── content/                  # Documentation JSON (13 files + topics.json)
└── scripts/
    └── build-openclaw-content.mjs  # Regenerate content from OpenClaw source

---

Updating the content

Content is generated from the OpenClaw source docs. To regenerate:

# Requires openclaw source at ../openclaw (relative to this repo)
node scripts/build-openclaw-content.mjs
npm run build

---

Development

npm install      # Install dependencies
npm run build    # Compile TypeScript
npm run dev      # Watch mode
npm start        # Run server

---

Requirements

• Node.js 18+
• Any MCP-compatible client (Claude Code, Claude Desktop, etc.)

---

License

MIT — © Osama