Skip to main content
For developers

Agent mode: use a plug-in from your own AI agent

Connect an AI agent that is not ChatGPT or Claude to a business's plug-in: results as data with no card, one call that describes the business, and a preview before any request is sent.

Browse all topics

Every BizPlug plug-in is an MCP server (streamable HTTP, JSON responses) for one business, at https://mcp.bizplug.ai/plugin/<industry>/<business>. ChatGPT and Claude show it with a card. From plug-in version 0.34.0 an agent you build can ask for agent mode instead: the same plug-in and the same data, without the card. ChatGPT and Claude never get agent mode, and a plug-in on an older version answers as before.

Find a plug-in

The plug-ins of businesses that chose to be listed are at /.well-known/bizplug-plugins.json: name, summary, industry, place, website and the plug-in's address. The same businesses are on Businesses. A plug-in that is not listed works the same way when you have its address.

Ask for agent mode

Name the capability under capabilities.experimental when you connect. The response carries an Mcp-Session-Id header starting agent-: send it back on every later request.

POST https://mcp.bizplug.ai/plugin/<industry>/<business>
{ "jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {
  "protocolVersion": "2025-06-18",
  "clientInfo": { "name": "my-agent", "version": "1.0" },
  "capabilities": { "experimental": { "ai.bizplug/agent": {} } } } }

What changes in agent mode

  • There is no card and no show_menu tool, and resources/list is empty.
  • describe_business says in one call what the business offers: its services, the ids of what can be looked up, its own forms with their fields, its hours, what each tool is for and the rules. It gives no prices: those come from the look-up tools.
  • Every tool declares an outputSchema. A result is { view, business, <view>: … } in structuredContent, and the same JSON as text.
  • A tool that sends something has a confirmed argument. See below.

Sending a request

  1. 1Call the tool without confirmed. Nothing is sent: you get a preview with what would be sent.
  2. 2Show the preview to the person you act for.
  3. 3When they agree, call the tool again with the same arguments and confirmed: true. The request is sent to the business and you get a sent result with a reference.
  • A request needs the name and email of the person you act for, so the business can reply to them. Do not send your own or an invented one.
  • Limits: at most 20 requests an hour to one business from agents, and 5 a day for one customer email. Over a limit, the tool says so and you can use the business's contact details instead.
  • The business sees that the request was sent by an agent. Nothing is booked, held or charged until the business confirms.
  • A plug-in that asks its customers to sign in asks an agent the same way.

Agent mode is on a business's own plug-in only, not on the industry-wide plug-ins, the city guides or the directories. The tools a business added from its own server (account tools) are passed on as they are, without a preview step.

Last reviewed 21 November 2026

Was this page helpful?