Back to Browse

Woodstitch MCP Server

Developer ToolsUse Caution4.4MCP RegistryLocal
Free

Server data from the Official MCP Registry

Paid human listeners judge TTS audio blind: pairwise preference or human-vs-AI detection.

About

Paid human listeners judge TTS audio blind: pairwise preference or human-vs-AI detection.

Security Report

4.4
Use Caution4.4High Risk

The Woodstitch MCP server is a thin wrapper over the vendor API. It reads its key from WOODSTITCH_API_KEY, sends it only as a Bearer token to the configured Woodstitch endpoint, and adds client-side spend guards. The main concerns are that woodstitch_upload_files will upload any local file path the model supplies, without an audio-extension or directory check, to a third-party API, and that the base URL can be overridden by environment variable, which could redirect the bearer token. Network, env var and file access otherwise match the server's purpose. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 5 high severity). Package verification found 1 issue.

5 files analyzed · 11 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

What You'll Need

Set these up before or after installing:

Woodstitch API key (ws_live_...), from https://woodstitch.com/app/api-keys. Not needed for the templates and pricing tools.Required

Environment variable: WOODSTITCH_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "com-woodstitch-tts-human-eval": {
      "env": {
        "WOODSTITCH_API_KEY": "your-woodstitch-api-key-here"
      },
      "args": [
        "woodstitch-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

woodstitch-mcp

An MCP server for the Woodstitch API: paid human listeners judge your text-to-speech audio in blinded studies, and your agent gets a number back with a confidence interval.

Two tasks, and only two: pairwise preference (a listener hears two clips of the same text and picks one, forced choice) and human-vs-AI detection (one clip, human or AI, confidence 1–4). Not offered: MOS, CMOS, MUSHRA or any 1–5 scale.

Install

Get an API key at https://woodstitch.com/app/api-keys, then:

Claude Code

claude mcp add woodstitch -e WOODSTITCH_API_KEY=ws_live_... -- uvx woodstitch-mcp

Claude Desktop / Cursor / any MCP client (mcpServers entry):

{
  "woodstitch": {
    "command": "uvx",
    "args": ["woodstitch-mcp"],
    "env": {"WOODSTITCH_API_KEY": "ws_live_..."}
  }
}

pipx run woodstitch-mcp or pip install woodstitch-mcp && woodstitch-mcp work too. Requires Python 3.10+.

Claude Code users: the Woodstitch plugin bundles this server with a skill that knows when and how to run a listening test: /plugin marketplace add woodstitch-llc/claude-plugin then /plugin install tts-human-eval@woodstitch.

Tools

ToolWhat it doesMoney
woodstitch_templatesWhat is measured and what is not (no key needed)–
woodstitch_pricingRate card and worked examples (no key needed)–
woodstitch_accountBalance and spend–
woodstitch_upload_filesUpload local audio, get file ids–
woodstitch_create_evalCreate and price a study; dry_run to price onlycharges nothing
woodstitch_start_evalStart the studyspends money
woodstitch_get_evalProgress and provisional score–
woodstitch_get_resultsFinal numbers–
woodstitch_exportEvery judgement as rows (json or csv, optionally to a file)–
woodstitch_cancel_evalStop early, pay only for work done–
woodstitch_list_evals, woodstitch_list_files, woodstitch_delete_filehousekeeping–

Safeguards built in

  • woodstitch_start_eval requires user_confirmed_amount_usd, the quoted total the user agreed to, and sends it to the API as the hard ceiling max_total_usd. If the quote is higher than what the user confirmed, the API refuses (over_max) and nothing starts. An agent cannot start a study the user has not seen the price of.
  • Every POST carries an Idempotency-Key, so a retried call never creates or starts a study twice.
  • The server's instructions tell the model that interim numbers are provisional and that stopping early on a threshold is optional stopping.

Typical session

  1. woodstitch_upload_files(["a/001.wav", "b/001.wav", ...]) or use public URLs.
  2. woodstitch_create_eval(pairs=[{"id":"001","a":"file_…","b":"file_…","passage":"001","system_a":"base","system_b":"candidate"}, …], ratings_per_pair=5) → quote, nothing charged.
  3. Show the user the total. On yes: woodstitch_start_eval(eval_id, user_confirmed_amount_usd=<total>).
  4. woodstitch_get_eval(eval_id) now and then; first judgements usually land within minutes.
  5. woodstitch_get_results(eval_id) when status is completed; woodstitch_export for the rows.

Method, listener pay and controls: https://woodstitch.com/research/methodology. Machine-readable API spec: https://woodstitch.com/openapi.json.

Development

uv venv && . .venv/bin/activate && uv pip install -e .
WOODSTITCH_API_KEY=ws_live_... woodstitch-mcp        # stdio server

MIT © Woodstitch LLC

Reviews

No reviews yet

Be the first to review this server!