create_translation
Create a document translation task. Supports file upload via path or URL.
LABSCO SUMMARY
A paper in a language you do not read stops being a dead end.
Search and translation sit behind one key, so identifying a relevant paper and queueing its translation happen without leaving the session. The translation path is deliberately asynchronous — create_translation hands back a task, get_translation polls it for status and result URLs — which means the client has to come back rather than block. optimize_math_formula is the option worth setting: it exists for documents where the notation is the content.
What it is
A client for Suppr's literature service: semantic search over academic papers and an asynchronous document translation queue.
What you get
- Semantic search over academic literature from a natural-language query, with a topk cap and an auto_select option
- Translation jobs created from a local file path or a URL, between a source and target language, with optimize_math_formula for notation-heavy documents
- Job status and result URLs retrieved by task_id, since translation runs asynchronously rather than returning in the call
- A paginated list of every translation job you have queued before
Requirements
A Suppr API key in SUPPR_API_KEY, and a local file path or a reachable URL for anything you want translated.
Setup effort
One command plus a key — npx suppr-mcp, then supply credentials
USE CASES
01
Finding papers when all you have is the question
Describe what you are looking for in ordinary language and take back the papers that match, capped at the number you asked for.
02
Getting a paper into a language you read
Queue the file or URL for translation with the math-formula option set, then poll the task for its status and result URLs.
03
Picking up translations you queued earlier
List the jobs you have run before, then fetch the result URLs for the ones that have since finished.
4 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_translation
Get translation task details and status. Use this to check progress and get result URLs.
list_translations
List translation tasks with pagination. View all historical translation tasks.
search_documents
AI-driven semantic search for academic literature. Input natural language query to find relevant papers.
BEFORE YOU INSTALL
What to know first
Tools you get
4 tools when we connected. create_translation is asynchronous: it returns a task_id, and you poll get_translation until status is DONE before target_file_url exists.
Requires
- npx on PATH
- SUPPR_API_KEY in your environment
Where it runs
Both documented setups run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 4 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx suppr-mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"suppr": {
"command": "npx",
"args": [
"-y",
"suppr-mcp"
],
"env": {
"SUPPR_API_KEY": "<YOUR_SUPPR_API_KEY>"
}
}
}
}Claude Desktop — global install
CLAUDE DESKTOP — GLOBAL INSTALL · JSON
{
"mcpServers": {
"suppr": {
"command": "suppr-mcp",
"env": {
"SUPPR_API_KEY": "<YOUR_SUPPR_API_KEY>"
}
}
}
}
