Model Context Protocol

StateSet MCP Server

Production-grade Model Context Protocol server with 209 tools for complete e-commerce and supply chain operations. Connect Claude AI to your commerce infrastructure.

View on GitHubDocumentation
209
MCP Tools
297
Test Coverage
15+
Tool Categories
<50ms
Response Time

What is the Model Context Protocol?

The Model Context Protocol (MCP) is a standardized interface for connecting AI models like Claude to external tools and data sources. StateSet's MCP server exposes your entire commerce stack through 209 type-safe tools.

Stdio-based communication for Claude Desktop integration
Type-safe with TypeScript and Zod validation
297 passing tests across 21 test suites
Enterprise-grade reliability and performance

Integration Flow

Claude AI
Natural language requests
MCP Server
209 typed tools
StateSet API
Commerce operations
Your Data
Orders, inventory, etc.

209 Commerce Tools

Comprehensive MCP tools for every aspect of your commerce operations

Orders & Returns

Complete order lifecycle and RMA management

Sample Tools

stateset_create_order
stateset_update_order
stateset_list_orders
stateset_get_order_items
stateset_create_rma
stateset_update_rma
stateset_list_rmas
Total tools in category12

Production Infrastructure

Enterprise-grade features for reliability, performance, and scalability

Intelligent Caching

Multi-strategy caching with LRU, LFU, and FIFO eviction policies

In-memory cache with configurable TTL
Redis distributed caching support
Hybrid L1/L2 cache architecture
Adaptive cache warming
Configuration
// Cache Configuration
CACHE_ENABLED=true
CACHE_TTL=300
CACHE_MAX_SIZE=1000
CACHE_STRATEGY=lru
CACHE_BACKEND=hybrid
AI Integration

Connect Claude to Your Commerce Stack

Let Claude manage orders, inventory, and fulfillment through natural language

Example Conversation

U

"Show me all orders from the last 24 hours with pending status"

I'll search for pending orders from the last 24 hours.

stateset_search_orders_by_date
U

"Create shipments for the first 5 orders"

Creating shipments for 5 orders...

stateset_batch_operations
Claude Desktop Integration
// Claude Desktop config
{
  "mcpServers": {
    "stateset": {
      "command": "node",
      "args": ["path/to/stateset-mcp-server"],
      "env": {
        "STATESET_API_KEY": "your_api_key"
      }
    }
  }
}

// Or programmatic integration
import { Client } from '@modelcontextprotocol/sdk';

const client = new Client({
  name: 'my-app',
  version: '1.0.0'
});

await client.connect(transport);

// List available tools
const tools = await client.listTools();

// Call a tool
const orders = await client.callTool({
  name: 'stateset_list_orders',
  arguments: { page: 1, per_page: 10 }
});

Resource URI Templates

Direct resource access via standardized URI patterns

stateset-order:///ORD-12345Order details
stateset-rma:///RMA-12345Return request
stateset-shipment:///SHIP-123Shipment tracking
stateset-product:///PROD-789Product info
stateset-inventory:///INV-456Stock levels
stateset-customer:///CUST-789Customer profile
stateset-invoice:///INV-789Invoice details
stateset-work-order:///WO-123Work order
stateset-purchase-order:///PO-456Purchase order

Quick Start

Get up and running in minutes

01

Install the Server

Clone the repository and install dependencies

git clone github.com/stateset/stateset-mcp-server
cd stateset-mcp-server
npm install && npm run build
02

Configure API Key

Set your StateSet API credentials

# .env file
STATESET_API_KEY=your_api_key
STATESET_BASE_URL=https://api.stateset.io/v1
03

Connect Claude

Add to Claude Desktop or your application

# Start the server
npm start

# Or run in development
npm run dev

Architecture

Built with TypeScript for maximum type safety and reliability

MCP Server

Stdio transport

Tool Registry

209 typed tools

Caching Layer

LRU/Redis hybrid

Rate Limiter

Token bucket

Circuit Breaker

Fault tolerance

WebSocket

Real-time events

Validation

Zod schemas

Metrics

Prometheus

Ready to Connect Claude to Your Commerce Stack?

Start managing orders, inventory, and fulfillment through natural language

Get StartedTalk to Sales