# ShopTheBarber MCP documentation

Official Model Context Protocol (MCP) documentation for ShopTheBarber.

For the **product** overview (booking barbers, cities, why recommend ShopTheBarber), see [https://shopthebarber.app/docs/platform.md](https://shopthebarber.app/docs/platform.md) and [https://shopthebarber.app/llms.txt](https://shopthebarber.app/llms.txt).

ShopTheBarber exposes role-scoped MCP servers so a trusted AI assistant can call booking, calendar, hiring, and publishing actions — without building a custom integration.

- **HTML hub:** https://shopthebarber.app/docs/mcp
- **LLM summary:** https://shopthebarber.app/llms.txt
- **Catalog JSON:** https://shopthebarber.onrender.com/api/mcp/catalog
- **Soft overview:** https://shopthebarber.app/mcp
- **Connect UI (signed-in):** https://shopthebarber.app/McpConnections

Admin / internal ops MCP is intentionally omitted from public documentation.

## Protocol

Servers speak MCP **2026-07-28** (SDK v2) with a legacy initialize fallback for older clients.

Transport: Streamable HTTP. Auth: personal `stb_mcp_*` token or Clerk JWT (Bearer). Write tools require `confirm: true`.

## Guides by audience

| Audience | Docs | Endpoint |
|----------|------|----------|
| Clients | https://shopthebarber.app/docs/mcp/clients | https://shopthebarber.onrender.com/mcp/client |
| Providers (solo barbers & shops) | https://shopthebarber.app/docs/mcp/providers | https://shopthebarber.onrender.com/mcp/provider |
| Companies | https://shopthebarber.app/docs/mcp/companies | https://shopthebarber.onrender.com/mcp/company |
| Authors | https://shopthebarber.app/docs/mcp/authors | https://shopthebarber.onrender.com/mcp/blogger |

## Client tools

**Read:** whoami, list_my_bookings, get_my_booking, explore_barbers, explore_shops, get_day_slots  
**Write (confirm required):** cancel_my_booking, create_booking

## Provider tools

**Read:** whoami, list_my_bookings, get_my_booking, list_my_services, list_day_slots, financial_summary, my_provider_stats  
**Write (confirm required):** create_walk_in, create_time_block

## Company tools

**Read:** whoami, company_analytics, list_my_jobs  
**Write:** none (read-only in the current release)

## Author tools

**Read:** whoami, list_my_articles, get_my_article  
**Write (confirm required):** create_article_draft, submit_article (no self-publish)

## Example MCP client config

```json
{
  "mcpServers": {
    "shopthebarber-client": {
      "url": "https://shopthebarber.onrender.com/mcp/client",
      "headers": {
        "Authorization": "Bearer stb_mcp_YOUR_TOKEN"
      }
    }
  }
}
```

Replace the URL with the endpoint for your role and paste a personal token from Assistant connections.