How does Mercateer work with OpenCode?

Mercateer runs a public MCP server. You add it to opencode.json as a remote server, and OpenCode can then call Mercateer tools to read calls and contacts, quote from your price book, and book appointments, from the terminal.

Is OpenCode free to use?

Yes. OpenCode itself is free and open source, and it works with 75+ LLMs, so you bring the model account you already have. On the Mercateer side, API and MCP access is included on the Crew and Fleet plans.

Global vs. project scope, which should I use?

Project scope (opencode.json in your repo root) is best when only one repo's tasks involve Mercateer. Global (~/.config/opencode/opencode.json) is best if you regularly jump between repos.

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 OpenCode.

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.

IntegrationPages.AI agent

IntegrationPages.Run your AI receptionist from OpenCode

IntegrationPages.Add the Mercateer MCP server to OpenCode and run your front office from the terminal_ OpenCode reads calls and contacts, quotes from your price book, and books jobs from a natural-language instruction_

IntegrationPages.Install in minutes IntegrationPages.All integrations

IntegrationPages.What is {name}?

IntegrationPages.OpenCode is an open-source AI coding agent built by Anomaly: it runs in your terminal with a rich interface and works with 75+ LLMs_ Add the Mercateer MCP server to its config and OpenCode can do front-office work too, pulling calls and contacts, quoting from your price book, and booking jobs without leaving the command line_

IntegrationPages.What you can do with {name}

IntegrationPages.Look up calls, contacts, and conversations

IntegrationPages.Check the schedule and quoted jobs

IntegrationPages.Search your price book and build quotes

IntegrationPages.Book and reschedule appointments

IntegrationPages.Read and reply to inbox conversations

IntegrationPages.Subscribe to call, lead, and booking events

IntegrationPages.Install in minutes

IntegrationPages.One-step setup

IntegrationPages.Fastest path: paste this into {name} and it connects Mercateer itself_

prompt

Fetch https://mercateer.com/prompt.md

IntegrationPages.Add the Mercateer MCP server

IntegrationPages.Merge the snippet below into opencode_json in your project root, or into ~/_config/opencode/opencode_json to make it available everywhere_

json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mercateer": {
      "type": "remote",
      "url": "https://api.mercateer.com/mcp",
      "enabled": true
    }
  }
}

IntegrationPages.Authorize over OAuth

IntegrationPages.Run `opencode mcp auth mercateer` in your terminal and finish the sign-in in your browser_ There are no API keys to paste_

IntegrationPages.Confirm the connection

IntegrationPages.Run `opencode mcp list` to confirm the Mercateer server shows as connected, then try one of the example prompts below_

IntegrationPages.Try a prompt

IntegrationPages.Ask OpenCode to do real front-office work, like quoting a job or booking an appointment_ It calls the right Mercateer tools and pauses for your approval on anything that spends money or changes a live setting_

IntegrationPages.Example prompts

IntegrationPages.You

IntegrationPages.Pull yesterday's missed calls and summarize what each caller wanted_

IntegrationPages.You

IntegrationPages.Quote a 50-gallon water heater install from my price book_

IntegrationPages.You

IntegrationPages.Book the Cedar Lane job for Thursday at 9am and confirm the slot is open_

IntegrationPages.You

IntegrationPages.Find the contact for (555) 123-4567 and show their last conversation_

IntegrationPages.You

IntegrationPages.Which calls this week asked for a service we don't offer yet?

IntegrationPages.Frequently asked questions

IntegrationPages.Works with your whole stack

IntegrationPages.Mercateer speaks the same protocols as the tools you already use_

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

IntegrationPages.See all integrations

IntegrationPages.Put Mercateer to work with {name}

IntegrationPages.Start free and connect your front office in minutes_

IntegrationPages.Start free

IntegrationPages.No credit card required

IntegrationPages.Run your AI receptionist from OpenCode

IntegrationPages.What is {name}?

IntegrationPages.What you can do with {name}

IntegrationPages.Install in minutes

IntegrationPages.One-step setup

IntegrationPages.Add the Mercateer MCP server

IntegrationPages.Authorize over OAuth

IntegrationPages.Confirm the connection

IntegrationPages.Try a prompt

IntegrationPages.Example prompts

IntegrationPages.Frequently asked questions

IntegrationPages.How does Mercateer work with OpenCode?

IntegrationPages.Is OpenCode free to use?

IntegrationPages.Global vs_ project scope, which should I use?

IntegrationPages.Which Mercateer plan do I need?

IntegrationPages.Are there rate limits?

IntegrationPages.Can I give an agent read-only access?

IntegrationPages.What happens to my data?

IntegrationPages.Works with your whole stack

IntegrationPages.Put Mercateer to work with {name}