AI integration · MCP connector · REST API

Run your China fulfilment from Claude, Cursor or any AI agent

Create an API key, plug in our MCP connector and ask your AI assistant about orders, stock, balance and shipping costs in plain English. Read-only by default, scoped per key and free for every account.

Create an API key See how it works

MCPClaude, Cursor and more

8 toolsorders, stock, balance, rates

Read-onlyby default, scoped keys

Freefor every account

What you can ask

Your fulfilment data, one question away

The assistant picks the right tool, calls our API with your key and answers with live data from our warehouse.

“Which SKUs have fewer than 10 units left in the warehouse?”

list_inventory

“Show me last week’s unpaid orders and the total amount due.”

list_orders

“Is my balance enough to pay order 10293?”

get_balance + get_order

“What does it cost to ship 2 × SKU-123 to Toronto, and how long does it take?”

list_shipping_rates

“Where is order #1045? Give me the tracking number.”

get_order

“Pay order 10293 from my balance.”

pay_order (opt-in scope)

Tools & scopes

What the connector can do

Each MCP tool maps one-to-one to a REST endpoint and needs a matching scope on the API key.

Tool	Scope	What it returns
`list_orders / get_order`	`orders:read`	Orders with status, items, Shopify/WooCommerce order numbers, amounts in USD, shipping method and tracking numbers.
`list_inventory / get_inventory`	`inventory:read`	Stock held in our warehouses per SKU, low-stock filters and the inventory ledger.
`get_balance / list_billing`	`balance:read`	Wallet balance and billing history for any date range.
`list_shipping_rates`	`rates:read`	Live shipping options, prices and delivery days for your SKUs to any country and postcode.
`pay_order`	`orders:pay`	Pay an order from your balance. Off by default, idempotent and rate-limited.

Setup

Connect your AI assistant in four steps

Create a free account
Sign up at app.honestfulphilment.com and connect your Shopify or WooCommerce store.
Create an API key
Open Settings → API Keys, name the key (e.g. “Claude Desktop”), pick its scopes and, optionally, limit it to one store.
Add the MCP connector
Download the MCP connector below, run npm install and add it to Claude Desktop, Claude Code or Cursor with your key.
Ask in plain English
Your assistant now calls our tools directly: no exports, no spreadsheets, no switching tabs.

Claude Desktop config

Unzip the MCP connector, run npm install, then add this to claude_desktop_config.json (Cursor: ~/.cursor/mcp.json). Requires Node.js 18+.

{
  "mcpServers": {
    "hf": {
      "command": "node",
      "args": ["/path/to/hf-claude-mcp/src/index.js"],
      "env": { "HF_API_KEY": "YOUR_API_KEY" }
    }
  }
}

REST API for developers

Prefer your own scripts or agents? Call the same endpoints directly.

BASE=https://api.honestfulphilment.com/connector/v1
KEY=YOUR_API_KEY

curl -H "x-key: $KEY" "$BASE/balance"
curl -H "x-key: $KEY" "$BASE/orders?status=NOT_PAID"

Base URL https://api.honestfulphilment.com, paths under /connector/v1
Auth header x-key, 60 requests per minute per key
OpenAPI 3 spec and agent guide

MCP connector (zip) ↓

Node.js 18+ stdio server with README and docs

OpenAPI 3 spec ↓

Machine-readable contract for every endpoint

Agent guide ↓

Short Markdown brief for LLMs and agents

Open Settings → API Keys Create free account

API reference

REST endpoints

Base URL https://api.honestfulphilment.com/connector/v1. Send your key in the x-key header. Responses use the envelope { status, data, errorCode, errorMessage, pageIndex, pageSize, totalCount }; amounts are in USD. Full schemas are in the OpenAPI spec.

Method	Path	Scope	Description
`GET`	`/orders`	`orders:read`	List orders. Filters: status, orderNo, sku, time range, page, pageSize (max 100).
`GET`	`/orders/{id}`	`orders:read`	One order by HF id or order number, with items, address, amounts (USD) and tracking.
`POST`	`/orders/{id}/pay`	`orders:pay`	Pay from balance. Body: idempotencyKey (required), confirmAmount (optional).
`GET`	`/inventory`	`inventory:read`	Warehouse stock per SKU. Filters: keyword, maxQuantity, warehouseCode.
`GET`	`/inventory/{sku}`	`inventory:read`	One SKU; includeLogs=true adds the inventory ledger.
`GET`	`/balance`	`balance:read`	Wallet balance and recent billing.
`GET`	`/billing`	`balance:read`	Billing history between startTime and endTime.
`GET`	`/shipping-rates`	`rates:read`	Shipping options: countryCode, postCode, items=SKU:qty,SKU:qty.

Safety

Built for agents, with guard rails

Read-only scopes by default; payments are a separate opt-in
Keys can be limited to a single store and revoked instantly
Payments need a unique idempotency key and an optional amount check
Rate limits of 60 calls per minute per key and 10 payments per minute
The full key is shown only once and never includes your login

Works with your store

Orders from Shopify and WooCommerce stores are available through the same key, with the original platform order numbers.

Behind it: a real warehouse

The data comes from our own China warehouse, sourcing and QC teams. See our services →

FAQ

AI integration questions

Which AI tools can connect to Honest FulPhilment?

Any client that supports the Model Context Protocol (MCP), including Claude Desktop, Claude Code and Cursor. Developers and other agents can call the same REST API directly with an API key, using our OpenAPI 3 specification.

Can the AI spend my money?

Not unless you allow it. New API keys are read-only by default. Paying orders needs the separate orders:pay scope, every payment requires a unique idempotency key and the pay endpoint is limited to 10 calls per minute.

Is it safe to give an AI assistant an API key?

Each key has only the scopes you choose, can be limited to a single store and can be revoked instantly in Settings → API Keys. Keys are separate from your login session, so the assistant never sees your password.

How much does the AI integration cost?

Nothing. API keys, the MCP connector and the REST API are free for every Honest FulPhilment account. You only pay for products, fulfilment and shipping as usual.

Is there a REST API for developers?

Yes. The base URL is https://api.honestfulphilment.com, endpoints live under /connector/v1 and authentication uses the x-key header. Each key is limited to 60 requests per minute and lists return up to 100 records per page. The OpenAPI 3 spec is public at honestfulphilment.com/ai/openapi-v1.yaml.

Does it work with both Shopify and WooCommerce stores?

Yes. Orders from every connected Shopify and WooCommerce store are available through the same key, including the original platform order numbers.

Start fulfilling your Shopify and WooCommerce orders from China

Free to connect. Set up your store in minutes and talk to a real account manager.

Install on Shopify – Free Talk to us

On WooCommerce? Connect your store free →