How do you translate a comic from Claude or ChatGPT?
Nine tools, one rights check, and a protocol that changed under us while we built it.
Add https://bublate.com/mcp as a custom connector in Claude, ChatGPT or another MCP client and sign in to Bublate. The assistant can then create a chapter, add its pages from image links, quote the price, start the translation after you confirm your rights to the work, check the status and give you download links for the lettered pages.
The Model Context Protocol (MCP) lets an assistant call tools on a server. Bublate now runs one at https://bublate.com/mcp, on top of its publisher API. This post covers how to connect, what the tools do, and the decisions behind them: the rights check, sign-in without a new account system, and supporting two versions of the protocol on one endpoint.
How do you connect?
In Claude, add a custom connector with the URL above. In Claude Code, one command does it:
claude mcp add --transport http bublate https://bublate.com/mcpThe client opens the Bublate sign-in page, you allow the connection, and the assistant then acts as your own account. A client that cannot do OAuth can send a Bublate API key in the Authorization header instead. A key acts as the owner of its workspace.
What can the assistant do?
| Tool | What it does | Marked as |
|---|---|---|
list_series, list_chapters, list_recent_translations | Reads the library and the status of each translation | Read-only |
quote_price | Credits per language for an uploaded chapter, or an estimate from page sizes | Read-only |
create_chapter | An empty chapter in a new or existing series | Write |
add_pages | Pages from public image links or base64 data, 20 per call | Write |
start_translation | Starts one or more languages and spends credits | Destructive |
get_translation_status, list_output_files | Progress, then the lettered pages with one-hour download links | Read-only |
A typical request reads: "Translate chapter 12 of Moonlit Garden into English and Spanish. The pages are at these links." The assistant creates the chapter, adds the pages, shows the price and asks before it starts.
Why does the assistant ask about rights?
Because the tool will not start without it. start_translation has a required confirm_rights field, and its description tells the assistant to set it to true only after the user confirms that they own the work or have the rights to translate it. If the field is false, the tool answers with exactly that instruction, so the assistant asks you instead of guessing. The tool is also annotated destructiveHint: true, because it spends credits. Clients such as Claude then ask for confirmation on every call, while read-only tools run without a prompt.
How does sign-in work?
Bublate already signs people in with Clerk, and Clerk can act as an OAuth 2.1 authorization server. The MCP server only has to be a resource server:
- An unauthenticated request gets a 401 with
WWW-Authenticate: Bearer resource_metadata="https://bublate.com/.well-known/oauth-protected-resource/mcp". - That document (RFC 9728) names
https://clerk.bublate.comas the authorization server. - The client registers itself with a Client ID Metadata Document or with Dynamic Client Registration, signs the user in with PKCE, and asks for a token for the resource
https://bublate.com/mcp(RFC 8707). - Clerk puts that resource in the token's
audclaim, and the server refuses any token without it. A token issued to another app is useless here.
We tested the whole flow with a script: discovery, client registration, sign-in and consent in a headless browser, the code exchange and then tool calls with the token.
Why two protocol versions on one endpoint?
The MCP specification changed on 2026-07-28. The new version has no initialize handshake and no sessions: every request carries its protocol version in _meta and in an MCP-Protocol-Version header, and servers answer server/discover. Many clients still speak the 2025 versions, which start with initialize. The server reads each request and answers in the version it uses. We wrote the protocol layer by hand, without an SDK, because the stateless design fits a Cloudflare Worker well: every request stands alone, and no session store is needed.
How do the download links work?
A chat client cannot attach an API key to a link it shows you. So list_output_files returns links signed with an HMAC of the version, the file and an expiry time. Each link works for one hour without sign-in. A changed character, another file name or an old link answers 403.
Where is it listed?
In the official MCP Registry as com.bublate/bublate, proven with a DNS record on bublate.com. Clients that discover servers by domain can read https://bublate.com/.well-known/ai-catalog.json and the Server Card at https://bublate.com/mcp/server-card. The full reference is on the developers page.
Frequently asked questions
What is the Bublate MCP server URL?
https://bublate.com/mcp. It uses the Streamable HTTP transport and speaks MCP 2026-07-28 and the 2025-11-25, 2025-06-18 and 2025-03-26 versions.
Does the Bublate MCP server need an API key?
No. Clients that support OAuth open the Bublate sign-in page and get a token for your own account. Clients without OAuth can send a Bublate API key in the Authorization header instead.
Can an assistant spend my credits without asking?
The start tool is marked destructive, so clients such as Claude ask for confirmation before each call. It also refuses to run until the user confirms the rights to the work. The other tools only read data or create empty chapters and pages, which cost nothing.
Which assistants work with it?
Any MCP client that supports remote servers over HTTP, for example Claude, Claude Code, ChatGPT and Cursor. Clients that only run local servers can use a local proxy such as mcp-remote.
Sources
- Model Context Protocol specification 2026-07-28 · checked
- MCP authorization (OAuth 2.1, RFC 9728, RFC 8707) · checked
- Claude: authentication for connectors · checked
- Clerk: build an MCP server · checked
- MCP Registry entry com.bublate/bublate · checked
Related
Written by the Bublate team. We build tools that translate and letter comics, and we publish what we measure along the way.
Stories about comics in every language, once a month
Related articles
Comic translation API: chapters from your own pipeline
By the Bublate teamThe Bublate API takes webtoon and manga pages, translates and re-letters them, and calls your server when a chapter is ready. Five requests, with curl examples.
What a chapter costs: manga translation rates in 2026
By the Bublate teamManga translation rates by role, per page and per chapter: translator, letterer, sound effects and proofreader, with sources, next to the cost of software.