MCP Server and API Access
For technical use cases, Horsee runs an MCP server that lets agents and tools create and edit pages and products.
What it's for
The Horsee MCP server lets an AI assistant such as Claude or Cursor run your store for you: read data, create pages, update products and publish. The connection uses an OAuth login and covers one store at a time, with the permissions you approve.
What you can do through MCP
- Create raw pages (landing, product, custom) and publish them.
- Update pages and the store's header and footer (chrome).
- Create products and generate or capture store templates.
Step by step: connect to Claude
- Open your user menu and go to My Account.
- On the MCP connections card, click Connect to Claude. The window shows the server URL and the instructions.
- In the Claude app, go to Customize → Connectors, click +, choose Add custom connector, paste the URL and click Add. In Claude Code, run the command shown in the window and type
/mcp. - On the Horsee screen that opens, log in, pick the store and approve the permissions.
- To cut off access, go back to the MCP connections card and click Revoke.
The Horsee MCP page also has one-click install links for Claude and Cursor.
Authentication and scopes
Access uses OAuth 2.1 with PKCE: the client receives a token with per-capability scopes, such as pages:read, pages:write and pages:write:raw (writing HTML/CSS/JS), plus products:write, templates:author and others. Before you automate anything, look up the live contract (interpolation tokens, <horsee-*> elements and page modes): it's the source of truth.
Limits
Each connection accepts up to 60 requests per minute; above that, the server returns a 429 error and says how long to wait. Destructive actions, such as publishing or deleting, have an hourly quota and require confirmation: the tool returns a code, and the action only runs if the same call is repeated with that code within 5 minutes. The store owner gets an email afterwards.
Common mistakes
- Working on the wrong store: the connection covers the store you picked at login. Ask the assistant to switch stores, or connect again.
- 429 error: you hit the request limit. Wait for the time shown.
- Publishing without review: start in draft, check the preview, and only then publish.
- Claude's free plan: it allows one custom connector at a time.
Was this article helpful?
Your feedback helps us improve our guides