Connect ByDomu to Claude (MCP)

Let Claude or another MCP client query your agency, read-only.

GuideRead-onlySecret key

Before you start. You need a Business or Enterprise plan (Individual and Professional with approved access), a verified email and to be past the free trial.

Create a read-only secret key

In ByDomu, go to Settings › API Keys › New key, choose Custom and tick only these read permissions. Copy the key: the full key is shown only once.

What forPermission

Search and view listingsportal:read

Search and view contactscontacts:read

Calendar and upcoming appointmentsappointments:read

Pipelines and dealsdeals:read

Pending taskstasks:read

A contact’s messages (optional)conversations:read

Connect your client

Paste the server address and the key into your client. In Claude Code it’s a single command:

claude mcp add --transport http bydomu https://mcp.bydomu.com/mcp \
  --header "Authorization: Bearer domu_sk_live_XXXXXXXX"

Claude Desktop uses mcp-remote; Cursor and VS Code take the URL and the header in their config. In claude.ai or ChatGPT, add a connector with the server address and sign in with your ByDomu account.

Test the connection

Ask your assistant for a summary. It should use the get_summary tool and answer with the plan, the key’s permissions and your account’s counts.

Or test it without an assistant, with cURL:

cURL

curl -s https://mcp.bydomu.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Authorization: Bearer domu_sk_live_XXXXXXXX' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_summary","arguments":{}}}'

If something fails

The tool returns the API error in plain words:

401The key is missing or invalid. Check the header says “Bearer” followed by the full key.
403You used a publishable key (domu_pk_) or the key lacks that tool’s permission.
429You went over the per-minute limit. The error says how many seconds to wait.