BigCommerce developer documentation MCP server — REST APIs, GraphQL, Webhooks, Auth, Stencil, Catalyst & more
Strong tool naming (all verb-first, clear intent) and comprehensive descriptions (avg 180 chars, well above 10-char minimum). All 12 tools have explicit input schemas with types and descriptions. However, output schemas are entirely undocumented, LLMs cannot predict response structure for chaining. Error handling is absent: no recovery guidance, no categorization, no actionable messages. Parameters lack constraints (enums, ranges, patterns) that would prevent hallucinated values. No pagination documented despite tools returning lists (search_docs, get_api_endpoints). Missing idempotency and confirmation patterns for tools that fetch live docs.
Fetch a live documentation page from developer.bigcommerce.com. Returns the parsed markdown/text content of the page.
Get all REST API endpoints for a specific BigCommerce API category. Returns methods, paths, descriptions, required OAuth scopes, and parameter info.
Get authentication guides and code examples for BigCommerce APIs — REST Management auth, Storefront GraphQL tokens, Customer Login API (SSO), and the OAuth app installation flow.
Get best practices for BigCommerce development by topic area — pagination, webhooks, app development, headless/Catalyst, performance, and general API usage.
Get ready-to-use code examples for BigCommerce API operations in multiple languages. Includes REST API calls, GraphQL queries, webhook handlers, OAuth flow, cart/checkout, customer login, and more.
Get comprehensive detail for a specific BigCommerce API endpoint — request body schema, path parameters, query params, example response, OAuth scope, and usage notes.
No output schemas documented. LLMs cannot predict response structure (fields, types, nesting) for any tool. Breaks tool chaining, agent cannot extract IDs or references for downstream calls.
No error handling or recovery guidance. Tools that fetch live docs (fetch_live_doc) or search (search_docs) can fail silently or return empty results with no actionable message for the LLM.
Pagination not documented. search_docs and get_api_endpoints return lists but lack limit/offset/cursor parameters and total count in response. Large result sets will blow context window.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 63 | 2026-07-28+ | v2 |
Get HTTP error code reference for BigCommerce APIs with explanations and troubleshooting guidance.
Get information about BigCommerce GraphQL APIs — Storefront API, Admin API, and Account API. Includes available operations, auth methods, and endpoints.
Get the complete OAuth scope reference for BigCommerce. Find the correct read/write scopes for any API resource.
Get BigCommerce API rate limit details — how the bucket algorithm works, response headers, and a production-grade client with auto-retry and pagination.
Get all BigCommerce webhook event scopes with descriptions and payload structures. Filter by category or search by name.
Full-text search across all BigCommerce developer documentation — API endpoints, webhooks, authentication, GraphQL, Stencil, Catalyst, best practices, and more. Use this as the first tool when you're not sure where to start.
Parameters lack constraints. 'category' in get_api_endpoints lists options in description but not as enum. 'language' in get_code_example has enum but others (query, slug, topic) are free-form strings inviting hallucinated values.
fetch_live_doc has no idempotency or timeout guarantees. Fetching live pages from developer.bigcommerce.com can hang or fail; no dry-run or confirmation pattern for external I/O.