Serveur MCP StatusPro
Commit 13 nov. 2026Permet à un assistant IA de lire et de mettre à jour les statuts de commande, de gérer les dates d'échéance et d'ajouter des commentaires d'historique via l'API StatusPro.
Aussi connu sous dougborg/statuspro-openapi-client
- Étoiles
- 0
- Outils
- 10
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 13 nov. 2026
- Licence
- MIT
Qu'est-ce que StatusPro MCP ?
Permet à un assistant IA de lire et de mettre à jour les statuts de commande, de gérer les dates d'échéance et d'ajouter des commentaires d'historique via l'API StatusPro. Il expose 10 outils, comme list_orders, get_order, lookup_order.
Résumé généré à partir du README du projet
À propos du MCP server StatusPro
Ce MCP server permet aux marchands utilisant l'API StatusPro de gérer l'avancement de la production des commandes et les mises à jour clients. En se connectant à des assistants IA comme Claude Desktop ou Cursor, les utilisateurs peuvent interagir avec leurs données de commande en langage naturel. Le serveur sert de passerelle pour lire les détails des commandes, vérifier les transitions de statut valides et mettre à jour les informations de commande directement depuis une interface de chat.
Pour utiliser ce serveur, vous devez fournir une clé STATUSPRO_API_KEY via les variables d'environnement dans la configuration de votre client. Le serveur inclut des outils spécialisés pour diverses tâches, tels que list_orders, lookup_order et update_order_status. Pour des raisons de sécurité, tous les outils de mutation comme add_order_comment ou bulk_update_order_status utilisent un modèle de confirmation en deux étapes qui nécessite l'approbation explicite de l'utilisateur avant que les modifications ne soient appliquées à l'API. Cela garantit qu'un assistant IA ne peut pas modifier accidentellement les statuts de commande ou les dates d'échéance sans votre permission.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Outils MCP StatusPro 10
Détectés depuis le READMElist_ordersget_orderlookup_orderlist_statusesget_viable_statusesupdate_order_statusadd_order_commentupdate_order_due_datebulk_update_order_statusstatuspro
| list_orders | — | |
| get_order | — | |
| lookup_order | — | |
| list_statuses | — | |
| get_viable_statuses | — | |
| update_order_status | — | |
| add_order_comment | — | |
| update_order_due_date | — | |
| bulk_update_order_status | — | |
| statuspro | — |
Configuration
STATUSPRO_API_KEYSTATUSPRO_BASE_URL
| Nom | Description | Type |
|---|---|---|
| STATUSPRO_API_KEY | — | |
| STATUSPRO_BASE_URL | — |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessibledougborg/statuspro-openapi-client is public and reachablegithub.com/dougborg/statuspro-openapi-client ↗Réussi
- Le nom du package correspond au dépôt sourceNon vérifié
- Provenance du build (attestation Sigstore)Non vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-13github.com/dougborg/statuspro-openapi-client ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNon vérifié
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle10 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNo tool named like delete, drop or execRéussi
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubStatusPro — API Client Ecosystem
Multi-language client ecosystem for the StatusPro API, a small REST API for reading and updating the status of orders. The StatusPro API is used by merchants to expose production progress to their customers (order received → in production → shipped, etc.) and to update that status from their own systems.
This monorepo ships:
- A production-grade Python client with transport-layer retries, rate-limit awareness, and auto-pagination across all list endpoints.
- A TypeScript client generated from the same OpenAPI spec.
- An MCP server exposing StatusPro operations as tools to AI assistants like Claude Desktop.
Packages
| Package | Language | Version | Description |
|---|---|---|---|
| statuspro-openapi-client | Python | 0.1.0 | API client with transport-layer resilience |
| statuspro-mcp-server | Python | 0.1.0 | Model Context Protocol server for AI assistants |
| statuspro-client | TypeScript | 0.1.0 | TypeScript/JavaScript client with full type safety |
Features
| Feature | Python | TypeScript | MCP Server |
|---|---|---|---|
| Automatic retries (network + 5xx) | Yes | Yes | Yes (via Python client) |
| Rate-limit retry with exponential backoff | Yes | Yes | Yes |
| Auto-pagination (page + per_page with meta) | Yes | Yes | Yes |
| Two-step confirm on mutations | — | — | Yes |
| Full type safety (attrs + Pydantic / TS) | Yes | Yes | Yes |
| AI tool surface | — | — | Claude, Cursor, etc. |
Quick Start
Python Client
pip install statuspro-openapi-client
import asyncio
from statuspro_public_api_client import StatusProClient
async def main():
async with StatusProClient() as client:
orders = await client.orders.list(per_page=25)
for order in orders:
status = order.status.name if order.status else "(no status)"
print(f"{order.name}: {status}")
asyncio.run(main())
TypeScript Client
npm install statuspro-client
import { StatusProClient } from "statuspro-client";
const client = await StatusProClient.create();
const response = await client.get("/orders");
const { data, meta } = await response.json();
console.log(`Found ${meta.total} orders (page ${meta.current_page}/${meta.last_page})`);
MCP Server (Claude Desktop)
pip install statuspro-mcp-server
Add to Claude Desktop config
(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"statuspro": {
"command": "uvx",
"args": ["statuspro-mcp-server"],
"env": {
"STATUSPRO_API_KEY": "your-api-key-here"
}
}
}
}
Configuration
All packages authenticate via bearer token:
- Environment variable:
STATUSPRO_API_KEY .envfile:STATUSPRO_API_KEY=your-key- Direct parameter: pass
api_key=...to the client constructor ~/.netrc:machine app.orderstatuspro.com+password your-key
# .env
STATUSPRO_API_KEY=your-api-key-here
STATUSPRO_BASE_URL=https://app.orderstatuspro.com/api/v1 # optional override
API Coverage
The StatusPro API is intentionally small and focused on order status. All 7 endpoints are covered:
| Tag | Method | Path | Purpose |
|---|---|---|---|
| Orders | GET | /orders |
Paginated list with filters (search, status, tags, due date). |
| Orders | GET | /orders/{id} |
Full detail for one order including history. |
| Orders | GET | /orders/lookup |
Look up an order by order number + customer email. |
| Orders | GET | /orders/{id}/viable-statuses |
Statuses that are valid transitions from the current state. |
| Orders | POST | /orders/{id}/status |
Change the status of a single order. |
| Orders | POST | /orders/{id}/comment |
Add a history comment (5/min rate limit). |
| Orders | POST | /orders/{id}/due-date |
Set or update the due date (single date or range). |
| Orders | POST | /orders/bulk-status |
Update up to 50 orders at once (5/min, queued asynchronously). |
| Statuses | GET | /statuses |
Every status defined on the account (code, name, color). |
Conventions:
- Bearer token auth on every endpoint (
Authorization: Bearer <STATUSPRO_API_KEY>). GET /ordersreturns{"data": [...], "meta": {current_page, last_page, per_page, total, from, to}}.GET /statusesandGET /orders/{id}/viable-statusesreturn raw JSON arrays.- Pagination uses
page+per_pagequery params (per_pagemax 100). - Rate limits are documented per-endpoint (60/min on most, 5/min on
/commentand/bulk-status) but not surfaced in response headers.
MCP Tools
The statuspro-mcp-server package maps each endpoint to a tool. Mutations use a
two-step confirm pattern: call with confirm=false for a preview, then confirm=true
to apply (the client elicits explicit user approval).
| Tool | Mutation? | Description |
|---|---|---|
list_orders |
no | Filter + paginate orders |
get_order |
no | Full detail for one order |
lookup_order |
no | Find an order by number + customer email |
list_statuses |
no | Full status catalog |
get_viable_statuses |
no | Valid transitions for an order |
update_order_status |
yes | Change one order's status |
add_order_comment |
yes | Add a history comment |
update_order_due_date |
yes | Set or change the due date |
bulk_update_order_status |
yes | Change status for up to 50 orders at once |
Plus two resources:
statuspro://statuses— JSON list of every status (cached read).statuspro://help— tool reference and recommended workflows.
Resilience (Python client)
Every endpoint inherits these transport-layer behaviors automatically — no decorators or wrappers needed:
- Retries:
httpx-retriesretries idempotent methods on 502/503/504 and any method on 429. Configurable viamax_retries. - Rate-limit awareness:
Retry-Afterheaders are honored when present; otherwise exponential backoff. - Auto-pagination:
GET /ordersis walked to completion usingmeta.last_pageas the stop condition, up tomax_pages(default 100) or an explicitmax_itemsoverride. Raw-array endpoints (/statuses,/viable-statuses) are never paginated. - Sensitive-data redaction: Authorization headers and common secret field names
(
api_key,password,email, etc.) are scrubbed from log output.
Project Structure
statuspro-openapi-client/ # Monorepo root
├── pyproject.toml # Workspace configuration (uv)
├── uv.lock # Python lock file
├── pnpm-workspace.yaml # TS workspace
├── docs/
│ ├── statuspro-openapi.yaml # OpenAPI 3.1.0 spec (source of truth)
│ └── *.md # Shared documentation
├── statuspro_public_api_client/ # Python client
│ ├── statuspro_client.py # Resilient client + transport layer
│ ├── domain/ # Hand-written Pydantic domain models
│ ├── helpers/ # Ergonomic facades (client.orders, .statuses)
│ ├── utils.py # unwrap/unwrap_as/unwrap_data + error types
│ ├── api/, models/ # Generated from the OpenAPI spec
│ └── docs/ # Package documentation
├── statuspro_mcp_server/ # MCP server
│ └── src/statuspro_mcp/
│ ├── server.py # FastMCP server
│ ├── tools/ # 9 tools (orders + statuses)
│ └── resources/ # help + statuses resources
└── packages/
└── statuspro-client/ # TypeScript client
├── src/
│ └── generated/ # Generated from the same spec
└── openapi-ts.config.ts
Development
Prerequisites
Setup
git clone https://github.com/dougborg/statuspro-openapi-client.git
cd statuspro-openapi-client
uv sync --all-extras # install Python deps
uv run pre-commit install # install git hooks
pnpm install # install TS deps
cp .env.example .env # add STATUSPRO_API_KEY
Common Commands
uv run poe quick-check # fast: format + lint
uv run poe check # full: format + lint + typecheck + test
uv run poe test # just tests (pytest -n 4)
uv run poe regenerate-client # regenerate the Python client from docs/statuspro-openapi.yaml
uv run poe generate-pydantic # regenerate Pydantic v2 models
pnpm --filter statuspro-client generate # regenerate the TypeScript client
Commit Standards
Conventional commits drive per-package release-please versioning. Which package(s) get bumped is decided by which paths a commit touches, not its scope — but scopes remain useful for changelog readability:
git commit -m "feat(client): add helper for archived orders"
git commit -m "fix(client): handle empty viable-status responses"
git commit -m "feat(mcp): add tool for lookup by date range"
git commit -m "feat(ts): export pagination helpers"
git commit -m "docs: update quick-start"
Use ! for breaking changes: feat(client)!: drop Python 3.11 support.
See RELEASE.md for details.
License
MIT License — see LICENSE.
Contributing
Contributions welcome. See CONTRIBUTING.md for guidelines.
Questions sur StatusPro MCP
Quels outils StatusPro MCP fournit-il ?
Il expose 10 outils, dont list_orders, get_order, lookup_order, list_statuses, get_viable_statuses.
Que puis-je faire avec le MCP server StatusPro ?
Vous pouvez lister, rechercher et obtenir les détails des commandes, consulter les statuts disponibles, mettre à jour le statut des commandes, ajouter des commentaires et gérer les dates d'échéance.
Le serveur prend-il en charge les mises à jour groupées ?
Oui, vous pouvez mettre à jour le statut de jusqu'à 50 commandes à la fois en utilisant l'outil bulk_update_order_status.