{
  "markdown": "# Jumpseller API Documentation\n\nOfficial [OpenAPI 3.0.3](https://spec.openapis.org/oas/v3.0.3) specification for the [Jumpseller](https://jumpseller.com) ecommerce platform API.\n\n## API Overview\n\nThe Jumpseller API lets you programmatically create and manage online stores. It covers:\n\n- **Stores** - Create, configure, and manage online stores\n- **Products** - Full CRUD with variants, images, categories, and custom fields\n- **Orders** - Create, update, search, and fulfill orders\n- **Customers** - Manage customer accounts and groups\n- **Shipping** - Configure shipping methods and rates\n- **Payments** - Set up payment gateways\n- **Themes** - Apply and customize store themes\n- **Webhooks** - Subscribe to store events\n- **Pages & Categories** - Manage store content and navigation\n\n## Quick Start\n\n**Base URL:** `https://api.jumpseller.com/v1`\n\n**Authentication:** Basic auth with your login and auth token (found in your Admin Panel > Account).\n\n```bash\ncurl -u YOUR_LOGIN:YOUR_AUTHTOKEN https://api.jumpseller.com/v1/products.json\n```\n\n## Resources\n\n- [OpenAPI Spec](openapi.json) - Full API specification- [OpenAPI Light](openapi-light.json) - Top 30 endpoints, no code samples (for ChatGPT, Copilot, and other AI platforms with endpoint limits)\n- [Live API Reference](https://api.jumpseller.com/support/api) - Interactive documentation\n- [OAuth 2 Guide](https://jumpseller.com/support/oauth-2) - For building Jumpseller Apps\n\n## MCP Server (AI Agents)\n\nJumpseller provides a dedicated [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that exposes 20 store management tools to AI agents like Claude, Cursor, Windsurf, and GitHub Copilot.\n\n**Server URL:** `https://mcp.jumpseller.com`\n\n**Transport:** Streamable HTTP (JSON-RPC over POST, stateless)\n\n**Documentation:** [jumpseller.com/support/mcp-server](https://jumpseller.com/support/mcp-server/)\n\n\n### Quick Setup\n\n```json\n{\n  \"mcpServers\": {\n    \"jumpseller\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\", \"mcp-remote\",\n        \"https://mcp.jumpseller.com/\",\n        \"--header\", \"X-LOGIN-KEY:YOUR_LOGIN_KEY\",\n        \"--header\", \"X-AUTH-TOKEN:YOUR_AUTH_TOKEN\"\n      ]\n    }\n  }\n}\n```\n\nAdd this to `claude_desktop_config.json` (Claude), `.cursor/mcp.json` (Cursor), or `~/.codeium/windsurf/mcp_config.json` (Windsurf). Get your credentials from Jumpseller Admin > Settings > API.\n\n### Available Tools\n\n| Area | Tools | Access |\n|------|-------|--------|\n| **Products** | `list_products`, `get_product`, `search_products`, `create_product`, `update_product`, `delete_product` | read/write |\n| **Orders** | `list_orders`, `get_order`, `search_orders`, `update_order` | read/write |\n| **Customers** | `list_customers`, `get_customer`, `search_customers` | read |\n| **Categories** | `list_categories`, `create_category`, `delete_category` | read/write |\n| **Pages** | `list_pages`, `create_page`, `delete_page` | read/write |\n| **Store** | `get_store_info` | read |\n\nProduct tools support variants (sizes, colors), images, and categories. Tools are auto-discovered via `tools/list`.\n\n### Authentication\n\n- **API Token:** `X-LOGIN-KEY` + `X-AUTH-TOKEN` headers (for store owners)\n- **OAuth 2.0:** `Authorization: Bearer <token>` with scoped permissions (for third-party apps). See [OAuth 2 Guide](https://jumpseller.com/support/oauth-2).\n\n### OpenAPI-based MCP (alternative)\n\nYou can also connect via the OpenAPI spec for full API coverage (109 endpoints):\n\n```bash\nnpx openmcp install https://api.jumpseller.com/swagger.json --client cursor\n```\n\n## Rate Limits\n\n- 800 requests per minute\n- 20 requests per second\n- Rate limit headers included in every response\n\n## Branding & Legal\n\n- **Logo:** https://jumpseller.com/images/brand/jumpseller-logo-26.svg\n- **Support:** support@jumpseller.com\n- **Terms of Service:** https://jumpseller.com/terms/\n\n## License\n\nThis documentation is provided by [Jumpseller](https://jumpseller.com) for use by developers and AI agents building integrations with the platform.\n",
  "bytes": 3995,
  "sha": "ccde08c1ab0a89a3e19eb1ba26678b748e2d12347d146f6ac8e7a16a907fad89",
  "repo_slug": "jumpseller/api-docs",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_jumpseller_admin_mcp_84599d9c/readme"
}