SFC WebService MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@SFC WebService MCP Quote me a shipping rate to the US for a 2kg package"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
SFC WebService MCP
MCP server for the SFC customer logistics WebService (rates, create/delete orders, labels, tracking).
Chinese install guide: README.zh-CN.md
Credentials stay on the customer machine (MCP env or ~/.sfc/credentials.json). Tools inject HeaderRequest automatically — never put secrets in chat or source control.
Requirements
Node.js 20+
SFC-issued
appKey,token,userId(ask your SFC account manager)
Related MCP server: Easyship MCP
Cursor install
cd sfc-webservice-mcp
npm installAdd to Cursor MCP settings (use your absolute path):
{
"mcpServers": {
"sfc-webservice": {
"command": "node",
"args": ["/absolute/path/sfc-webservice-mcp/src/index.js"],
"env": {
"SFC_APP_KEY": "your-app-key",
"SFC_TOKEN": "your-token",
"SFC_USER_ID": "your-user-id",
"SFC_DIVISION_ID": "1"
}
}
}
}Optional: omit env and call tool sfc_setup once to write ~/.sfc/credentials.json (mode 600).
Tools
Tool | Purpose | Mutates |
| Save local credentials | local file only |
| Check config (no secrets) | no |
| Probe ship types / division | no |
| List methods | no |
| Quote | no |
| Build order payload | no |
| Submit order ( | yes |
| Order lookup | no |
| Fee by order | no |
| Label PDF URL | no |
| Tracking | no |
| Delete ( | yes |
Disable delete with SFC_ALLOW_DELETE=false.
Suggested flow
sfc_verify_credentialssfc_list_ship_types→sfc_get_ratessfc_preview_order→ customer OK →sfc_create_orderwithconfirm=truesfc_get_label_url/sfc_get_trackCancel:
sfc_search_orderthensfc_delete_orderwithconfirm=true
On timeout / unknown create result: do not retry — search by customer order number first.
Official docs
Field schemas on those pages are authoritative.
Develop
npm install
npm run check
npm test
npm start # stdio MCP (used by the host)See .env.example for optional host overrides.
Available Tools
12 toolssfc_create_orderA
Create an SFC order (addOrder). Requires confirm=true. Prefer sfc_preview_order first. Do not retry on timeout — search the customer order number instead.
Inputs: confirm (required), goodsDetails (required), recipientName (required), shippingMethod (required), +20 more.
sfc_credential_statusB
Check whether SFC credentials are configured (does not print secrets).
Inputs: no named parameters.
sfc_delete_orderA
Delete an SFC order by orderCode. Requires confirm=true. Prefer searching the order first.
Inputs: confirm (required), orderCode (required).
sfc_get_feeC
Get fee by SFC order code (getFeeByOrderCode).
Inputs: orderCode (required).
sfc_get_label_urlB
Build a label PDF URL for a confirmed SFC orderCode. Does not call print if you only need the link.
Inputs: orderCode (required), printSize, printType, isPrintDeclare.
sfc_get_ratesC
Quote rates. If shipTypeCodes is set, uses HTTPS getRatesByShip; otherwise SOAP/HTTPS getRates for all methods.
Inputs: country (required), widthCm (required), heightCm (required), lengthCm (required), +8 more.
sfc_get_trackB
Track shipments by tracking number(s). Uses tracking.sfcservice.com (up to 40 numbers).
Inputs: numbers (required), client.
sfc_list_ship_typesB
List shipping methods available for a destination country and parcel size (HTTPS getShiptypesByCountry).
Inputs: country (required), widthCm, heightCm, lengthCm, +2 more.
sfc_preview_orderA
Build and validate an addOrder payload locally. Does NOT submit. Call sfc_create_order with confirm=true after customer approval.
Inputs: goodsDetails (required), recipientName (required), shippingMethod (required), goodsDescription (required), +19 more.
sfc_search_orderB
Look up an order by SFC orderCode (searchOrder).
Inputs: orderCode (required).
sfc_setupA
Save SFC API credentials to a private local file (~/.sfc/credentials.json). Prefer MCP env vars when possible. Never put credentials in chat after setup.
Inputs: token (required), appKey (required), userId (required), divisionId.
sfc_verify_credentialsC
Read-only check: probe ship types for US with a small parcel. Tries division 1 then 17 unless divisionId is set.
Inputs: country, divisionId.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Core order lifecycle tools (preview_order, create_order, search_order, delete_order, get_fee, get_label_url, get_track) have clearly distinct purposes, and the descriptions explicitly disambiguate preview vs. submit. The only real overlap is the credentials trio (sfc_verify_credentials, sfc_credential_status, sfc_setup), where an agent could plausibly pick the wrong one for 'check my credentials'.
Nearly all tools follow a uniform sfc_verb_noun snake_case pattern with a consistent prefix. Minor deviations: sfc_credential_status is noun-first rather than verb-first, and sfc_setup is a bare verb with no object.
12 tools is right in the sweet spot for a shipping-carrier integration. Each tool maps to a concrete API operation (rates, ship types, order CRUD, fee, label, tracking), with no filler tools.
The surface covers the full order lifecycle from quoting through preview, creation, fee lookup, labeling, tracking, and deletion, plus credential setup. Gaps are minor: no order update/modify, no order listing by date range, and no cancellation/void of an already-printed label.
Related MCP Connectors
Compare rates, manage orders, buy labels, schedule pickups, and report on shipping.
Get quotes, track shipments, create labels and book pickups in SpedirePRO.
Quote, book, and track LTL, FTL, cargo van, and box-truck freight via the Warp API.
List stores, search and get orders, update order status and cancel orders in ShippingEasy.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables integration with SF Express shipping and logistics APIs for order management, shipment tracking, route queries, and logistics services through natural language interactions.MIT

Easyship MCPofficial
AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage global shipping operations, including rate comparison, shipment creation, label purchasing, tracking, pickup scheduling, address validation, billing, and analytics, via natural language.MIT- AlicenseNot gradedqualityCmaintenanceProvides access to EasyPost's multi-carrier shipping rates and package tracking through the Pipeworx MCP gateway.97 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to track packages, rate and create shipments, manage pickups and customs documentation, and perform international shipping logistics checks through natural language.MIT