Skip to main content

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:

  1. Call process_search with the title, brand, size, and color
  2. Wait and then call get_quick_results for initial pricing
  3. Call get_full_results for complete eBay comparable data
  4. Present the analysis and suggested price
  5. Call list_item to 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)

Source distribution for globalsku-mcp 1.0.1
File Size Uploaded Provenance
globalsku_mcp-1.0.1.tar.gz 5.8 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for globalsku-mcp 1.0.1
File Interpreter ABI Platform
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.

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page