Tool categories
Turn on only the tool categories you need with the toolsets parameter of the server URL. The 8 categories, the syntax, ready-made combinations, and how to change them in each client.
The Emelia MCP server has 143 tools. Claude loads them on demand, but Cursor, VS Code and most other clients send the description of every tool to the model with each message, and some cap the number of tools. Add toolsets to the URL of the server to turn on only the categories you need:
https://mcp.emelia.io/mcp?toolsets=campaigns,lists,enrichmentThere is one server and one URL: the categories are a parameter of that URL, not separate servers to add.
The categories
| Category | What it covers | Tools |
|---|---|---|
campaigns | Campaigns, their sequence and its guide, the contacts of a campaign, statistics and activities, manual tasks, attachments and voice notes | 32 |
lists | Lists, contacts, exports, custom variables | 17 |
enrichment | Find an email or a phone number, verify an email | 5 |
linkedin_scraper | Sales Navigator and LinkedIn search extractions, and the LinkedIn accounts that run them | 15 |
mailboxes | Sending mailboxes, warmup, health check | 8 |
account | Credits, webhooks, blacklist | 5 |
inbox | Read, search, sort, reply to and send the emails of the inbox | 39 |
inbox_settings | Labels, AI label rules, views, inbox filters, auto-forward rules | 22 |
The inbox and inbox_settings tools appear only once the Inbox has been opened in Emelia: see The inbox tools.
Syntax
- Separate the categories with commas, or repeat the parameter:
?toolsets=campaigns,listsand?toolsets=campaigns&toolsets=listsare the same. - Case is ignored, and so are the spaces around a name:
?toolsets=Campaigns,LISTSworks. - Without the parameter, every category is on. That is the right choice for Claude.
- An unknown category gets an HTTP
400that lists the valid ones, and the client cannot connect until the URL is fixed:
{
"jsonrpc": "2.0",
"error": {
"code": -32602,
"message": "Unknown toolset: campaign. Valid toolsets: campaigns, lists, enrichment, linkedin_scraper, mailboxes, account, inbox, inbox_settings."
},
"id": null
}Ready-made combinations
| Use | URL | Tools |
|---|---|---|
| Prospecting: extract, enrich, load lists, run campaigns | https://mcp.emelia.io/mcp?toolsets=campaigns,lists,enrichment,linkedin_scraper | 69 |
| Replies: read and answer the inbox | https://mcp.emelia.io/mcp?toolsets=inbox | 39 |
| Campaign follow-up: results and replies | https://mcp.emelia.io/mcp?toolsets=campaigns,inbox | 71 |
| Deliverability: mailboxes, warmup, blacklist | https://mcp.emelia.io/mcp?toolsets=mailboxes,account | 13 |
The counts with inbox assume the Inbox is set up. Without it, ?toolsets=inbox lists no tool at all.
What the model sees
With the parameter, the server tells the model which categories are on, in the instructions it sends when the session opens. With ?toolsets=campaigns,inbox:
Tool categories enabled for this connection: campaigns, inbox. The other categories (lists, enrichment, linkedin_scraper, mailboxes, account, inbox_settings) are turned off by the toolsets parameter of the server URL: their tools are not available, even when a description mentions them.A tool of a category that is off cannot be called, even when the description of another tool names it. For example, create_list (lists) tells the model to attach the list with update_campaign_recipients (campaigns): without campaigns, the instructions tell the model that this tool is off. Add the category to the URL if the assistant needs it.
Change the categories
The categories are part of the URL of the server. To change them, edit the URL in your client, then reconnect:
| Client | How |
|---|---|
| Claude Code | claude mcp remove emelia, then claude mcp add again with the new URL; or edit the url of .mcp.json. Start a new session to load the new list. |
| Claude Desktop and claude.ai | Remove the custom connector, add it again with the new URL, then click Connect. With the configuration file, edit the URL in args, then quit and restart the app. |
| Cursor | Edit the url in mcp.json, then turn the server off and on again in the MCP settings of Cursor. |
| VS Code | Edit the url in mcp.json, then restart the server (the Restart action above it in mcp.json, or the command MCP: List Servers). |
| Other clients | Edit the URL of the server, then reconnect it. |
Connect the MCP server
Connect Claude Code, Claude Desktop, ChatGPT, Cursor, VS Code or any MCP client to your Emelia account, by signing in or with an API key. 143 tools in 8 categories, for campaigns, lists, enrichment, LinkedIn extractions, mailboxes and the inbox.
Tools
Every tool of the Emelia MCP server, by category. 82 tools for campaigns, lists, enrichment, LinkedIn extractions, mailboxes and the account, and 61 for the inbox.