Saleor Headless API Connector for AI agents.
10 live capabilities
Manage your headless e-commerce store and product inventory directly.
Waiting for input…
Why people use Saleor Headless API
Saleor for Headless E-commerce Inventory Management
This Connector gives your AI agent a direct line to your Saleor backend. Instead of you doing the manual digging, your agent does the work. It handles the heavy lifting of checking your inventory and order history so you can stay focused on actually running the business.
What Vinkius changes
You get a live bridge between your AI agent and your e-commerce backend.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Checking an order's location
A customer asks 'Where is my package?
- Real-world use case 02
Stock verification
A shopper asks 'Is the red dress available in size medium?
- Real-world use case 03
Customer lookup
A support agent asks 'Who is customer 502?
Complete set · 10capabilities
The complete Saleor Headless API capability set.
These are the exact actions your AI can choose when you ask it to work with Saleor Headless API.
01—04
4 capabilities in this set.
Part of 10 available through Saleor Headless API.
- 01 Capability
List collections
Pulls a list of all product collections in your directory. This helps you see how you've grouped your merchandise.
- 02 Capability
List orders
Shows a list of the most recent orders placed on your platform. It's perfect for a quick pulse check on daily sales.
- 03 Capability
Get customer
Pulls a specific customer's profile and their full order history. Use this to check past purchases during a support call.
- 04 Capability
Get order
Grabs every detail for a single order, including line items and billing info. Use this to verify shipping addresses or fulfillment status.
05—07
3 capabilities in this set.
Part of 10 available through Saleor Headless API.
- 05 Capability
Get product
Fetches specific details like variants and stock for a single product ID. This helps you check exact inventory counts for specific items.
- 06 Capability
Get shop info
Retrieves your global store configuration and high-level settings. Use it to see your active regions and default currencies.
- 07 Capability
List categories
Shows you every category in your store to see how items are organized. It's a quick way to browse your catalog structure.
08—10
3 capabilities in this set.
Part of 10 available through Saleor Headless API.
- 08 Capability
List channels
Lists all active sales channels and their configurations. Use this to see where your products are currently being sold.
- 09 Capability
List customers
Finds all registered customers in your store's database. Use this to get a broad view of your user base.
- 10 Capability
List products
Returns a list of all products currently in your Saleor store. Use this to get a high-level view of your entire catalog.
Set up in minutes
One URL. Then ask Saleor Headless API to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Saleor Headless API from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_j3mvi8fKyIAr5EgXcsZ9lrEBlO8tzq58pj2vOi5H/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Saleor Headless API, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Saleor Headless API for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_j3mvi8fKyIAr5EgXcsZ9lrEBlO8tzq58pj2vOi5H/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Saleor Headless API URL.
- Step 03
Save and start
Save the connection and enable Saleor Headless API in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"saleor": {
"url": "https://edge.vinkius.com/vk_preview_j3mvi8fKyIAr5EgXcsZ9lrEBlO8tzq58pj2vOi5H/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Saleor Headless API
Open Agent mode in chat and ask: "Using Saleor Headless API, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"saleor": {
"url": "https://edge.vinkius.com/vk_preview_j3mvi8fKyIAr5EgXcsZ9lrEBlO8tzq58pj2vOi5H/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Saleor Headless API
Ask Copilot: "Using Saleor Headless API, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"saleor": {
"url": "https://edge.vinkius.com/vk_preview_j3mvi8fKyIAr5EgXcsZ9lrEBlO8tzq58pj2vOi5H/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Saleor Headless API
Open Cascade and ask: "Using Saleor Headless API, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"saleor": {
"url": "https://edge.vinkius.com/vk_preview_j3mvi8fKyIAr5EgXcsZ9lrEBlO8tzq58pj2vOi5H/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Saleor Headless API
Ask Cline: "Using Saleor Headless API, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add saleor --transport http "https://edge.vinkius.com/vk_preview_j3mvi8fKyIAr5EgXcsZ9lrEBlO8tzq58pj2vOi5H/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Saleor Headless API
Ask Claude: "Using Saleor Headless API, show me...". 10 tools are ready
Where the request belongs
Work Saleor Headless API can move forward.
This is for e-commerce managers and retail ops who are tired of manual data entry and want their AI to actually interact with their store data.
E-commerce Manager
Uses the AI to check inventory levels and update product categories without leaving the chat.
Customer Support Lead
Pulls up customer order histories instantly to resolve tickets faster.
Retail Operations Specialist
Audits recent sales and monitors store configurations across different channels.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsJumpseller
Manage products, orders, and customers via Jumpseller API.
CloudCart
Manage e-commerce and store operations via CloudCart. track products, monitor orders, and manage customers directly from any AI agent.
Shopline
Equip your AI agent to autonomously manage your Shopline store. Audit products, track order fulfillment, fetch customer profiles, and monitor store collections seamlessly.
CS-Cart
Manage e-commerce and marketplaces via CS-Cart. track products and orders, handle customer data, audit vendors, and monitor taxes directly from any AI agent.
Podia
Manage your Podia store. list customers, track sales, and oversee products and subscriptions directly from any AI agent.
Afosto
Retail and e-commerce engine. manage orders, inventory, products, and customers via AI.
Bring your own AI
Change the model, client or framework. Keep Saleor Headless API connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Saleor Headless API.
The practical details behind the request, access and result.
Can the Saleor MCP help me manage my inventory?
Yes, it allows your AI agent to check live stock levels and pull specific product details for any item in your store.
How does the Saleor MCP handle customer order history?
Your agent can pull up a specific customer's full profile and every order they've ever placed in your shop.
Can I use Saleor MCP to check my store's global settings?
Yes, it can retrieve your global configuration, including active regions and default currencies.
Does Saleor MCP work with my existing headless setup?
It is designed specifically for Saleor's headless GraphQL backend, making it a perfect fit for your existing architecture.
How can I use Saleor MCP to help with customer support?
It lets your agent quickly find order statuses and customer information so you can provide faster, more accurate help.
Can I see my sales channels using Saleor MCP?
Yes, it can list all your configured sales channels and their specific settings.
Can the AI forcefully complete, modify, or delete existing customer orders in my Saleor shop?
No. The integration focuses securely on read-only queries. It fetches critical information such as stock numbers, recent sales, and product characteristics without actively overwriting, resolving, or destroying records to protect e-commerce transactional integrity.
Does it require a specific Saleor Cloud paid plan to use this integration?
A specific plan is not heavily mandated by the capability itself as long as your environment successfully exposes the standard backend GraphQL endpoint and permits the creation of standard administrative App Tokens within your environment policies.
Why do some commands ask for a 'GraphQL ID' specifically?
Saleor’s core architecture uses unique Base64-encoded strings (like 'UHJvZHVjdDoxMjM=') as identifiers natively, rather than typical numeric database IDs. Always use the list_orders or list_products capabilities first to discover these exact encoded IDs natively, then seamlessly pass them to the exact fetching capabilities to pull their full snapshots.
One connection away
Give your agent a direct line to Saleor Headless API.
Connect Saleor Headless API once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available