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

> Source: <https://chinaready.co/docs/api/>
> Published: 2026-10-22 07:24:04+00:00

Developer docs

# Public APIs & MCP server

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* , then*Add*
 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](https://chinaready.co/openapi.json) (`/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/](https://chinaready.co/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/](https://chinaready.co/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 whose`url` is the**absolute 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/](https://chinaready.co/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.