Connect your Agent to iSomor
Choose your Agent, copy the message and paste it into a conversation. Let it set up iSomor for PDF translation, layout preservation and bilingual output.
Copy. Paste. Connect.
Your Agent handles setup. You sign in and approve access when prompted.
Paste this into a conversation, not a terminal. Copying does not connect your account.
Manual setup & details
Use a client supporting remote Streamable HTTP and OAuth with PKCE S256. The client manages credentials; do not paste tokens into chat. Sign in in the browser and return to the authorization page to continue. Reopen the Agent session if new tools are not loaded. Reauthorize after expiry or to switch accounts. Revoking access stops future access; submitted translations continue.
Check existing MCP settings first. Reuse a matching isomor connection; do not overwrite unrelated settings or a different service with that name.
https://tryisomor.com/api/isomor/mcpCodex
If Codex CLI is available, add the server with the command below, then run codex mcp login isomor. If CLI is unavailable, use the app’s MCP settings or give me the shortest manual step.
codex mcp add isomor --url https://tryisomor.com/api/isomor/mcp
codex mcp login isomorClaude Code
If Claude Code CLI is available, add the server with the command below. Then ask me to open /mcp inside Claude Code, select isomor and complete authorization. /mcp is not a shell command.
claude mcp add --transport http --scope user isomor https://tryisomor.com/api/isomor/mcpCursor
Merge the JSON below into ~/.cursor/mcp.json for my user account, preserving existing entries. Then guide me to iSomor’s authorization action in Cursor’s MCP settings.
{
"mcpServers": {
"isomor": {
"url": "https://tryisomor.com/api/isomor/mcp"
}
}
}Tools and arguments
Your Agent discovers the actual schemas with tools/list. documents:read covers read operations; creating a translation also requires translations:write.
get_capabilities- Languages, formats and limits
list_files- Your latest 20 visible PDFs and file IDs
get_quota- Remaining account allowance
estimate_translation- Estimate page credits without reserving them
create_translation- Submit a translation after confirmation and reserve credits
get_translation- Check the existing job’s status
get_translation_results- Temporary translated and bilingual PDF links
Translation parameters
Get file_id from list_files. target_language: en or zh; source_language: auto (default), en or zh. pages is 1-based, e.g. 1-3,5; omit for all pages. output_formats: translated and/or bilingual (both by default). Each page costs 1 credit; each file allows 10 MiB and 20 pages. Call estimate_translation before create_translation; submit confirmed: true only after user confirmation. Reuse idempotency_key and the same parameters for retries. Status and results require job_id. Poll at least 5 seconds apart; download links last 15 minutes. Limit: 30 MCP requests per account per minute. Resolve isError responses before retrying.