Show HN: A stateless MCP server over our docs – search, list_topics, get_article

Developer docs

Wire 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.

Chinaready MCP server #

The 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.

https://mcp.chinaready.co/mcp - No sign-in — no keys, no OAuth

• Read-only: 3 tools

• Rate limited, ~120 requests/minute

• MIT, open source

• searchSemantic search across the whole library. Returns sourced excerpts, each citing its full chinaready.co URL.

• list_topicsEnumerates the topic taxonomy the library is organized by — useful for scoping a research session.

• get_articleFetches a full article by its chinaready.co URL, as clean markdown.

Connect your client #

One-click where the client supports it; everywhere else it is a URL paste.

• 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

       the generic config under “Any other MCP client”.
  

• VS Code One-clickOpens the VS Code MCP install prompt (stable and Insiders). The server then appears in Copilot Chat’s tool list.

• Claude

1. Settings → Customize →Connectors →+ Add
2. Choose Add custom connector
3. Paste https://mcp.chinaready.co/mcp
4. Authentication: choose No sign in , thenAdd Works on web and desktop. Free plans hold one custom connector — use it wisely.

• Settings →

• Claude CodeOne command, per project or global:

claude mcp add --transport http chinaready https://mcp.chinaready.co/mcp

• ChatGPT

1. Open chatgpt.com/plugins →+
2. Choose Add custom MCP server
3. Paste https://mcp.chinaready.co/mcp →Create as a plugin

• Open

• Any other MCP clientWindsurf, Zed, LibreChat, opencode… Remote server — no command, no keys. Windsurf calls the same field serverUrl .

{"mcpServers":{"chinaready":{"url":"https://mcp.chinaready.co/mcp"}}}

REST APIs #

Form submissions and search over plain HTTP. The OpenAPI description (/openapi.json) is the machine-readable source of truth for all of them.

• POST /api/contactSend a contact-form submission. Returns 201 with a received confirmation; Chinaready responds within 24 hours. Prefer the human form?/contact/ .
• name
• message
• company
• timezone

{"name":"Ada Lovelace","email":"[email protected]","message":"We are evaluating ICP filing options."}

• POST /api/intakeSubmit a market-readiness intake. Returns 201 with auto-scored fields. Human form:/intake/ .
• top-level or basics.email

{"email":"[email protected]","company":"Example Ltd","timeline":"6-12 months"}

• 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 whoseurl is theabsolute chinaready.co page link — cite that URL in answers.

{"messages":[{"role":"user","content":"How long does ICP filing take?"}]}

• 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/ and the insights catalog’s AI matches.

{"query":"icp filing timeline"}

For agents & machines #

Discovery entry points in use on this site — all live, no authentication.