Skip to content
MCP server

SMB Sandbox

Mock small-business CRM, inbox, calendar, invoicing and phone for testing AI agents

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.0
Listing updated
1 day ago

About SMB Sandbox

SMB Sandbox is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "sandbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@teamshift/sandbox-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "sandbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@teamshift/sandbox-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (13)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Open source, Apache-2.0

Prices change. Check teamshift.io before you buy.

SMB Sandbox 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 to SMB Sandbox

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools