# Woodstitch

> Woodstitch is a paid MCP server for design and media. Paid human listeners judge your TTS audio in blind preference or human-vs-AI studies. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI
- **Website:** https://woodstitch.com/docs
- **Repository:** https://github.com/woodstitch-llc/woodstitch-mcp
- **MCP Registry name:** com.woodstitch/tts-human-eval
- **Categories:** design and media, AI models and LLM tooling, analytics and data
- **Listing updated:** 2026-11-14

## About

Woodstitch offers only two tests: a forced-choice preference between two clips of the same text, and detection of whether one clip is human or AI with a 1 to 4 confidence. It states plainly that it does not do MOS, CMOS, MUSHRA or any 1 to 5 scale. Results arrive as a number with a confidence interval.

The MCP tools mirror the API flow: upload audio, create a study and get a free quote, start it, poll progress, then fetch results or export every judgement. Safeguards are built in: starting needs the user-confirmed quoted total, which becomes a hard max_total_usd ceiling, and POSTs carry idempotency keys so a retry never buys twice. Interim scores are labelled provisional.

Pricing is per judgement by clip length, for example $0.30 for a pair of 30-second clips and $0.08 for a 15-second detection clip.

## Features

- **Pairwise preference:** Listeners pick between two clips.
- **Human-vs-AI detection:** One clip, judged human or AI with confidence.
- **Free quote first:** Create a study to see the exact cost before spending.
- **Spending ceiling:** Start requires confirmed amount, used as max total.
- **Result export:** Every judgement as JSON or CSV.

## Good for

- Compare two TTS checkpoints
- Test whether a voice passes as human
- Get an outside check beyond WER
- Export raw ratings for analysis

## Install

### Claude Code (Terminal)

```sh
claude mcp add tts-human-eval --env WOODSTITCH_API_KEY='<WOODSTITCH_API_KEY>' -- uvx woodstitch-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "tts-human-eval": {
      "command": "uvx",
      "args": [
        "woodstitch-mcp"
      ],
      "env": {
        "WOODSTITCH_API_KEY": "<WOODSTITCH_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tts-human-eval": {
      "command": "uvx",
      "args": [
        "woodstitch-mcp"
      ],
      "env": {
        "WOODSTITCH_API_KEY": "<WOODSTITCH_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "tts-human-eval": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "woodstitch-mcp"
      ],
      "env": {
        "WOODSTITCH_API_KEY": "<WOODSTITCH_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tts-human-eval": {
      "command": "uvx",
      "args": [
        "woodstitch-mcp"
      ],
      "env": {
        "WOODSTITCH_API_KEY": "<WOODSTITCH_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tts-human-eval": {
      "command": "uvx",
      "args": [
        "woodstitch-mcp"
      ],
      "env": {
        "WOODSTITCH_API_KEY": "<WOODSTITCH_API_KEY>"
      }
    }
  }
}
```

## Tools

- `woodstitch_templates`: What is measured and what is not.
- `woodstitch_pricing`: Rate card and examples.
- `woodstitch_account`: Balance and spend.
- `woodstitch_upload_files`: Uploads local audio.
- `woodstitch_create_eval`: Creates and prices a study.
- `woodstitch_start_eval`: Starts the study; spends money.
- `woodstitch_get_eval`: Progress and provisional score.
- `woodstitch_get_results`: Final numbers.
- `woodstitch_export`: Exports judgements as json or csv.
- `woodstitch_cancel_eval`: Stops early.
- `woodstitch_list_evals`: Lists studies.
- `woodstitch_list_files`: Lists files.
- `woodstitch_delete_file`: Deletes a file.

## FAQ

### Does it offer MOS?

No; only preference and detection.

### How is it priced?

By the second of audio heard; a 30 s plus 30 s pair is $0.30 per judgement.

### Do I need a key?

An API key is needed except for templates and pricing tools; POST /v1/start can create one.

### Can an agent spend money unprompted?

No; it must pass the quoted total the user confirmed.

### Is Woodstitch free?

No. Woodstitch is a paid product.

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

Run this command in your terminal: claude mcp add tts-human-eval --env WOODSTITCH_API_KEY='<WOODSTITCH_API_KEY>' -- uvx woodstitch-mcp

### What are the best alternatives to Woodstitch?

The closest alternatives to Woodstitch are HyperFrames by HeyGen, Agent-Native Analytics, ffmpeg-skill, Claude Code Ultimate Guide and Google Ads + Meta Ads + SEO/GEO MCP.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [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.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/woodstitch
