---
title: "The read tools, over a generated demo account"
method: POST
path: "/mcp/sandbox"
tags: ["MCP"]
---

# The read tools, over a generated demo account

`POST /mcp/sandbox`

## Request

- Base URL: `https://youspot.com`
- URL: `https://youspot.com/mcp/sandbox`
- Auth: none required

The same registry tools the product server exposes, minus every tool that writes, run against one account whose contacts and interactions are a generated fixture. No credential, no signup, no credits. Rate limited to 60 calls a minute per address, and `tools/call` answers 503 where the demo account has not been seeded.

## Headers

- `Idempotency-Key` string

## Request body

- JsonRpcRequest
  - `jsonrpc` '2.0'
  - `id` union: Omit it, with a `notifications/*` method, for a notification.
    - string
    - integer
  - `method` string, required
  - `params` object

## Response `200`

A JSON-RPC envelope.

- JsonRpcResponse
  - `jsonrpc` '2.0', required
  - `id` union
    - string
    - integer
  - `result` object
  - `error` object
    - `code` integer
    - `message` string

## Other responses

- `422`: This `Idempotency-Key` was already used on this operation with a different request body.
- `429`: Too many requests from this address in the current window.
- `503`: The sandbox account is not configured here.

---

[API](https://skmtc.dev/youspot/apis/youspot-http-api.md) · [All operations](https://skmtc.dev/youspot/apis/youspot-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/youspot/apis/youspot-http-api/revisions/6615ad5d017d?raw)