Skip to main content
← MCP Tools

synonym_add

Adds a single alias to a term, creating the entry if it doesn't exist.

Availability: single-repo stdio (travsr mcp) only. Not in global stdio or SSE.

Input schema​

{
"type": "object",
"required": ["term", "alias"],
"properties": {
"term": {
"type": "string",
"description": "The query term to expand"
},
"alias": {
"type": "string",
"description": "An alias the term should also match"
}
},
"additionalProperties": false
}

No repo parameter. Stdio (single-repo) sessions only, since this mutates the one open repo's dynamic synonym table.

Output​

A plain control string, not JSON: ok on success. On failure it is the store's own error text, most commonly fts_synonyms is full (200 rows). Use \travsr synonym remove` to make space.An invalidtermoralias(fails argument validation before it reaches the store) returnsinvalid input`.

Notes​

To add multiple aliases at once, call synonym_add once per alias or use synonym_set to replace all aliases in one call. The synonym table has a cap of 200 pairs per repository.