# Connect an AI assistant

Source: https://priorauth.getgenko.com/docs/connect-an-ai-assistant · Updated 2026-10-18

> Built, not yet enabled
>
> The connector is built and tested but not switched on yet, so no assistant can connect today. This page describes how it will work. There is no date; the [agents page](https://priorauth.getgenko.com/agents#connector) will say when it is enabled.

On the Practice plan you can connect an AI assistant to Genkō Prior Auth so it can answer questions like “which requests are waiting on the payer?” or “what does the payer still expect for this one?”. The connection is read-only, uses your own sign-in, and never sends patient details to the assistant.

## What the assistant can and cannot see

One permission exists: **Read request status, ids and dates; no patient names or notes.** In detail, the assistant can:

| Tool | What it returns |
| --- | --- |
| `list_requests` | Your practice's requests, newest first: id, status, urgency, payer, planned service date and timestamps. |
| `get_request_status` | One request's status, the next steps a person can take in the app, its event timeline (types and dates) and packet versions. |
| `get_missing_items` | The "payer may expect, but not provided" list of the newest packet, with identifiers removed. |
| `get_allowance` | Plan, billing status, limits and this month's usage. Owners and admins only. |
| `get_app_link` | A link into the app for anything that needs a person: review, lock, submit, record a decision, appeal. |

It never receives patient names, dates of birth, member ids, clinical notes, the service description, codes, denial wording or packet text. Text that people typed (a payer your practice added, a missing-documentation item) is de-identified and labeled as user text.

It cannot change anything: no drafting, locking, submitting, recording outcomes, billing, or inviting. Those stay with a person in the app.

## Connect

1. In your assistant, add a custom connector (Claude: **Settings → Connectors → Add custom connector**; ChatGPT: add a connector in its apps/connectors settings) with this URL: `https://priorauth.getgenko.com/mcp/practice`
2. The assistant opens Genkō Prior Auth. Sign in if asked.
3. On **Connect …?**, check the app name and where it returns to, choose the practice it may read, and select **Approve**.

Each connection is for one practice. Connecting the same assistant again for another practice replaces the first connection.

> Which assistants work
>
> Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT, and MCP clients running on your own computer (they return to `localhost`). Other apps are shown as unverified and can't be connected; contact us if you need one.

## Plan and roles

The connector is part of the Practice plan (see [pricing](https://priorauth.getgenko.com/pricing)). Any member can connect; `get_allowance` is for owners and admins only.

#### When the assistant says it can't read the practice

- **Not on the Practice plan** (including the free trial): an owner or admin can change the plan under **Settings → Billing**.
- **Trial ended or subscription inactive:** the same; the connection works again once billing is active.
- **You left the practice:** the connection is removed automatically.

Calls are limited to 60 per 60 seconds per person and assistant. Every tool call is counted and written to your practice's audit trail with the tool name and outcome, never with what was asked or returned.

## Disconnect

Open the account menu (your initials, top right) and choose **Connected assistants**, then **Disconnect**. The assistant's next call is refused. Owners and admins also see which assistants their team has connected. Removing the connector in the assistant itself does not revoke access on our side; disconnect here too.