# API Mock Sandbox

An MCP server that gives Claude two tools for spinning up a local, persistent REST mock API on demand: describe the data you need in plain language, get a working CRUD backend a few seconds later, with data that survives restarts because it's written to disk instead of kept in memory.

Full documentation, in English and Spanish, lives in [`docs/`](./docs):

- [English guide](./docs/en/README.md) · [security](./docs/en/SECURITY.md) · [limitations](./docs/en/LIMITATIONS.md)
- [Guía en español](./docs/es/README.md) · [seguridad](./docs/es/SEGURIDAD.md) · [limitaciones](./docs/es/LIMITACIONES.md)

## Quick start

```bash
npm install
npm run build
```

Then register it in `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "api-mock-sandbox": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_PROJECT/dist/index.js"]
    }
  }
}
```

Restart Claude Desktop, then ask it to set up a mock API for whatever you're building. See the full guide for tool parameters, the REST endpoint reference, and troubleshooting.

**Before you plan a project around Claude Artifacts calling this API:** they can't. Published Artifacts run in a CSP sandbox that silently blocks requests to `localhost`. Read [`docs/en/LIMITATIONS.md`](./docs/en/LIMITATIONS.md) for why, and for the local test console (`public/index.html`, served at `http://localhost:<port>/`) that works instead.

## License

[MIT](./LICENSE)

---

Built with [Claude Code](https://claude.com/claude-code).