# Jumpseller

Connect your company's Jumpseller store to Cakewalk's MCP Gateway. Every agent tool call against Jumpseller passes through the gateway and is evaluated against your Policies.

## Requirements

* Jumpseller store owner with access to the **Apps** section in Jumpseller Admin.

## About Scopes

Jumpseller passes scopes in the OAuth authorization URL at consent time, not on the app's configuration page. The MCP server requests a scope set when the customer authenticates; you approve those scopes on the Jumpseller consent screen.

Available read scopes include `read_products`, `read_orders`, `read_customers`, `read_categories`, `read_store`, `read_settings`, `read_shipping_methods`, `read_payment_methods`, `read_hooks`, `read_promotions`, `read_taxes`, `read_pages`, `read_countries`, `read_custom_fields`, `read_checkout_custom_fields`, `read_customer_categories`, `read_jsapps`, `read_apps`, `read_fulfillments`, `read_locations`, `read_transaction_ledgers`.

Available write scopes mirror the read set (`write_products`, `write_orders`, etc.) plus `write_store_setup` and `write_reviews`. Scopes that include write access enable agents to modify store data; pick the scope set that matches the agent actions you want to allow.

## Step 1: Register an App in Jumpseller

1. Sign in to your Jumpseller store as the owner.
2. In Jumpseller Admin, open the **Apps** section in the left sidebar.
3. Scroll to the bottom of the page and click **Create New App**.

You land on the app registration form.

## Step 2: Fill in the App Details

Complete the required fields:

* **Name**: a name for the app (for example, "Cakewalk MCP Gateway").
* **Author**: your company name.
* **Email**: a contact email.
* **App URL**: `https://app.getcakewalk.io`
* **Redirect URL**:

```
https://mcp-gateway.getcakewalk.io/api/v1/Auth/Callback
```

* **Description**: up to 145 characters describing the integration.

Submit the form.

## Step 3: Copy the APP ID and APP SECRET

1. In the **Apps** section, scroll to **Owned apps**.
2. Click the **Settings** icon on your app.
3. Click **Edit**.
4. Copy the **APP ID** (your Client ID) and **APP SECRET** (your Client Secret).

## Step 4: Paste Credentials Into Cakewalk

1. Open <https://app.getcakewalk.io>.
2. Go to All Connections.
3. Find Jumpseller.
4. Click Edit credentials.
5. Paste the APP ID as **Client ID** and the APP SECRET as **Client Secret**.
6. Save.

## Verifying It Works

The Jumpseller Connection card flips to Active on All Connections. From an agent platform connected to Cakewalk, ask the agent to list recent orders or look up a product by SKU. If Jumpseller returns the data, the Connection is live.

## Troubleshooting

* Invalid redirect URI on consent: the value in **Redirect URL** must match `https://mcp-gateway.getcakewalk.io/api/v1/Auth/Callback` exactly, with no trailing slash.
* App not visible after creation: a newly registered app is available only on your own store. To publish to the Jumpseller marketplace requires a separate submission process; this is not needed to run the agent integration against your own store.
* Lost APP SECRET: open the app under **Owned apps**, click the **Settings** icon, click **Edit**, and copy the secret. If it has been rotated, regenerate it and re paste in Cakewalk.

## Learn More

* [Build a Jumpseller App](https://jumpseller.com/support/apps/)
* [Jumpseller OAuth 2 Authorization Flow](https://jumpseller.com/support/oauth-2/)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://www.cakewalk.security/docs/ai-agent-access/connections-and-integrations/agent-connections/jumpseller.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.