LikelyTypo MCP Server

Give any LLM or AI agent the ability to generate realistic typing errors. A Model Context Protocol server that adds physics-based human imperfection to AI-generated text.

Tool for Any LLM

Expose typo generation as an MCP tool. Claude, GPT, or any MCP-compatible agent can call it directly during conversations.

Humanize AI Output

LLM-generated text is statistically perfect. Add the subtle imperfections that make text feel like a human actually typed it.

Standard MCP Protocol

Works with any MCP-compatible client. No custom integration needed — just add the server to your configuration and go.

Realistic Chat Personas

Build AI chatbots that type like real people. Choose typing profiles — from careful to fast to angry — for distinct character voices.

Physics, Not Random

Every error follows keyboard proximity rules. Adjacent keys, device touch radius, hand position — the same physics that causes real human typos.

Full Parameter Control

The LLM decides: profile, device, layout, error rate, seed. All error types and their weights are exposed as tool parameters.

Setup & Documentation

How It Works

Request an API key using the form below. You'll receive it by email.

Add the MCP server to your AI client configuration (see setup guides below).

The LLM gains two tools — generate_typos and list_options — it can call during conversations to add realistic typing errors.

Setup Guides

Claude Desktop

Open Settings → Developer → Edit Config and add to mcpServers:

{
  "mcpServers": {
    "likelytypo": {
      "command": "npx",
      "args": ["-y", "likelytypo-mcp"],
      "env": {
        "LIKELYTYPO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Run in your terminal:

claude mcp add likelytypo \
  -e LIKELYTYPO_API_KEY=YOUR_API_KEY \
  -s user \
  -- npx -y likelytypo-mcp

Cursor

Open Settings → MCP, click Add new global MCP server, and paste:

{
  "mcpServers": {
    "likelytypo": {
      "command": "npx",
      "args": ["-y", "likelytypo-mcp"],
      "env": {
        "LIKELYTYPO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Open Settings → Cascade → MCP, click Add Server → Add custom server, and paste:

{
  "mcpServers": {
    "likelytypo": {
      "command": "npx",
      "args": ["-y", "likelytypo-mcp"],
      "env": {
        "LIKELYTYPO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Other MCP Clients

Any MCP-compatible client that supports stdio transport can use the server. The configuration pattern is the same:

Command: npx
Arguments: -y likelytypo-mcp
Environment variable: LIKELYTYPO_API_KEY set to your key

Available Tools

`generate_typos`

Generate realistic typing errors in text. Accepts parameters for text, device, profile, layout, error rate, error count, seed, and custom error weights.

`list_options`

Returns available devices, profiles, layouts, and error weight keys. No parameters required.

Request an API Key

Tell us about your use case and we'll send you an API key.