GlobalSKU MCP Server
A Model Context Protocol (MCP) server that wraps the GlobalSKU product data management API. It lets AI assistants (Claude Desktop, Claude Code, etc.) submit products for market analysis, get pricing data, manage listings across marketplaces, and more -- all through natural conversation.
Installation
# From the mcp-server directory
pip install .
# Or install directly from the package name (if published)
pip install globalsku-mcp
Configuration
Environment Variables
| Variable | Required | Description |
|---|---|---|
GLOBALSKU_API_URL |
Yes | Base URL of your GlobalSKU instance (e.g. https://globalsku.app) |
GLOBALSKU_API_TOKEN |
Yes | Laravel Sanctum API bearer token |
Generate a Sanctum token from your GlobalSKU account under Settings > API Tokens.
Claude Desktop
Add to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"globalsku": {
"command": "globalsku-mcp",
"env": {
"GLOBALSKU_API_URL": "https://globalsku.app",
"GLOBALSKU_API_TOKEN": "your-sanctum-token-here"
}
}
}
}
Claude Code
Add to your Claude Code MCP config (.claude/mcp.json in your project or ~/.claude/mcp.json globally):
{
"mcpServers": {
"globalsku": {
"command": "globalsku-mcp",
"env": {
"GLOBALSKU_API_URL": "https://globalsku.app",
"GLOBALSKU_API_TOKEN": "your-sanctum-token-here"
}
}
}
}
Available Tools
| Tool | Description |
|---|---|
process_search |
Submit a product for AI-powered market analysis |
get_quick_results |
Get fast ballpark pricing (30s-2min) |
get_full_results |
Get complete market analysis with eBay data (2-10min) |
list_item |
List a product on marketplaces (eBay, Walmart, Amazon, Shopify, Meta, Temu) |
delist_item |
Remove a product listing from marketplaces |
update_listing_data |
Update listing attributes (title, description, price, etc.) |
update_quantity |
Update inventory quantity (syncs to all active listings) |
update_search_data |
Update search record attributes |
update_ebay_order |
Add tracking information to an eBay order |
suggest_additional_photos |
AI suggests additional photo angles for better listings |
identify_missing_attributes |
AI identifies attributes that need manual verification |
Available Prompts
| Prompt | Description |
|---|---|
product_enrichment |
Step-by-step guide through the full workflow: search, analyze, update, and list |
bulk_processing |
Guide for processing multiple products efficiently |
Quick Example
Once configured, you can ask Claude:
"I have a Nike Air Max 90 in size 10, white colorway. Can you look up the market price and list it on eBay?"
Claude will:
- Call
process_searchwith the title, brand, size, and color - Wait and then call
get_quick_resultsfor initial pricing - Call
get_full_resultsfor complete eBay comparable data - Present the analysis and suggested price
- Call
list_itemto post it on eBay (after your confirmation)
Development
# Install in editable mode
pip install -e .
# Run directly
GLOBALSKU_API_URL=https://globalsku.app GLOBALSKU_API_TOKEN=your-token globalsku-mcp
Metadata
Release files for globalsku-mcp 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| globalsku_mcp-1.0.1.tar.gz | 5.8 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| globalsku_mcp-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 12.9 kB
Release files / globalsku_mcp-1.0.1.tar.gz
| Download URL | globalsku_mcp-1.0.1.tar.gz |
|---|---|
| Size | 5.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2e7b356341f87db5c2087f35d4b6230ca1e8a6b675a6e29d161405eac1dbe17c
|
|
BLAKE2b-256 checksum How to use checksums |
8e115bdadcbba61aa43168d4eb08955f0fc5bcc326a072c3e5b9e7f317bf65b1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.8.10
|
Release files / globalsku_mcp-1.0.1-py3-none-any.whl
| Download URL | globalsku_mcp-1.0.1-py3-none-any.whl |
|---|---|
| Size | 7.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
20ef19cacac53187fa02c4c5b8f4e968ac791f106b01f0e18006a4b474ff72b9
|
|
BLAKE2b-256 checksum How to use checksums |
c2cd8df043d6dae41fa77e725b848b5ad3b9b33acd03e7998d61b5262ff4728e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.8.10
|
Security for globalsku-mcp 1.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.