SoMerch Docs

Public MCP Server and REST API

SoMerch offers a public MCP (Model Context Protocol) server for AI agent integration and a public REST API for custom integrations, automation, and data access.

Public MCP Server

The MCP server allows AI agents and MCP-compatible clients to browse the SoMerch product catalog, search products, and explore merch data programmatically.

Endpoint

https://somerch.co/mcp

How to connect

Add the server to any MCP-compatible client:

{
  "mcpServers": {
    "somerch-public": {
      "url": "https://somerch.co/mcp"
    }
  }
}

Discovery

  • MCP server card: somerch.co/.well-known/mcp/server-card.json
  • Agent skills: somerch.co/.well-known/agent-skills/

Supported clients

Claude, ChatGPT, Cursor, OpenCode, and any other MCP-compatible tool. No authentication required for read-only catalog access.

Public REST API

The REST API provides programmatic access to SoMerch platform data with OAuth authentication, webhooks, and event streams.

Base URL

https://somerch.co/api/public/v1/

OpenAPI spec

somerch.co/api/public/openapi.json

API resources

  • Actions - Pre-defined integration actions
  • Connections - Manage OAuth connections
  • Events - Event stream for integration triggers
  • Jobs - Asynchronous job management
  • Webhooks - Webhook subscription management with signature verification
  • Providers - Available OAuth providers
  • Audit logs - Integration activity records

Authentication

The API uses OAuth 2.0 with support for multiple providers and per-organization scoping.

Webhooks

Webhook events are sent for order changes, inventory updates, shipment status changes, approval events, and fulfillment status. Each payload includes a signature for verification.

Integration docs

For the full API reference, interactive documentation, and integration guides: