# SMB Sandbox

> SMB Sandbox is an open-source MCP server for developer tools. Mock small-business CRM, inbox, calendar, invoicing and phone for testing AI agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://teamshift.io/open-source/smb-sandbox
- **Repository:** https://github.com/teamshift-io/smb-sandbox/tree/HEAD/packages/sandbox-mcp
- **MCP Registry name:** io.github.teamshift-io/sandbox-mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

sandbox-mcp serves a fictional business generated from a seed, so an agent can work on leads, stale quotes, duplicate contacts and overdue invoices with no real accounts involved. Changes are validated like a real system's, logged, and stay inside the process; sending an email or SMS only writes to an outbox.

Three industries ship today: home services, dental clinic and marketing agency, with options for size, messiness and which toolsets to expose (crm, inbox, calendar, invoicing, phone, admin). The same seed always yields a byte-identical company. Injected problems are labeled in an anomalies list that is hidden from the agent unless you pass a flag, so you can score precision and recall. At exit, a state file records every record, the audit log and the outbox, letting you grade the end state rather than the transcript.

It is Apache-2.0 licensed and runs over stdio or Streamable HTTP. A companion workflows package is still in development.

## Features

- **Seeded fake business:** Repeatable company data across three industries.
- **Realistic mess:** Labeled anomalies such as unanswered leads and duplicate contacts.
- **Safe side effects:** Emails and SMS only write to an outbox.
- **Audit log and state export:** Record every attempted change and the final dataset.
- **Selectable toolsets:** Expose only the systems you want an agent to touch.
- **Hidden answer key:** Ground-truth anomalies can be exposed only on request.

## Good for

- Test an agent's quote follow-up before it sees real data
- Rerun the same scenario after each prompt or model change
- Score an agent's CRM cleanup against known anomalies
- Demonstrate agent workflows safely to a team

## Install

### Claude Code (Terminal)

```sh
claude mcp add sandbox-mcp -- npx -y @teamshift/sandbox-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "sandbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@teamshift/sandbox-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "sandbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@teamshift/sandbox-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "sandbox-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@teamshift/sandbox-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "sandbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@teamshift/sandbox-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "sandbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@teamshift/sandbox-mcp"
      ]
    }
  }
}
```

## Tools

- `crm_search_contacts`: Search CRM contacts
- `crm_get_contact`: Get a contact
- `crm_create_contact`: Create a contact
- `crm_update_contact`: Update a contact
- `crm_merge_contacts`: Merge duplicate contacts
- `crm_list_leads`: List leads
- `crm_list_deals`: List deals
- `crm_send_quote`: Send a quote
- `crm_follow_up_quote`: Follow up on a quote
- `inbox_list_threads`: List inbox threads
- `inbox_get_thread`: Read a thread
- `inbox_send_email`: Send an email to the outbox
- `inbox_send_sms`: Send an SMS to the outbox

## FAQ

### Does it touch real accounts?

No. All data is fictional and nothing leaves the process.

### Which industries are available?

Home services, dental clinic and marketing agency.

### How do I add it to Claude Code?

Run claude mcp add sandbox -- npx -y @teamshift/sandbox-mcp.

### What licence is it?

Apache-2.0.

### Is SMB Sandbox free?

Yes. SMB Sandbox is open source, so you can use and self-host it for free.

### How do I add SMB Sandbox to Claude Code?

Run this command in your terminal: claude mcp add sandbox-mcp -- npx -y @teamshift/sandbox-mcp

### What are the best alternatives to SMB Sandbox?

The closest alternatives to SMB Sandbox are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/smb-sandbox
