Jumpseller API Documentation

Official OpenAPI 3.0.3 specification for the Jumpseller ecommerce platform API.

API Overview

The Jumpseller API lets you programmatically create and manage online stores. It covers:

• Stores - Create, configure, and manage online stores
• Products - Full CRUD with variants, images, categories, and custom fields
• Orders - Create, update, search, and fulfill orders
• Customers - Manage customer accounts and groups
• Shipping - Configure shipping methods and rates
• Payments - Set up payment gateways
• Themes - Apply and customize store themes
• Webhooks - Subscribe to store events
• Pages & Categories - Manage store content and navigation

Quick Start

Base URL: `https://api.jumpseller.com/v1`

Authentication: Basic auth with your login and auth token (found in your Admin Panel > Account).

curl -u YOUR_LOGIN:YOUR_AUTHTOKEN https://api.jumpseller.com/v1/products.json

Resources

• OpenAPI Spec - Full API specification- OpenAPI Light - Top 30 endpoints, no code samples (for ChatGPT, Copilot, and other AI platforms with endpoint limits)
• Live API Reference - Interactive documentation
• OAuth 2 Guide - For building Jumpseller Apps

MCP Server (AI Agents)

Jumpseller provides a dedicated Model Context Protocol (MCP) server that exposes 20 store management tools to AI agents like Claude, Cursor, Windsurf, and GitHub Copilot.

Server URL: `https://mcp.jumpseller.com`

Transport: Streamable HTTP (JSON-RPC over POST, stateless)

Documentation: jumpseller.com/support/mcp-server

Quick Setup

{
  "mcpServers": {
    "jumpseller": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.jumpseller.com/",
        "--header", "X-LOGIN-KEY:YOUR_LOGIN_KEY",
        "--header", "X-AUTH-TOKEN:YOUR_AUTH_TOKEN"
      ]
    }
  }
}

Add 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.

Available Tools

Product tools support variants (sizes, colors), images, and categories. Tools are auto-discovered via `tools/list`.

Authentication

• API Token: `X-LOGIN-KEY` + `X-AUTH-TOKEN` headers (for store owners)
• OAuth 2.0: `Authorization: Bearer ` with scoped permissions (for third-party apps). See OAuth 2 Guide.

OpenAPI-based MCP (alternative)

You can also connect via the OpenAPI spec for full API coverage (109 endpoints):

npx openmcp install https://api.jumpseller.com/swagger.json --client cursor

Rate Limits

• 800 requests per minute
• 20 requests per second
• Rate limit headers included in every response

Branding & Legal

• Logo: https://jumpseller.com/images/brand/jumpseller-logo-26.svg
• Support: support@jumpseller.com
• Terms of Service: https://jumpseller.com/terms/

License

This documentation is provided by Jumpseller for use by developers and AI agents building integrations with the platform.