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

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.

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.

Copy

Add to Cursor

Add to VS Code

No sign-in — no keys, no OAuth

Read-only: 3 tools

Rate limited, ~120 requests/minute

MIT, open source

Listed on

search

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

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

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

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

Cursor

One-click

The button opens Cursor with the server pre-configured — nothing to type.

Add to Cursor

Prefer manual? Add the same server to ~/.cursor/mcp.json — see the generic config under “Any other MCP client”.

VS Code

One-click

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

Add to VS Code

Claude

Settings → Customize → Connectors → + Add

Choose Add custom connector

Paste https://mcp.chinaready.co/mcp

Authentication: choose No sign in, then Add

Works on web and desktop. Free plans hold one custom connector — use it wisely.

Claude Code

One command, per project or global:

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

Copy

ChatGPT

Open chatgpt.com/plugins → +

Choose Add custom MCP server

Paste https://mcp.chinaready.co/mcp → Create as a plugin

Any other MCP client

Windsurf, Zed, LibreChat, opencode… Remote server — no command, no keys. Windsurf calls the same field serverUrl.

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

Copy

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.

Send a contact-form submission. Returns 201 with a received confirmation; Chinaready responds within 24 hours. Prefer the human form? /contact/.

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

Copy

JSON body OpenAPI spec Human form

Submit a market-readiness intake. Returns 201 with auto-scored fields. Human form: /intake/.

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

Copy

JSON body OpenAPI spec Human form

Cloudflare AI Search

AI 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 — cite that URL in answers.

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

Copy

~120 requests/minute POST only OpenAPI spec

Site-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"}

Copy

~30 searches / 10 minutes, per IP OpenAPI spec Try it in the UI

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

/openapi.json OpenAPI 3 description of every endpoint.

/.well-known/api-catalog Linkset service catalog.

/.well-known/mcp/server-card.json MCP server card.

/llms.txt Curated content index for LLMs.

/.well-known/agent-card.json Agent card (A2A transport: planned).

github.com/chinaready/mcp MCP server source (MIT).

smithery.ai/server/@chinaready/search Smithery directory listing.