# Ask your AI what the bird found.

Dr. Canary connects to ChatGPT, Claude, Codex and Claude Code.

Your assistant can read your reports and checks, change a saved shopper, and request a check. It uses your account’s permissions. A current superadmin can separately grant CRM outreach tools to a connection. Your assistant’s app controls approvals.

## Three jobs, 19 customer tools.

Your assistant uses the same customer services as the portal for reads, shopper changes, and checks.

## Read what the bird found

Your sites and Groups, saved shoppers and recorded checks, site tools and journeys, inquiry details, and published reports with their evidence.

- `list_sites`
- `list_assignments`
- `list_assignment_runs`
- `list_runs`
- `get_run`
- `list_groups`
- `get_group`
- `list_site_tools`
- `list_journeys`
- `get_journey_assessment`
- `list_reports`
- `get_report`
- `get_inquiry`

## Change a saved shopper

Create a shopper on one of your site’s defaults or edit one, set its calendar, pause it, or retire it. Saved settings include its name, frequency and areas of focus, and a dealer shopper’s departments and inquiry choice. Saving never starts a check.

- `save_assignment`
- `set_assignment_calendar`
- `retire_assignment`

## Request a check

Request a site or authorized Group check. The basic site check uses the first saved shopper that has not been retired, including one that is paused. A finding recheck requests the ordinary site check. Checks may send permitted test inquiries and use your allowance.

- `request_recheck`
- `request_group_recheck`
- `request_finding_recheck`

## Optional CRM outreach tools

A current superadmin can separately opt in to 12 CRM outreach tools on a connection. This is distinct from the staff grant for catalogue access and public checks. The consent checkbox is off by default; these tools can import CRM records and approve and send real campaign emails.

- [Permissions](https://www.drcanary.com/mcp/permissions/)
- [Tool reference](https://www.drcanary.com/mcp/tools/#crm-outreach)

## Connect your account

Pick your assistant. Each path ends at the Dr. Canary sign-in, where you see what the connection can read and change before you approve it. Then ask your assistant to list your Dr. Canary sites.

- · Server URL: `https://www.drcanary.com/api/mcp/`
- · Scope: mcp
- · Transport: Streamable HTTP
- · Sign-in: OAuth 2.1 with PKCE, your Dr. Canary account

## ChatGPT

Plugins, on chatgpt.com

1. Open Plugins, press +, and choose Add custom MCP server.

2. Paste the server URL and choose OAuth for authentication.

   ```
   https://www.drcanary.com/api/mcp/
   ```

3. Choose Create as a plugin, install it, then press Connect and sign in to Dr. Canary.

## Claude

Customize › Connectors, on claude.ai

1. Open Customize › Connectors and choose Add custom connector.

2. Choose Web, name the connector Dr. Canary, and paste the server URL.

   ```
   https://www.drcanary.com/api/mcp/
   ```

3. Select Sign in now and Use Claude’s published identity. Add the connector, then sign in to Dr. Canary and approve the connection.

## Codex

Settings › MCP servers, or the terminal

1. Add the server from the terminal.

   ```
   codex mcp add dr-canary --url https://www.drcanary.com/api/mcp/
   ```

2. Finish sign-in in your browser. To open sign-in again, run this command.

   ```
   codex mcp login dr-canary
   ```

3. In the Codex app, Settings › MCP servers › Add server takes the same URL as Streamable HTTP, then Authenticate.

## Claude Code

In your terminal

1. Add Dr. Canary as an HTTP server.

   ```
   claude mcp add --transport http --scope user dr-canary https://www.drcanary.com/api/mcp/
   ```

2. In Claude Code, run /mcp, select dr-canary, and authenticate. Finish sign-in in the browser on the same device.

## What it does not do

- Your account’s permissions apply. What you cannot do in the portal, your assistant cannot do either.
- Your assistant follows its app’s approval controls for changes and checks.
- It reads what the report shows. Hidden prompts, internal notes, and other accounts stay out.

## Ask your assistant

- “What did the last check find at my store?” Uses `list_sites`, `list_assignments`, `list_assignment_runs`, `list_runs`, `get_run`, `list_groups`, `get_group`, `list_site_tools`, `list_journeys`, `get_journey_assessment`, `list_reports`, `get_report`, `get_inquiry`.
- “Pause the service shopper.” Uses `save_assignment`, `set_assignment_calendar`, `retire_assignment`.
- “Recheck the site and follow this check to its report.” Uses `request_recheck`, `request_group_recheck`, `request_finding_recheck`.

More examples: https://www.drcanary.com/mcp/examples/

## Related

- [Examples](https://www.drcanary.com/mcp/examples/) · [markdown](https://www.drcanary.com/mcp/examples.md)
- [Tools](https://www.drcanary.com/mcp/tools/) · [markdown](https://www.drcanary.com/mcp/tools.md)
- [Permissions](https://www.drcanary.com/mcp/permissions/) · [markdown](https://www.drcanary.com/mcp/permissions.md)
- [Troubleshooting](https://www.drcanary.com/mcp/troubleshooting/) · [markdown](https://www.drcanary.com/mcp/troubleshooting.md)
- [ChatGPT](https://www.drcanary.com/mcp/chatgpt/) · [markdown](https://www.drcanary.com/mcp/chatgpt.md)
- [Claude](https://www.drcanary.com/mcp/claude/) · [markdown](https://www.drcanary.com/mcp/claude.md)
- [Codex](https://www.drcanary.com/mcp/codex/) · [markdown](https://www.drcanary.com/mcp/codex.md)
- [Claude Code](https://www.drcanary.com/mcp/claude-code/) · [markdown](https://www.drcanary.com/mcp/claude-code.md)

https://www.drcanary.com/mcp/ · updated 2026-11-12
