For the complete documentation index, see llms.txt. This page is also available as Markdown.

Jumpseller

Connect your company's Jumpseller store to Cakewalk so agents can read products, orders, customers and store settings through the gateway.

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:

  • 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. Go to All Connections.

  2. Find Jumpseller.

  3. Click Edit credentials.

  4. Paste the APP ID as Client ID and the APP SECRET as Client Secret.

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

Last updated

Was this helpful?