How does Mercateer work with Cursor?

Mercateer runs a public MCP server. You add it to Cursor's mcp.json, and Cursor's Agent can then call Mercateer tools to read calls and contacts, quote from your price book, and book appointments, without leaving the editor.

Global vs. project scope, which should I use?

Global (~/.cursor/mcp.json) is best if you regularly jump between repos. Project scope (.cursor/mcp.json) is best when only one repo's tasks involve Mercateer.

Does Cursor cache tool definitions?

Yes. Cursor caches the tool list at MCP-connect time. If we add new tools, hit Refresh in Cursor Settings, then Tools & MCP, to pick them up.

Which Mercateer plan do I need?

API and MCP access is included on the Crew and Fleet plans. You can start building free to set up your agent, then upgrade to connect Cursor.

Are there rate limits?

Yes. API requests are rate-limited per caller (about 60 requests per minute per API key or connected agent). If you exceed the limit you get an RFC 9457 problem response with a Retry-After header, so the agent can back off and retry.

Can I give an agent read-only access?

Read-only scoping works through API keys, which each carry an explicit scope list, so you can issue a read-only key for lookups and a separate read-write key for agents that book jobs or update contacts. Note that the OAuth sign-in these agents use grants the agent the same full account access you have in the dashboard, so to keep an agent read-only you would connect it with a scoped API key rather than OAuth. Either way, actions that spend money or change live settings still pause for your confirmation.

What happens to my data?

Your calls, contacts, and pricing stay in your Mercateer organization. Agents act through scoped OAuth tokens or API keys, every request is logged, and actions that spend money or change live settings require your confirmation. Nothing is used to train a shared model.

AI agent

Gestisci il tuo AI receptionist da Cursor

Aggiungi il server MCP di Mercateer a Cursor e fai parlare il tuo editor con la tua segreteria. L'Agent di Cursor legge chiamate e contatti, fa preventivi dal tuo listino prezzi e prenota interventi mentre lavori.

Installazione in pochi minuti Tutte le integrazioni

Cos’è Cursor?

Cursor è l'editor di codice con AI integrata e il suo Agent incorporato completa autonomamente attività accanto al tuo codice. Aggiungi il server MCP di Mercateer alla configurazione di Cursor e l'Agent potrà leggere chiamate e contatti, fare preventivi dal tuo listino prezzi e prenotare appuntamenti per la tua segreteria, direttamente dall'editor.

Cosa puoi fare con Cursor

Cerca chiamate, contatti e conversazioni

Controlla il calendario e gli interventi preventivati

Cerca nel tuo listino prezzi e crea preventivi

Prenota e riprogramma appuntamenti

IntegrationPages.Read and reply to inbox conversations

Iscriviti agli eventi di chiamate, contatti e prenotazioni

Installazione in pochi minuti

Apri la configurazione MCP di Cursor

Modifica ~/.cursor/mcp.json per una configurazione globale oppure crea .cursor/mcp.json nella root del tuo progetto per limitarla a un singolo progetto.

Aggiungi il server MCP di Mercateer

Incolla il frammento qui sotto in mcp.json.

json

{
  "mcpServers": {
    "mercateer": {
      "url": "https://api.mercateer.com/mcp"
    }
  }
}

Autorizza da Cursor

IntegrationPages.Open Cursor Settings, then Tools & MCP, and click Refresh next to the Mercateer entry_ Cursor opens the OAuth flow in your browser_ There are no API keys to paste_

Fai riferimento a Mercateer in chat

Nella chat di Cursor, menziona il server MCP di Mercateer con @mercateer oppure descrivi semplicemente ciò che vuoi e Cursor selezionerà gli strumenti giusti, chiedendo la tua approvazione per qualsiasi operazione che comporti spese o modifichi impostazioni attive.

Esempi di prompt

Recupera le chiamate perse di ieri e riassumi cosa voleva ogni chiamante.

Fai un preventivo per l’installazione di uno scaldabagno da 50 galloni dal mio listino prezzi.

Prenota l’intervento in Cedar Lane per giovedì alle 9:00 e conferma che lo slot sia libero.

Trova il contatto per (555) 123-4567 e mostra la sua ultima conversazione.

Quali chiamate questa settimana hanno chiesto un servizio che non offriamo ancora?

Domande frequenti

Funziona con tutto il tuo stack

Mercateer parla gli stessi protocolli degli strumenti che usi già.

Claude Desktop Claude Code Claude Cowork ChatGPT Codex Zapier n8n Make.com Webhooks

Vedi tutte le integrazioni

Metti Mercateer al lavoro con Cursor

Inizia gratis e collega il tuo front office in pochi minuti.

Inizia gratis

Nessuna carta di credito richiesta

Gestisci il tuo AI receptionist da Cursor

Cos’è Cursor?

Cosa puoi fare con Cursor

Installazione in pochi minuti

Apri la configurazione MCP di Cursor

Aggiungi il server MCP di Mercateer

Autorizza da Cursor

Fai riferimento a Mercateer in chat

Esempi di prompt

Domande frequenti

Come funziona Mercateer con Cursor?

Ambito globale o per progetto: quale devo usare?

Cursor memorizza nella cache le definizioni degli strumenti?

Quale piano Mercateer mi serve?

Ci sono limiti di frequenza?

Posso dare a un AI agent accesso in sola lettura?

Cosa succede ai miei dati?

Funziona con tutto il tuo stack

Metti Mercateer al lavoro con Cursor