{
  "markdown": "# worldku-mcp\n\nThe official MCP server for [Worldku](https://www.worldku.com) memory. Save AI\nconversations into your Worldku memory and recall them back — from Claude Code,\nclaude.ai, ChatGPT, Codex, Gemini CLI, or any other MCP client.\n\n**Full setup guide: [worldku.com/docs/mcp](https://www.worldku.com/en/docs/mcp)** —\nstep-by-step instructions for every client, authentication details, and\ntroubleshooting. The same page in raw Markdown for AI agents:\n[worldku.com/docs/mcp.md](https://www.worldku.com/docs/mcp.md).\n\nThe fastest way to set up: paste this into your AI tool and let it walk you\nthrough —\n\n> I want to give you long-term memory with Worldku. Read\n> https://www.worldku.com/docs/mcp.md and walk me through connecting it, in\n> your own words.\n\n**Hosted service.** The public endpoint is `https://mcp.worldku.com/mcp`. This\nrepository is the open access layer only: the memory extraction pipeline, prompt\nrules, and platform services run on Worldku's infrastructure. Self-hosting this\nworker will not give you a working service — it exists for transparency and\nreview, and connects to backends that require Worldku credentials.\n\n## Tools\n\n| Tool | What it does | Cost |\n|---|---|---|\n| `memory_overview` | Most recent memories, one line each (zero parameters) | 1 read |\n| `memory_search` | Semantic search over your memories | 1 read |\n| `memory_recall` | Filtered recall: time range / type / source, paginated | 1 read |\n| `memory_save` | Save the current conversation transcript for memory extraction | 1 save |\n\nAll tools fire only on your explicit ask — the tool descriptions instruct the\nmodel never to call them from ambient association. Saved transcripts go through\nWorldku's normal import pipeline: extraction runs asynchronously and new\nmemories land in your [memory workbench](https://www.worldku.com) marked unread.\nRe-saving the same conversation is deduplicated server-side; extending a\npreviously saved conversation appends only the new tail.\n\n## Connecting\n\nTwo authentication routes:\n\n- **OAuth 2.1** — claude.ai and ChatGPT need no key at all: point them at the\n  server URL and sign in at worldku.com when prompted.\n- **Access key** — CLI clients use a `wk_mcp_…` key, minted at\n  [worldku.com → Memory manager → AI tools](https://www.worldku.com/en/memorymanage?tab=connect).\n  The key is shown once at mint time; up to 20 keys per account, each\n  independently revocable.\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http --scope user worldku https://mcp.worldku.com/mcp \\\n  --header \"Authorization: Bearer wk_mcp_YOUR_KEY\"\n```\n\nTo keep the key out of the config file, export `WORLDKU_MCP_KEY` in your shell\nprofile and use single quotes: `--header 'Authorization: Bearer ${WORLDKU_MCP_KEY}'`.\n\n### claude.ai (web, desktop, mobile)\n\nSettings → Connectors → Add → **Add custom connector** →\n`https://mcp.worldku.com/mcp` → sign in at worldku.com. No key needed.\n\n### ChatGPT (web)\n\nEnable **Developer mode** (Settings → Security and login), then create an app\nat [chatgpt.com/plugins](https://chatgpt.com/plugins) with the server URL and\nOAuth authentication. Sign in at worldku.com when prompted.\n\n### Codex CLI\n\n```bash\nexport WORLDKU_MCP_KEY=wk_mcp_YOUR_KEY\ncodex mcp add worldku --url https://mcp.worldku.com/mcp --bearer-token-env-var WORLDKU_MCP_KEY\n```\n\n### Gemini CLI\n\n```json\n// ~/.gemini/settings.json — note the httpUrl field name\n{\n  \"mcpServers\": {\n    \"worldku\": {\n      \"httpUrl\": \"https://mcp.worldku.com/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer wk_mcp_YOUR_KEY\" }\n    }\n  }\n}\n```\n\n### Any other MCP client\n\nAny client that supports Streamable HTTP with a custom header works:\n\n- URL: `https://mcp.worldku.com/mcp`\n- Header: `Authorization: Bearer wk_mcp_YOUR_KEY`\n\nThe config field holding the URL varies by client (`url` for most, `httpUrl`\nfor Gemini CLI, `serverUrl` for some others) — a wrong field name usually makes\nthe client ignore the server silently. More examples in [`examples/`](examples/)\nand in the [full guide](https://www.worldku.com/en/docs/mcp).\n\n## Protocol\n\n- Native MCP revision **2026-07-28** (stateless Streamable HTTP): per-request\n  metadata, no sessions, no SSE streams — every response is a single JSON\n  object.\n- Dual-era: the **2025-11-25** initialize-handshake era is also served (still\n  statelessly — no session ids, no SSE), because that is what current-generation\n  clients speak. This leg will be dropped once the client ecosystem moves to\n  2026-07-28.\n- `server/discover`, `tools/list`, `tools/call`, and the\n  [Tasks extension](https://modelcontextprotocol.io/extensions/tasks/overview)\n  (`tasks/get` / `tasks/update` / `tasks/cancel`) for async save polling.\n  Clients that do not declare the extension get synchronous receipts instead.\n- OAuth 2.1 resource server per the MCP authorization spec: RFC 9728 protected\n  resource metadata at `/.well-known/oauth-protected-resource`, audience-bound\n  opaque tokens, `memory:read` / `memory:write` scopes. The authorization\n  server (worldku.com) supports Client ID Metadata Documents and PKCE `S256`.\n- Discovery (SEP-2127 experimental): Server Card at\n  [`/mcp/server-card`](https://mcp.worldku.com/mcp/server-card), AI Catalog at\n  [`/.well-known/ai-catalog.json`](https://mcp.worldku.com/.well-known/ai-catalog.json).\n\n## Limits\n\n- 200 reads and 50 saves per user per day (anti-abuse caps, reset at 00:00 UTC).\n- 10 MB per request.\n- Reads and saves each book one usage action on your Worldku account. MCP\n  access is included with every Worldku plan, including Free.\n\n## Development\n\n```bash\npnpm install\npnpm test        # vitest\npnpm type-check\npnpm lint\n```\n\nDeployment (Cloudflare Workers) is done by the Worldku team — see\n`wrangler.toml` for the binding surface (no secrets live in this repo).\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 5790,
  "sha": "bad0f5c03f945a4f090b589c63cddb5593b92858ab69a3d0512c9e74455b0980",
  "repo_slug": "mnemosics/worldku-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_worldku_memory_1f1bd2ec/readme"
}