{"slug": "show-hn-a-stateless-mcp-server-over-our-docs-search-list-topics-get-article", "title": "Show HN: A stateless MCP server over our docs – search, list_topics, get_article", "summary": "Chinaready launched a stateless, read-only MCP server at https://mcp.chinaready.co/mcp that exposes its China go-to-market research library to any MCP-capable client without API keys, OAuth or sign-in. The server offers three tools — search, list_topics and get_article — is rate limited to roughly 120 requests per minute, runs on Chinaready's own open-source Cloudflare Worker, and is released under the MIT license, with every returned excerpt citing a full chinaready.co URL. Chinaready also published REST endpoints for contact and intake form submissions and search, plus an OpenAPI description at /openapi.json as the machine-readable source of truth.", "body_md": "Developer docs\n\n# Public APIs & MCP server\n\nWire Chinaready’s China go-to-market knowledge into your AI tools, or POST straight to our public form and search endpoints. No API keys, no sign-in.\n\n## Chinaready MCP server\n\nThe research library behind this site — insights and handbooks on China market entry — exposed as a read-only MCP server. Connect it to any MCP-capable client and every answer cites a full chinaready.co URL. Runs on our own open-source Cloudflare Worker.\n\n`https://mcp.chinaready.co/mcp`  - No sign-in — no keys, no OAuth\n- Read-only: 3 tools\n- Rate limited, ~120 requests/minute\n- MIT, open source\n\n-  ### searchSemantic search across the whole library. Returns sourced excerpts, each citing its full chinaready.co URL.\n-  ### list_topicsEnumerates the topic taxonomy the library is organized by — useful for scoping a research session.\n-  ### get_articleFetches a full article by its chinaready.co URL, as clean markdown.\n\n## Connect your client\n\nOne-click where the client supports it; everywhere else it is a URL paste.\n\n-  ### Cursor One-clickThe button opens Cursor with the server pre-configured — nothing to type. Prefer manual? Add the same server to `~/.cursor/mcp.json` — see\n            the generic config under “Any other MCP client”.\n-  ### VS Code One-clickOpens the VS Code MCP install prompt (stable and Insiders). The server then appears in Copilot Chat’s tool list.\n-  ### Claude\n  1. Settings → *Customize* →*Connectors* →*+ Add*\n  2. Choose *Add custom connector*\n  3. Paste `https://mcp.chinaready.co/mcp`\n  4. Authentication: choose *No sign in* , then*Add*\n Works on web and desktop. Free plans hold one custom connector — use it wisely.\n- Settings → \n-  ### Claude CodeOne command, per project or global: \n\n```\nclaude mcp add --transport http chinaready https://mcp.chinaready.co/mcp\n```\n\n-  ### ChatGPT\n  1. Open `chatgpt.com/plugins` →*+*\n  2. Choose *Add custom MCP server*\n  3. Paste `https://mcp.chinaready.co/mcp` →*Create as a\n              plugin*\n- Open \n-  ### Any other MCP clientWindsurf, Zed, LibreChat, opencode… Remote server — no command, no keys. Windsurf calls the same field `serverUrl` .\n\n```\n{\"mcpServers\":{\"chinaready\":{\"url\":\"https://mcp.chinaready.co/mcp\"}}}\n```\n\n## REST APIs\n\nForm submissions and search over plain HTTP. The\n[OpenAPI description](https://chinaready.co/openapi.json) (`/openapi.json`) is\n        the machine-readable source of truth for all of them.\n\n-  POST /api/contactSend a contact-form submission. Returns `201` with a received\n            confirmation; Chinaready responds within 24 hours. Prefer the human form?[/contact/](https://chinaready.co/contact/) .\n  - name\n  - message\n  - company\n  - timezone\n \n\n```\n{\"name\":\"Ada Lovelace\",\"email\":\"[email protected]\",\"message\":\"We are evaluating ICP filing options.\"}\n```\n\n-  POST /api/intakeSubmit a market-readiness intake. Returns `201` with auto-scored\n            fields. Human form:[/intake/](https://chinaready.co/intake/) .\n  - top-level or basics.email\n \n\n```\n{\"email\":\"[email protected]\",\"company\":\"Example Ltd\",\"timeline\":\"6-12 months\"}\n```\n\n-  POST https://search.chinaready.co/search Cloudflare AI SearchAI retrieval over the same corpus the Ask AI panel uses — no authentication. Retrieval only: bring your own model. Each returned excerpt begins with a `url` /`title` /`type` source header whose`url` is the**absolute chinaready.co page link** —\n            cite that URL in answers.\n\n```\n{\"messages\":[{\"role\":\"user\",\"content\":\"How long does ICP filing take?\"}]}\n```\n\n-  POST /api/searchSite-search proxy over the same corpus: returns article-level results (title, snippet, relevance score), ranked by best match — no generation. Powers [/search/](https://chinaready.co/search/) and the insights catalog’s AI matches.\n\n```\n{\"query\":\"icp filing timeline\"}\n```\n\n## For agents & machines\n\nDiscovery entry points in use on this site — all live, no authentication.", "url": "https://wpnews.pro/news/show-hn-a-stateless-mcp-server-over-our-docs-search-list-topics-get-article", "canonical_source": "https://chinaready.co/docs/api/", "published_at": "2026-10-22 07:24:04+00:00", "updated_at": "2026-10-22 07:41:31.640356+00:00", "lang": "en", "topics": ["agent-protocols", "ai-tools", "ai-agents", "developer-tools"], "entities": ["Chinaready", "Model Context Protocol", "Cloudflare Workers", "Cursor", "VS Code", "Claude", "ChatGPT"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/show-hn-a-stateless-mcp-server-over-our-docs-search-list-topics-get-article", "markdown": "https://wpnews.pro/news/show-hn-a-stateless-mcp-server-over-our-docs-search-list-topics-get-article.md", "text": "https://wpnews.pro/news/show-hn-a-stateless-mcp-server-over-our-docs-search-list-topics-get-article.txt", "jsonld": "https://wpnews.pro/news/show-hn-a-stateless-mcp-server-over-our-docs-search-list-topics-get-article.jsonld"}}