snowfakery-mcp 0.0.2.dev1

MCP server for authoring, analyzing, debugging, and running Snowfakery recipes

Snowfakery MCP Server

Power up your AI workflows with Snowfakery data generation — Use Claude, ChatGPT, and other AI assistants to author, debug, and run data recipes through the Model Context Protocol.

What is this?

Snowfakery is a YAML-based tool for programmatically generating test data. This MCP server connects Snowfakery to AI assistants, letting you:

• Draft recipes with AI assistance backed by real Snowfakery docs and examples
• Validate recipes before running them with detailed error feedback
• Execute recipes and iterate on results interactively
• Debug issues with static analysis and recipe inspection
• Generate Salesforce mappings for CumulusCI workflows

Perfect for teams that need realistic test data—from Salesforce admins to developers building data pipelines.

Quick Start

Install & Run

# Recommended: isolated install
pipx install snowfakery-mcp

# Then run the server
snowfakery-mcp

Or from source:

git clone https://github.com/composable-delivery/snowfakery-mcp.git
cd snowfakery-mcp
uv sync
uv run snowfakery-mcp

Connect to Claude (Desktop)

Add to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "snowfakery-mcp": {
      "command": "snowfakery-mcp"
    }
  }
}

Then ask Claude:

"Show me an example Snowfakery recipe" or "Help me write a recipe to generate 100 Salesforce accounts"

Features

Resources — Access docs, examples, and schemas:

• Snowfakery documentation and recipe examples
• JSON schema for recipe validation
• Run outputs and artifacts

Tools — Interact with recipes:

• Validate & analyze recipes (catch errors early)
• Run recipes and capture output
• List & retrieve example recipes
• Generate CumulusCI mapping files

Learn More

• MCP_SERVER_SPEC.md — detailed design and tool catalog
• Snowfakery docs — recipe language reference
• Contributing — how to contribute

Community

We want this to be welcoming at any level. Questions, ideas, and contributions are always welcome!

• Questions & ideas? Open a GitHub Discussion
• Found a bug? Open an Issue with a minimal recipe
• Want to contribute? See CONTRIBUTING.md
• Security concern? See SECURITY.md

Development

# Install dev dependencies
uv sync --all-groups

# Run tests
uv run pytest

# Type check
uv run mypy snowfakery_mcp

# Lint & format
uv run ruff check snowfakery_mcp tests scripts evals
uv run ruff format snowfakery_mcp tests scripts evals

Evals (Agentic Testing)

This repo includes inspect-ai tasks for testing the MCP server with AI models:

# Install eval dependencies
uv sync --group evals

# Run evaluation
uv run inspect eval evals/inspect_tasks.py@snowfakery_mcp_agentic --model openai/gpt-4o-mini

See evals/ for more examples and troubleshooting.

Notes

• The repo includes the upstream Snowfakery repo as a git submodule (Snowfakery/) for development
• When running from source, use uv run ... to ensure the pinned environment
• PyPI installs use bundled docs/examples (no submodule required)

Releases

See GitHub Releases for sdist, wheel, and experimental .mcpb bundles.