Wisprs

Wisprs AI Connectors

Official Wisprs distribution package for ChatGPT, Codex, Claude Code, and remote MCP clients. Wisprs is a hosted remote MCP server: transcribe audio, video and public media links, then search, summarize, translate and export the transcripts. This repository holds the client configuration, plugin manifests and skills; the server itself runs at wisprs.co.

The authenticated Streamable HTTP endpoints (OAuth 2.1) are:

• ChatGPT: https://wisprs.co/api/mcp (23 tools, including transcribe_file for files attached in the chat and an inline transcript card).
• Claude connector and plugin: https://wisprs.co/api/mcp/claude (STT and other non-TTS workflows; 39 tools).
• Codex and other direct MCP clients: https://wisprs.co/api/mcp (universal surface; 43 tools, including TTS).
• Browser setup guide: https://wisprs.co/mcp/setup.

Listed in the official MCP Registry as co.wisprs/wisprs (see server.json).

The Claude release supports transcript, library, meeting, creator, support, and developer workflows:

• transcribe_url starts an asynchronous transcription from a public HTTPS media URL.
• get_private_media_upload_handoff opens the authenticated Wisprs uploader for local or private media without sending file bytes or upload tokens through the model.
• get_job_status checks the durable operation without creating duplicate work.
• get_transcript retrieves a completed transcript in bounded, cursor-based pages.
• get_transcript_artifact retrieves generated content in bounded pages.
• search_library finds ranked moments in the connected tenant's library.
• export_transcript creates TXT, SRT, VTT, JSON, Markdown, or DOCX as a private expiring MCP resource.
• summarize_transcript and generate_chapters create reusable structured artifacts.
• repurpose_transcript creates show notes, threads, blog drafts, or quote selections.
• translate_transcript creates a reusable language-specific artifact.

The server owns authentication, authorization, tenant isolation, idempotency, rate limits, cost controls, audit records, and data retention. This repository contains no Wisprs service source code, credentials, or customer data.

Install for Claude Code

Test a local checkout:

claude --plugin-dir ./wisprs-ai-connectors/claude

Or add this repository as a marketplace:

/plugin marketplace add Wisprs/wisprs-ai-connectors
/plugin install wisprs-ai-connectors@wisprs-plugins

In Claude Code, run its /mcp command to complete OAuth in the browser. Do not paste tokens into the repository, prompts, or configuration files.

Install for ChatGPT and Codex

Wisprs is published in ChatGPT's app directory: search for Wisprs, connect, and sign in. Attach a recording or paste a link and ask for a transcript; the transcript card shows progress and the finished text in the chat.

The .codex-plugin/plugin.json manifest uses .mcp-openai.json and the universal endpoint for Codex. Any other MCP client can connect to https://wisprs.co/api/mcp directly and complete OAuth in the browser.

Direct MCP configuration

Claude hosts use claude/.mcp.json (the Claude plugin lives in claude/, which holds only its manifest, MCP config, skills and icon). Other hosts can use .mcp-openai.json for the universal endpoint. Each endpoint returns OAuth protected-resource metadata and drives browser authorization. Static bearer tokens are neither required nor accepted in this package.

Correct asynchronous usage

1. Tell the user that transcription starts billable asynchronous work and obtain confirmation when the host has not already done so.
2. Generate one opaque idempotency key for the logical request.
3. Call transcribe_url once and retain its operationId.
4. Poll get_job_status no faster than retryAfterSeconds.
5. After completed, use the returned opaque transcriptionId with get_transcript.
6. Follow nextCursor exactly and state when the response is partial.

For exports and AI transformations, use one stable idempotency key, poll the returned operation, then read the exact export resource URI or call get_transcript_artifact with the completed result metadata. Never place a large export directly into conversation context when the MCP resource is available.

Never retry an ambiguous transcribe_url call with a new idempotency key. That can create duplicate billable work.

Development

Requirements: Node.js 22 or newer and, for host validation, current Claude Code and Codex tooling.

npm test
npm run validate
npm run package

npm run validate:live-links additionally verifies public policy and support links over HTTPS. Host-specific test cases and release gates are in docs/HOST_COMPATIBILITY.md and docs/REVIEWER_GUIDE.md.

Security and privacy

Read SECURITY.md before reporting a vulnerability and PRIVACY.md for the package's data boundaries. The service policies are published at wisprs.co/privacy and wisprs.co/terms.

Release status

Version 0.30.0. Published in ChatGPT's app directory and the official MCP Registry; the Claude directory listing is in review. See CHANGELOG.md and release.json for compatibility and provenance.

License

MIT. See LICENSE.