MCP Setup

Quiet Typist MCP is a Streamable HTTP server that runs on your computer. Once an agent is connected, it can submit local audio and video files, transcribe them, and read the results.

Let your agent set it up

On the Quiet Typist MCP page, copy the Agent setup prompt and paste it into your agent's chat. The agent will follow this guide to finish the setup. The prompt generated by the app already includes your current MCP URL.

You can also copy this prompt:

Read the guide at https://quiettypist.com/docs/mcp-setup.md and follow its steps to set up Quiet Typist MCP for me.

Instructions for agents

• If the user gave you an MCP URL, use it. Otherwise, use the default http://127.0.0.1:36158/mcp.
• First, confirm the server is reachable using "Check the server" below. If it isn't, ask the user to open Quiet Typist and turn on Enable MCP Server on the MCP page, then continue.
• Use the setup method for the client you're running in, and prefer user-level configuration. If an anxinzhuan entry already exists, update only its URL and leave other MCP servers untouched.
• When you're done, tell the user which client to restart or refresh and which tools are available.

Connection details

If the default port is in use, Quiet Typist automatically switches to the next free port, so always use the MCP URL shown on the MCP page. The examples below use the default URL; replace it if yours is different. Keep Quiet Typist running while you use it.

Check the server

curl http://127.0.0.1:36158/health

A response of {"status":"ok"} means the server is running. In Windows PowerShell, use curl.exe.

Add it to your client

Claude Code

claude mcp add --transport http --scope user anxinzhuan http://127.0.0.1:36158/mcp

Then run claude mcp list to check the connection status.

Codex

codex mcp add anxinzhuan --url http://127.0.0.1:36158/mcp

Or add it manually to ~/.codex/config.toml:

[mcp_servers.anxinzhuan]
url = "http://127.0.0.1:36158/mcp"

To add it in the Codex app, choose Streamable HTTP and enter the MCP URL. See Using MCP for a screenshot.

Cursor

Add the following to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "anxinzhuan": {
      "url": "http://127.0.0.1:36158/mcp"
    }
  }
}

VS Code

Add the following to your user-level mcp.json (run MCP: Open User Configuration from the Command Palette) or to .vscode/mcp.json in your workspace:

{
  "servers": {
    "anxinzhuan": {
      "type": "http",
      "url": "http://127.0.0.1:36158/mcp"
    }
  }
}

Other clients

In your client's MCP settings, add a Streamable HTTP server (it may be labeled HTTP, Streamable HTTP, or streamableHttp). Set the name to anxinzhuan and the URL to your MCP URL. No authentication is needed. Clients that only support stdio can't connect directly yet.

Verify the connection

After saving the configuration, restart the client or refresh its MCP connection. Once connected, you'll see these tools:

From then on, just tell your agent something like "Use Quiet Typist to transcribe this file," along with the full path to the audio or video file.