@paxalabs/mcp

Official MCP server for the Paxa Labs API: Thai, English, and Mandarin Chinese speech AI for your agent, including local audio playback, plus transcription, translation, and document reading across languages.

An agent connected to this server can speak out loud through your machine's speakers, read long content aloud as a managed playback queue, save speech to audio files, listen for a spoken reply, transcribe recordings with subtitles, translate between 15 languages, read PDFs and images with OCR, and extract typed fields from documents.

Beta. The tool set is complete and tested end to end, but tool names and behavior may still change before 1.0 as feedback comes in. Report problems at https://github.com/paxalabs/mcp/issues.

Quick start

Add the server, then ask your agent to sign in to Paxa: your browser opens the Paxa sign-in page, and you approve there. New accounts include free credits. See Sign in for the details, or for using an API key instead.

Claude Code

claude mcp add paxa -- npx -y @paxalabs/mcp

Claude Desktop, Cursor, and other MCP clients

Add to your client's MCP configuration (for Claude Desktop: claude_desktop_config.json):

{
  "mcpServers": {
    "paxa": {
      "command": "npx",
      "args": ["-y", "@paxalabs/mcp"]
    }
  }
}

One click for Cursor or VS Code: the buttons install the same entry into ~/.cursor/mcp.json or VS Code's MCP settings.

Sign in

Ask your agent to sign in to Paxa (the sign_in tool), or run npx -y @paxalabs/mcp login in a terminal. Your browser opens the Paxa sign-in page with a code filled in, and you approve there. The sign-in is kept in your user config folder (~/Library/Application Support/paxa/auth.json on macOS, ~/.config/paxa/auth.json on Linux, %APPDATA%\paxa\auth.json on Windows), readable only by you, and every Paxa server and paxa say on the machine use it. It renews itself, and lasts until you sign out or leave it unused for 30 days.

The connection is listed under API keys at paxalabs.com/app/keys, where you can give it a credit limit or disconnect it. npx -y @paxalabs/mcp logout signs this machine out.

To use an API key instead, create one there and set PAXA_API_KEY in the server's configuration, for Claude Code:

claude mcp add paxa -e PAXA_API

... [View full README on GitHub](https://github.com/paxalabs/mcp#readme)