Content
# loco-mcp
An MCP server that lets AI assistants manage translations through the [Loco](https://localise.biz) API.
## What it does
This MCP provides tools to:
- List, create, update, and delete translatable assets
- Get and update translations across locales
- Manage tags on your assets
## Use it with your favorite tool
### OpenCode
```json
{
"mcp": {
"loco": {
"type": "local",
"command": "npx",
"args": ["-y", "loco-mcp", "--api-key", "<your-api-key>"]
}
}
}
```
## API Key Configuration
The API key can be provided in several ways. When multiple sources are available, the resolution order is:
1. **Tool parameter** — pass it as the `apiKey` parameter in a tool call (highest priority, overrides all others)
2. **CLI argument** `--api-key <key>` — pass the key directly as a command-line argument
3. **Environment variable** `LOCO_MCP_API_KEY` — set the key in your environment
4. **File path** `--api-key-relative-path <path>` — read the key from a file (path relative to the working directory)
### Examples
```bash
# 1. Direct CLI argument
npx -y loco-mcp --api-key loco_abc123
# 2. Environment variable
LOCO_MCP_API_KEY=loco_abc123 npx -y loco-mcp
# 3. Read from a file
npx -y loco-mcp --api-key-relative-path .loco-api-key
```
You can find your API key in your Loco project under **Developer Tools → API Keys (Full Access Key)**.
