Ninjabuy logoBusiness

API & MCP

Let your own AI run your NinjaBuy account.

NinjaBuy has an MCP server. Connect any AI app that speaks MCP and it can look up your orders, see what's in our warehouse, read products and fill your cart, signed in as you.

Contact salesHow it works
mcp · ninjabuy.com/mcpsample

What's waiting in the warehouse?

→ warehouse()

Mesh running shoes · 42QC done · 3 photos
Ribbed glass cup · Set of 4Arrived · 0.62 kg
Striped canvas toteIn a shipment

Three items are in. The shoes passed QC with three photos, the cups are weighed, and the tote is already in a shipment. Ship the other two from your warehouse page.

list_ordersorderwarehouseproductadd_to_cart

How it works

Connect once, sign in, ask.

The MCP server uses your NinjaBuy sign-in and asks your consent. The API covers the same ground for your own code and plugins.

  1. Add NinjaBuy's MCP server

    Paste the server address into your AI app's connector settings.

  2. Sign in and approve

    Your AI acts on your account only after you say yes.

  3. Ask in plain words

    Where's order 1012? What's waiting at QC? Add this link to my cart.

Read the step-by-step guide

What you get

Five tools, plus the API.

  • list_orders

    Your orders, newest first, with status and what's still due.

  • order

    One order in full: items and prices, arrivals, the shipment and its tracking.

  • warehouse

    Every item that has arrived: QC photos, weight, and whether it's in a shipment.

  • product

    Any product link read out: variants, CN¥ prices, stock.

  • add_to_cart

    Put variants in your cart. Paying stays with you.

  • The API

    The same ground over HTTPS, for plugins and your own code.

Good to know

Your agent, your account.

Set an AI up the way you'd set up a new hire: clear limits, and you check its work.

  • It acts as you

    Whatever your AI does through NinjaBuy is done on your account.

  • Nothing moves money

    No tool pays, ships or spends your balance. Checkout and shipping stay on pages you open yourself.

  • Revoke any time

    Remove the connection from your account and its access ends.

  • AI gets things wrong

    Check what your agent tells you before you act on it, prices and stock above all.

What one order costs

What your agent's cart will cost at checkout.

The agent fills the cart; you pay. One order, worked out with the fees and the shipping rate we charge today.

An example: the product, its price and its weight are made up. The fees, the tax and the shipping rate are the ones we charge today. Shipping is priced on the weight we measure in our warehouse. Your channel's own fees and your selling price aren't in it.

See pricingEvery fee, in the docs
Ionic hair dryer · White
Shipped to a buyer in the US
Example

When the order is paid

Goods1 × CN¥96.00 at the seller
CN¥96.00
Intake fee1 item group
CN¥12.00
Tax14% flat, on the two lines above
CN¥15.12

When the parcel ships

Shipping to the USNinja Saver line, 0.8 kg
CN¥84.00
Handling1 parcel
CN¥50.00
Tax14% flat, on the two lines above
CN¥18.76
This order, deliveredCN¥275.88≈ $44.22

Docs

Go deeper in the docs.

FAQ

Questions sellers ask

Which AI apps work?
Any app that connects to a remote MCP server with sign-in.
Is it free?
Yes. The MCP server and the API cost nothing; you pay for what you buy and ship.
Can my agent place orders?
It can fill your cart. Paying and shipping stay with you.
Is there a REST API?
Yes, for plugins and your own code: orders, products and tracking.
Do I need to code?
Not for MCP. You paste an address and sign in.
What can't it do yet?
Pay, cancel or place a shipment. Tell us what you'd want next.

Contact sales

Put your AI to work on your orders.

Tell us what you'd like it to handle. We'll set up access and show you the tools.

Contact salesSee pricing
  • We look at what you sell and where it comes from.
  • We set up your box, labels and shipping lines.
  • You connect your store and orders start coming in.