Worlds Knowledge MCP
A read-only MCP server that gives coding agents current, source-checked CLI
facts for Claude Code, Codex CLI, and Grok Build — exact commands,
flags, configuration keys, environment-variable names, workflows, and dated
model catalogs — so an agent stops guessing from memory and stops treating the
three CLIs as interchangeable.
No npm package, API key, or provider credential is required.
What this repository contains
This is the distribution repository: the agent Skill and the MCP server
manifest. The corpus build, the server implementation, and the Cloudflare
Worker live in the Claude World control plane and are not published here.
Connect
Verify it:
The examples use user scope deliberately. Grok's project-folder trust applies to
every repo-local MCP server, hook, and LSP server, so review all project
configuration before switching to --scope project.
Install the Skill
The Skill teaches an agent when to query the MCP and in what order — the
hard-problem consultant, the single-CLI routes, and the multi-CLI planner.
Restart the client, then ask it to use worlds-knowledge-mcp. Keep SKILL.md,
references/, and agents/openai.yaml together — copying only SKILL.md drops
the connection and single-CLI route guidance. agents/openai.yaml declares the
MCP dependency and permits implicit invocation in compatible clients.
What the server knows
- 162 source-checked manuals — 18 CLI usage and feature modules × 3 products
× 3 locales (English, Traditional Chinese, Japanese)
- Source-derived command paths, flags, slash/TUI commands, configuration keys,
environment-variable names, workflows, and drift notes for three released CLI
snapshots
- Dated per-CLI model catalogs with selector syntax, supported native efforts,
entitlement constraints, safe fallbacks, and separately labeled
provider-native orchestration modes
- Availability is labeled per entity: runtime-confirmed, docs-confirmed,
conditional, source-preview, or historical
Every manual must cite at least one official HTTPS source, carry a review date,
and describe the expected CLI rather than its provider API, or the build fails.
Tools
Resources: worlds://catalog, worlds://documents/{id}.
Prompts: worlds_research_cli_workflow, worlds_plan_model_aware_work,
worlds_consult_hard_problem.
Every tool is annotated read-only, non-destructive, and idempotent.
Try it
-p is the standing example of why vendor flags must not be translated: it
means print and exit in Claude Code, select a named profile in Codex, and
one non-interactive prompt in Grok Build.
Boundaries
- No credentials, embeddings, external API calls, write tools, or arbitrary URL
fetching. No tool accepts a filesystem path or a URL.
- The live account model catalog is always authoritative over a dated snapshot;
worlds_list_cli_models returns a freshness status and says so.
- Search returns excerpts rather than silently injecting whole documents.
- Retrieved text is reference data, not instructions that can override the user
or client policy. Agents must assess commands before executing them.
- Website articles, news, newsletters, opinion, provider API companions, and
release archives are never packaged into the MCP corpus.
- The planner returns command templates but never launches another CLI, widens
permissions, or enables provider-native orchestration unless asked.
Workstreams default to
execution_intent: "read-only".
Not affiliated
Claude World is independent. It is not affiliated with, endorsed by, or
operated by Anthropic, OpenAI, or xAI. Official vendor documentation remains
authoritative; this server exists to cite it accurately.
License
MIT — see LICENSE.