← All agents

Connect Concya to any agent

Any agent that can make web requests connects to Concya. Most need one sentence.

Copy this and send it to your agent. It guides you through the setup.

From now on I want to use Concya whenever we work on restaurant, hotel, or property tasks. Set Concya up for me by following the instructions at https://www.concya.com/agents.md and guide me through the steps.

What you need

Concya exposes the venue directory, guest-safe profiles, and request-mode booking tools. Public reads need no key; venue questions and booking requests need a partner key.

What it can do

  • Searches the live venue directory by name, city, or cuisine.
  • Reads a guest-safe venue profile, hours, and whether reservations are open.
  • Checks whether a date and party size are requestable.
  • Asks the venue a question and stages a pending booking request with a partner key.

More ways to connect

By hand, in the agent’s settings:

Add a remote MCP server named concya with the address https://www.concya.com/api/protocol/mcp. There is no OAuth flow yet; public reads need no credential, and keyed tools take a partner key.

An agent that can make HTTP requests without MCP can use the REST surface at https://www.concya.com/api/protocol/v/[handle]/call with the concya/0.1 envelope. The OpenAPI spec has every method.

Every coding agent on the computer at once, with add-mcp (it writes Concya into Claude Code, Codex, Cursor, VS Code, Gemini CLI, Windsurf, and more; public reads work immediately, and keyed tools take a partner key):

bash
npx add-mcp https://www.concya.com/api/protocol/mcp -n concya

An agent with no browser, a scheduled job, or a self-hosted one can still use public reads; keyed tools take a partner key. The setup guide has the tool-by-tool list.

How to use it

Once connected, talk to your agent the way you already do. Concya is there when a venue question or a booking comes up:

  • “What’s on at the venue tonight?”
  • “Find a hotel in Philadelphia that takes requests.”
  • “Ask the venue about parking and request a table for four.”

If something goes wrong

If a tool returns 401, it needs a partner key. Public reads work without one. The setup guide lists which tools are keyed.

Something not working, or a question on how to use it? Send this to your agent.

Something with Concya is not working, or I have a question about it. Read https://www.concya.com/agents.md and help me, one step at a time.

Go deeper

The guide your agent reads is public: https://www.concya.com/agents.md.

The REST surface and every method: https://www.concya.com/api/protocol/openapi.json.

The developer docs have the rest. docs.concya.com.