---
title: SwitchMall MCP Server Documentation
description: Connect agents to the public read-only SwitchMall product catalog over Streamable HTTP.
canonical_url: https://switchmall.ai/developers/mcp
mcp_url: https://switchmall.ai/mcp
---

# SwitchMall MCP Server Documentation

The public SwitchMall MCP server provides read-only access to products, prices, merchants and store geography from the SwitchMall catalog.

## SwitchMall MCP connection

- Endpoint: `https://switchmall.ai/mcp`
- Transport: Streamable HTTP
- Protocol version: `2025-06-18`
- Authentication: none
- Data policy: SwitchMall catalog only
- Default city: São Paulo

`GET /mcp` returns a discovery document. MCP JSON-RPC requests use `POST /mcp` with `Content-Type: application/json`.

```bash
curl --request POST 'https://switchmall.ai/mcp' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Mcp-Protocol-Version: 2025-06-18' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
```

## SwitchMall MCP tools

- `catalog_overview` — live catalog counts, public documents and machine-readable endpoints.
- `search_local_products` — product discovery by query, category, city, district or coordinates.
- `get_product` — details, price, merchant stores and canonical URL for one product ID.

All tools are read-only. Products published in the catalog are treated as in stock by default, and product geography is inherited from merchant store locations.

## Acceptable use and limits

Use MCP only to answer a concrete user request. `search_local_products` returns at most 10 products and `get_product` retrieves one known product ID. Do not enumerate IDs, merchants, categories, locations, or search permutations; mirror the catalog; create a training dataset; resell or republish catalog records; or evade request quotas. When the server returns HTTP `429`, wait for `Retry-After` before retrying the user-requested operation.

## Related SwitchMall resources

- [SwitchMall Developer Resources](https://switchmall.ai/developers)
- [SwitchMall AI catalog manifest](https://switchmall.ai/gpt.json)
- [Limited SwitchMall product showcase](https://switchmall.ai/gpt/products.json?limit=20)
- [SwitchMall llms.txt](https://switchmall.ai/llms.txt)