manage_keyword_list
Create, rename, add keywords to, remove keywords from, or delete a client's saved keyword list. A keyword added from a stored lookup (resultKey) keeps that lookup's figures with their dates; one typed in has none until researched. A client has up to 50 lists of up to 5,000 keywords. Delete removes the list only, never a stored lookup. Spends nothing. Requires MCP write actions; without confirm:true it returns a preview.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>",
"clientId": "<clientId>"
},
"name": "manage_keyword_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | create, rename. | |
| action | Yes | ||
| listId | No | The list (rename, add, remove, delete). | |
| confirm | No | Set true to apply. Omit for a preview. With confirm:true, also pass the preview's previewToken. | |
| country | No | create: ISO 3166-1 alpha-2. | |
| clientId | Yes | Client id (from list_clients). | |
| keywords | No | create, add, remove. | |
| language | No | create: language code. | |
| resultKey | No | create, add: the stored lookup whose figures the added keywords keep. | |
| previewToken | No | With confirm:true: the previewToken from this tool's preview (valid 15 minutes, once, for exactly the previewed arguments). |