> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.taigabilling.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.taigabilling.com/_mcp/server.

# Connect AI assistants (MCP)

Taiga runs a remote [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server. Add it to your AI assistant and sign in with your Taiga account; the assistant can then read your practice's billing data. The connection is read-only.

```
https://api.taigabilling.com/mcp
```

> **Use a workspace covered by your BAA.**
>
> The assistant reads patient information. Connect only from an AI workspace your practice has a business associate agreement with.

## Connect

### Claude

Available on every Claude plan. Free accounts can add one custom connector.

1. On claude.ai or the Claude desktop app, open **Customize > Connectors**.
2. Select **+ Add**, then **Add custom connector**. Enter a name, such as Taiga, paste the server URL, and select **Continue**.
3. Keep the default sign-in options (**Use Claude's published identity**), select **Add**, then sign in with your Taiga account and approve access.

On a Team or Enterprise plan, an owner adds the connector under **Organization settings > Connectors**. Members then select **Connect** under **Customize > Connectors**.

### ChatGPT

Available on ChatGPT Pro, Business, and Enterprise. On Business and Enterprise, workspace admins control who can add custom MCP servers.

1. On chatgpt.com, open **Plugins** and select **+**.
2. Select **Add custom MCP server**. Enter a name, such as Taiga, paste the server URL, and choose **OAuth**.
3. Confirm the risk warning and select **Create as a plugin**. Install the plugin, sign in with your Taiga account, and approve access. In a chat, type **@** and pick Taiga.

### Other assistants

Add a remote MCP server (Streamable HTTP) with the server URL. It signs in with OAuth. The client registers itself, so you don't need a client ID.

Add the connector from a computer or a mobile web browser. Once added, it also works in the assistant's mobile app.

## Access

* Your Taiga account must belong to exactly one practice.
* The assistant sees only what your account can see in the Taiga dashboard. Accounts without financial access can't read analytics.
* To give an assistant write access, such as creating patients and submitting visits, contact Taiga.

## Tools

| Tool                                                         | Purpose                                                     |
| ------------------------------------------------------------ | ----------------------------------------------------------- |
| `search_patients`, `get_patient`                             | Find patients; read demographics and insurance              |
| `list_providers`, `list_service_facilities`, `search_payers` | Look up providers, facilities, and payers                   |
| `search_encounters`, `get_encounter`                         | Find visits and read claim status                           |
| `get_analytics`                                              | Practice analytics reports (below)                          |
| `search_remits`                                              | Find payer payments by date, check number, payer, or amount |

Money amounts are integer cents.

| Report       | What it shows                                                                                 | Default window               | Date range filters by |
| ------------ | --------------------------------------------------------------------------------------------- | ---------------------------- | --------------------- |
| `overview`   | Top-line KPIs, A/R aging, and charges, claims, and first-pass rate over time                  | Last 12 months               | Date of service       |
| `ar-aging`   | Outstanding insurance A/R by age bucket and days in A/R                                       | All open A/R                 | Date of service       |
| `fprr`       | First-pass resolution rate: share of claims resolved on first submission                      | Last 3 months of submissions | Date first submitted  |
| `ncr`        | Net collection rate: collected versus expected allowed amounts                                | Last 3 months                | Date of service       |
| `denials`    | Denied and rejected claim counts, top denial reason codes, and denials by payer and procedure | All time                     | Date of service       |
| `payers`     | Billed, paid, and outstanding amounts by payer                                                | All time                     | Date of service       |
| `procedures` | Line counts, units, and payments by procedure code                                            | All time                     | Date of service       |
| `charges`    | Charge line counts by status and top procedure codes                                          | All time                     | Date of service       |
| `scorecard`  | Days in A/R, first-pass rate, net collection rate, charge lag, and write-off ratio            | None                         | No date range         |
| `freshness`  | When analytics data was last refreshed                                                        | None                         | No date range         |