Skip to content

Connect to the MCP Server

The Algebras MCP server gives AI agents the platform’s translation, fluency scoring and glossary tools through the Model Context Protocol. Once it is connected, you can ask your agent things like “translate these strings into German with our game glossary” or “extract the terms from this script and add them to a new glossary”, and it calls Algebras for you. See Tools for everything it can do.

URL https://platform.algebras.ai/api/mcp
Transport Streamable HTTP
Authentication x-api-key: <your API key> header

The server is stateless: every request is authenticated with the key, and there is no session to keep alive. Tool calls are billed and limited like the same calls through the API, against the organization the key belongs to.

Create a key in the app under API Keys (see API Keys). The key belongs to the organization you create it in, so the agent sees that organization’s glossaries and uses its plan.

Most clients load MCP servers at startup: restart the client (or reload its MCP servers) after changing the config.

Terminal window
claude mcp add --transport http algebras https://platform.algebras.ai/api/mcp \
--header "x-api-key: YOUR_API_KEY"

Add --scope user to use it in every project, or --scope project to share it with your team through .mcp.json (then use "x-api-key": "${ALGEBRAS_API_KEY}" in that file so the key stays out of the repository). Check the connection with /mcp.

For the full translation workflow (onboarding, glossary, translation and QA skills), install the Algebras agent plugin instead; its setup connects the server for you:

Terminal window
claude plugin marketplace add algebras-ai/algebras-agent
claude plugin install algebras-agent@algebras-agent

Then run /algebras-agent:setup in Claude Code.

Ask your agent to “list my Algebras glossaries” or “which languages does Algebras support”. To check the key and the server without a client, list the tools with curl:

Terminal window
curl -s https://platform.algebras.ai/api/mcp \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

The response lists every tool with its input schema.

Problem Cause and fix
401 Unauthorized The x-api-key header is missing, or the key is wrong or deleted. Check the header name (not Authorization) and create a new key if needed.
402 The organization has no active plan or quota left, or has unpaid invoices. See Billing and Plans.
The tools don’t show up Restart the client or reload its MCP servers. In Claude Code, /mcp shows the server status and error.
406 Not Acceptable from curl Send Accept: application/json, text/event-stream. MCP clients do this themselves.
Wrong glossaries The key belongs to another organization. Create a key in the organization you want.