Example
https://api.minimo.it/mcp (Streamable HTTP).
Most clients (Claude, ChatGPT, Cursor) don’t need an API key: point them at the URL and they discover the Minimo sign-in automatically (OAuth). You just click Authorize.
For scripts, automations and clients that can’t run a sign-in flow, use an API key: an mn-… key with the MCP (AI agent) permission (mcp:invoke), sent as a Bearer token in the Authorization header.
Get an API key
1
From the dashboard (fastest)
In Settings → Mo & MCP, the “Use Mo everywhere” card shows your key already generated. Copy it straight
from the input. It’s scoped to MCP only and valid for 1 year.
2
Or from Developer settings
Go to Developer → API keys, create a new key and select the MCP (AI agent) permission.
3
Copy it immediately
The key is shown once. Store it securely: you won’t be able to see it again.
Claude (claude.ai)
1
Add the custom connector
Open Claude → Settings → Connectors and click Add custom connector.
Name it
Minimo and set the URL to https://api.minimo.it/mcp.2
Authorize
Press Add, then Connect. A Minimo window opens: click Authorize. No key to copy.
Claude Code (CLI)
Cursor
Add Minimo to.cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
ChatGPT
Open ChatGPT → Settings → Apps & Connectors, enable Developer mode (Plus/Pro/Enterprise), click Add connector with the Minimo MCP URL, set authentication to OAuth and click Authorize in the Minimo window.Try it
Paste this into your connected agent. It only reads, and proves the connection end to end:Edit an automation from your agent
Beyond creating automations from a prompt (minimo_automation_create-from-prompt), an agent can also fix an existing flow without rebuilding it:
minimo_automation_getreads the full graph: nodes (trigger, waits, condition rules with their ids, emails), edges, and run mode.minimo_automation_edit-graphedits the graph of a disabled automation (drafts, or paused flows): change a Condition rule, swap the two branches of a condition, rewire an edge, insert or remove a node. Operations apply all together (an invalid batch changes nothing) and every edit is recorded in the account audit (visible under Logs). Active automations are refused: pause first, edit, review, re-enable.- The emails inside a flow are edited with the template tools (
minimo_email_edit,minimo_template_set-subject,set-sender,set-category, …) using scopeautomation.
Work your inbox from your agent
The agent can read and answer the conversations of your inbox, one thread per contact with every channel together:minimo_inbox_list-threadslists threads with the inbox filters (open, unread, needs attention, assigned to me) and the tab counters;minimo_inbox_search-threadsfinds threads by what was written in them.minimo_inbox_get-threadreads a thread across channels. It never marks it as read.minimo_inbox_update-threadmarks read or unread, closes, snoozes, assigns or pins;minimo_inbox_set-aiturns the AI off or on for one conversation.minimo_inbox_replyanswers by WhatsApp (only inside the 24-hour window) or email (same email thread), as you. It works in two steps: withoutconfirmit returns a preview and sends nothing; it sends only withconfirm: true, after your OK.
What your agent learns on connect
When your agent connects, Minimo sends it short server instructions: what Minimo is, what it can do in your workspace, and the rules it must follow. Your agent doesn’t need a custom prompt to get started. The rules:- It answers in your language. Write in Italian and it replies in Italian, even though the tools and these docs are in English.
- Nothing reaches real contacts without your OK. Automations and campaigns it creates are
disabled drafts: it shows you what it built and activates, sends or schedules only after you say
so. Tools that send real messages also require an explicit
confirm. - Test sends go to you.
minimo_email_send-testsends only to your own address, never to real contacts. - It reads your data first. Before building an automation it checks the database connection and the schema analysis, and turns values that live in other tables into dynamic fields instead of saying the data is missing.
- Unsubscribe requests are honoured. If a contact asks to stop receiving marketing, the agent calls
minimo_contact_opt-out. It applies your company’s opt-out scope, just like the Opt Out API, and never blocks transactional messages. - New tools need a new chat. The tool list is loaded when a chat starts: if a tool Minimo just released is missing, open a new chat (no need to reconnect).
minimo_docs_guide with no arguments. It gets
the index of this documentation and can then read any page.
Troubleshooting
- 401 Unauthorized: the key is missing the
mcp:invokepermission, expired, or malformed. Mint a fresh one from the dashboard card. - Connector shows no tools: make sure the URL is exactly
https://api.minimo.it/mcp(no/v1prefix) and the transport is HTTP (not SSE). - Wrong workspace: a key belongs to one workspace, the one it was created in. Ask the agent which workspace it’s connected to, or reconnect from Settings → Mo & MCP.