Sendd MCP

Table of Content

Managing Your Store with Sendd's MCP Integration

Learn how to connect your Sendd store to AI assistants like ChatGPT and Claude using the Model Context Protocol (MCP). Manage products, orders, and store settings through natural conversation.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants like ChatGPT and Claude interact directly with external services. With Sendd's MCP integration, you can manage your entire store, products, orders, and settings, through natural conversation with your AI assistant.

Getting Started

Connecting Your Store
  1. Open your AI assistant (ChatGPT or Claude)

  2. Navigate to integrations or MCP server settings

  3. Search for Sendd Store MCP

  4. Click Connect and sign in with your Sendd account

  5. Grant the requested permissions for your store

Once connected, your AI assistant can read and manage your store data based on the permissions you grant.

Permissions

When you connect, you'll be asked to approve specific access scopes:

Permission - What It Allows

Store Read   - View store name, description, theme, and settings

Store Write    - Update store profile, branding, and social media links

Products Read  - View all product listings and their details

Products Write - Create and update products, events, subscriptions, and more

Orders Read    - View order details, customer information, and order history

Orders Write   - Update order statuses and customer details

You can revoke access at any time from your Sendd account settings.

What You Can Do:
  1. Store Management

View your store information

"Show me my store details"

Retrieves your store name, handle, description, currency, theme, product count, and order count.

Update store settings

"Change my store theme to lavender and update the description to 'Handmade ceramics from Auckland'"

You can update your store name, description, default currency, theme (mint, peach, sky, rose, lavender, or citrus), country, and social media links including email, Facebook, Instagram, WhatsApp, TikTok, X, YouTube, Discord, LinkedIn, Pinterest, Snapchat, and website.

  1. Product Management

Sendd supports seven product types, all manageable through MCP:

Physical Products

"Create a product called 'Ceramic Mug' priced at $35 NZD with 15% tax. Add two variants: Small with 10 in stock and Large with 5 in stock."

Supports name, description, pricing, tax, categories, shipping costs, pickup options, and inventory variants with stock tracking and backorder settings.

Digital Products

"Create a digital product called 'Photography Preset Pack' at $12 with a 3-download limit"

For eBooks, courses, downloadable files, and more. Set license type (personal or commercial), download limits, and access duration. Note: files must be uploaded through the Sendd web dashboard before publishing.

Events

"Create an event called 'Pottery Workshop' on June 15th from 9am to 12pm at '42 Clay Street, Auckland'. Add a General Admission ticket at $60 and a VIP ticket at $120 with capacity of 10."

Supports physical, online, and hybrid venues with location details, agendas, ticket tiers with individual pricing and capacity, and timezone settings.

Subscriptions

"Create a monthly subscription called 'Coffee Box' at $29.99 per month with a yearly plan at $299"

Manage recurring products with customisable billing intervals (daily, weekly, monthly, yearly), multiple plans, subscriber limits, and shipping options. Stripe prices are created automatically when your store is connected to Stripe.

Flexible Price Products

"Create a pay-what-you-want product called 'Support My Art'"

The simplest product type — customers choose their own price at checkout. Just a name, description, and currency.

Enquiries

"Create an enquiry called 'Custom Order Request' with fields for Name, Email, Budget, and a Description text area"

Customisable forms for collecting customer information. Supports free, fixed, or flexible pricing with custom form fields (text, email, select, and more).

Link Products

"Create a link product called 'Shop on Etsy' pointing to my Etsy store URL"

Simple listings that direct customers to an external URL with a customisable call-to-action button.

  1. Listing Management

Browse your catalog

"Show me all my published products"

"Search my listings for 'mug'"

Filter by status or search by keyword with pagination support.

View product details

"Show me the details of my 'Ceramic Mug' product"

View full details for any listing type.

Update existing products

"Update the Ceramic Mug price to $40 and add a Medium variant with 8 in stock"

All product types support partial updates — only the fields you mention will change.

Publish or un-publish

"Publish my 'Pottery Workshop' event"

"Un-publish the Coffee Box subscription"

Toggle products between draft and published states.

Important: When updating collections like variants, event tickets, or subscription plans, providing new values replaces all existing ones. Always include every item you want to keep.

  1. Order Management

View orders

"Show me my recent orders"

"Show me all orders with status 'processing'"

"Search orders for 'john@example.com'"

Filter by status (new, processing, shipped, completed, cancelled), search by order number or email, and paginate through results.

View order details

"Show me the details for order #1042"

See full order information including line items, customer details, shipping address, payment method, and status history.

Update order status

"Mark order #1042 as shipped"

Progress orders through their lifecycle: new → processing → shipped → completed. Orders can also be cancelled from most states.

Update customer details

"Update the shipping address on order #1042 to 15 Queen Street, Auckland"

Modify customer email and shipping address on orders that are in an editable state.

Authentication & Security

  • Sendd's MCP integration uses industry-standard security practices:

  • OAuth 2.0 with PKCE - Secure authorisation without exposing credentials

  • Dynamic Client Registration (RFC 7591) - AI assistants register automatically

  • Short-lived JWT tokens - Access tokens expire after 15 minutes with automatic refresh

  • Scope-based authorisation - Granular permissions enforced on every request

  • Streamable HTTP transport - Secure, real-time communication over HTTPS

  • Your AI assistant can only access data belonging to your store. Each request is authenticated and authorised individually.

Limitations

  • Images and files cannot be uploaded through MCP. Use the Sendd web dashboard to attach product images and digital product files.

  • Bulk operations are not currently supported. Products must be created or updated individually.

  • Customer accounts are not accessible. MCP provides store management only, not customer-facing features.


Troubleshooting

"Authentication failed" errors

Your session may have expired. Disconnect and reconnect the MCP integration from your AI assistant.

"Access denied" errors

Your connection may not have the required permissions. Reconnect and ensure you grant all necessary scopes.

"Validation error" when publishing

Products require certain fields before publishing. For example, physical products need a price and tax rate; events need start and end dates. Create as draft first, then fill in required fields before publishing.

Changes not appearing on storefront

New products are created as drafts by default. Ask your AI assistant to publish the product, or publish it from the Sendd dashboard.

Need Help?

If you run into issues with the MCP integration, contact our support team at support@sendd.store