---
title: "Merchant MCP"
description: "Let an agent run your store with the merchant MCP server."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.sherpo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Merchant MCP

The merchant MCP server gives an AI agent your stores as tools. Once you connect it, your agent can add products, answer customers or check your sales, with only the stores and permissions you approve. It works on every plan.

The server's URL is `https://mcp.sherpo.io`. Add it to your AI as a remote MCP server. The same URL with `/mcp` at the end works too.

## Get started

1. **Add Sherpo to your AI.** Paste the URL into Claude, ChatGPT, Gemini CLI, Grok, Claude Code, Codex, Cursor or any other MCP client. [Connect your agent](/merchant-mcp/connect) has the steps for each one.

2. **Approve access.** Your AI sends you to Sherpo. Sign in, pick the businesses, the stores and what the connection may do in each, then click Connect. [Sign-in and consent](/merchant-mcp/sign-in) walks through the screen.

3. **Ask for what you want.** Tell your agent what to do, and it does the work and reports back.

## What an agent can do

The server offers 284 tools. An agent sees only the tools its connection may call.

- **Catalog:** products, tiers, prices, discounts and who may access what.
- **Content:** entries, pages, rich text bodies, files, prompts, quizzes and certificates.
- **Sales:** orders, refunds, subscriptions, affiliates and their commissions and payouts.
- **Customers:** customers, their activity and access, their private feeds of blogs, podcasts and events, and reviews.
- **The store:** settings, plan usage, the store icon and redirects.
- **The business:** its profile, balance, payouts, notifications, webhooks, integrations and automations.
- **Portfolio:** portfolios, holdings and their valuation.
- **Software:** license keys, the devices each activates, releases and notes.
- **Events:** sessions, the guest list, requests and the waitlist, and checking guests in at the door.

Each tool has its own page in the [Tools reference](/merchant-mcp/tools), with its arguments, its answer and the scope it needs.

## Guides

- [**Connect your agent**](/merchant-mcp/connect): The steps for each AI client, and what any other MCP client needs.

- [**Sign-in and consent**](/merchant-mcp/sign-in): What you approve, how to manage connections, and OAuth for client developers.

- [**Scopes**](/merchant-mcp/scopes): The sets you pick from, and what each scope lets a connection do.

- [**Calling tools**](/merchant-mcp/calling-tools): Stores, paging, rich text, files and bulk calls.

- [**Errors**](/merchant-mcp/errors): What a refused call answers, and what to do next.

- [**Limits**](/merchant-mcp/limits): How often a connection may call, and the sizes and counts that apply.

- [**Webhooks**](/merchant-mcp/webhooks): Endpoints an agent sets up, their events and how to verify them.

- [**Integrations and automations**](/merchant-mcp/integrations-and-automations): Integrations an agent configures, and automations it creates.

- [**Examples**](/merchant-mcp/examples): Real calls and the answers they get.

- [**Tools reference**](/merchant-mcp/tools): Every tool, with its arguments, answer and scope.

Source: https://docs.sherpo.io/merchant-mcp/index.mdx
