io.github.wangjingjing1026uwh-hub/zaoqiniaoer

Zaoqiniaoer MCP — ask a real person who is actually there

An MCP server that lets an AI agent pay a real person in China to go look at something and say what they saw.

Models are good at language and bad at being somewhere. There is no database that holds "is that shop open right now". Someone has to walk over and look.

Two tiers, same pipeline:

Start with the free one. what_can_i_check_myself needs no key, no account and no balance — you can call it right now, before deciding whether this server is worth installing. Most people asking "is this supplier real?" have not yet run a business licence lookup or a reverse image search. Those cost nothing and rule out a lot.

Only when the answer they need is one of the three questions below does sending a person become worth anyone's money.

The three questions desk research cannot answer

These are not a sales pitch. They are what is left over once every free check is done, because every free check is done from a desk:

1. Is there anything at that address today? Companies stay registered long after they stop operating. Nothing you can look up is dated today.
2. Does the sign on the building match the company you are talking to? A different name on the door usually means you are talking to an intermediary.
3. What do people inside say when asked plainly? Not on a prepared video call — in person, unannounced, by someone with no stake in the answer.

• Endpoint: https://zaoqiniaoerhannile.com/api/mcp (Streamable HTTP)
• Operated by 芜湖早起鸟儿智能科技有限公司 (Wuhu, Anhui, China)
• Real end-to-end machine order ran 2026-08-15: ordered, charged, dispatched, report returned — no human in the loop on our side.

Install

Add to your MCP client config:

{
  "mcpServers": {
    "zaoqiniaoer": {
      "type": "http",
      "url": "https://zaoqiniaoerhannile.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sma_live_YOUR_KEY"
      }
    }
  }
}

Get a key at https://zaoqiniaoerhannile.com/developers/register — self-serve, no sales call.

Tools

Five tools: one free check, two ways to order, two ways to read the result. Nothing else — no cancel, no refund, no change_price. Those are irreversible and involve money, so they stay with humans in the web console.

what_can_i_check_myself — free, call this first

No API key. No account. No balance. Nothing is ordered and nobody is sent anywhere.

Returns five checks your user can run from their desk, and — for every single one — what it does not prove. A business licence proves a company was registered; it proves nothing about whether anyone is at that address today.

Telling your user about the paid tiers before they have done the free checks wastes their money and ours.

Human-readable versions of the same list, if you would rather hand your user a page: https://zaoqiniaoerhannile.com/en/supplier-check (English) · https://zaoqiniaoerhannile.com/zi-cha (Chinese)

ask_someone_there — start here

One person who happens to be nearby goes and looks. Hours, not days.

Returns an ask_id. If nobody takes it before it expires, your balance is automatically refunded — you are not charged for a trip nobody made.

verify_place

Three unrelated people go to an address and each report what is there.

Returns an order_id. This spends real money and sends real people outside, so the server instructs models to confirm with the user before calling it.

get_ask_answer / get_verification_result

Look up progress and results, by ask_id and order_id respectively.

Until someone has actually answered, answer is null. That means nobody has been there yet — not "no result". The tool description tells the model, in so many words, not to invent an answer at that point.

What this is not

• Not a quality inspection. We do not examine goods or test samples.
• Not a factory audit. No capacity, certification, or labour assessment.
• Not a credit check. We report what is at the address, not whether they pay debts.

It answers one question well: what is actually there right now, according to someone who went and looked.

Why three people

Fooling three strangers who have never met each other is hard. One person can be mistaken, or talked around at the gate. The three never see each other's answers.

Every verification is permanently attached to that company's public record and cannot be edited or deleted afterwards — including by us, and including by them.

Idempotency

The server derives an idempotency key from (client, arguments, 10-minute window). Models retry. A retry here means sending another human outside and charging you again — so identical calls inside that window return the existing order instead of creating a new one. Over REST you pass your own Idempotency-Key header; it is required, not optional.

Rate limits

30 ordering calls per client per hour. Exceeding it returns a tool error, not a protocol error, so the model can read it and back off.

Docs

• Developer docs: https://zaoqiniaoerhannile.com/developers
• How we decide something is true: https://zaoqiniaoerhannile.com/standard
• Free self-check first: https://zaoqiniaoerhannile.com/en/supplier-check (Chinese: https://zaoqiniaoerhannile.com/zi-cha)
• Machine-readable overview: https://zaoqiniaoerhannile.com/llms.txt

License

MIT for this repository (manifest, docs and examples). The hosted service itself is proprietary.