[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Blueprint API and MCP server: Let your AI agent finish the notes and the claims.

> Blueprint documents a Partner Platform API at developer.blueprint.ai. It lets a partner organization, typically an EHR, create clinicians and clients and get session documentation back, with a clientId, clientSecret and apiKey that Blueprint provisions. No Blueprint MCP server and no official ChatGPT or Claude connector was found.

Blueprint's API is a Partner Platform for EHRs and other partner apps, and no Blueprint MCP server was found (checked 19 Nov 2026). Cotlet runs a hosted Blueprint MCP server with 22 tools that ChatGPT and Claude use in your own clinician account. Signing a note, submitting a claim and anything a client receives wait for your OK.

- Free 7-day trial, no card
- Unofficial, not affiliated with Blueprint
- Page: https://cotlet.dev/integrations/blueprint-api-mcp-server

> Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by Blueprint. Blueprint is a trademark of its owner. If Blueprint's own integrations cover what you need, use them first.

## What can your AI agent do in Blueprint?

- Turn your session notes into a progress note
- Sign and lock the notes you approved
- Draft a treatment plan and assign a measure
- Book recurring client appointments
- Submit and resubmit insurance claims
- Post payments, superbills and sliding-scale rates

## Does Blueprint have an MCP server or an API?

- Partner credentials come from your Blueprint representative, one set for sandbox and one for production.
- The Partner API reference covers organizations, clinicians, clients, sessions, progress notes and assessments. It lists no endpoints for appointments, insurance claims, payments or superbills.
- The Enterprise plan lists custom EHR integrations and API access; Alongside your EHR and All-in-one EHR are the self-serve plans.
- Blueprint's own AI assistant works inside Blueprint, not from ChatGPT or Claude.

| What you need | Partner Platform API | By hand | Cotlet |
|---|---|---|---|
| Ask ChatGPT or Claude to do the work | No MCP server found | Copy and paste | Hosted MCP server |
| Work in your own clinician account | Built for partner apps | Your login | Your login, once |
| Calendar, claims, payments and superbills | No endpoints listed | One screen at a time | 22 tools, writes after your OK |
| Run from n8n or a script | Partner credentials, your own code | Manual only | REST, same key |

Checked 19 Nov 2026. Sources: [Blueprint developer docs: Getting started](https://developer.blueprint.ai/docs/getting-started), [Blueprint Partner API reference index](https://developer.blueprint.ai/llms.txt), [Blueprint pricing](https://www.blueprint.ai/pricing), [Blueprint Help Center](https://help.blueprint.ai/en/), [Help: How to access your Progress Notes](https://help.blueprint.ai/en/articles/9676468-how-to-access-your-progress-notes), [Help: Review Other Clinician's Notes as a Supervisor](https://help.blueprint.ai/en/articles/10007092-review-other-clinician-s-notes-as-a-supervisor), [Help: Progress note templates](https://help.blueprint.ai/en/articles/9900046-progress-note-templates), [Help: Write Session Summary](https://help.blueprint.ai/en/articles/14827993-write-session-summary-generate-a-full-progress-note-from-a-written-session-summary-or-transcript), [Help: How to document a Couple's session](https://help.blueprint.ai/en/articles/18491521-how-to-document-a-couple-s-session), [Help: How to document a Family session](https://help.blueprint.ai/en/articles/18491502-how-to-document-a-family-session), [Help: Update session details after a Progress Note](https://help.blueprint.ai/en/articles/10128232-how-to-update-session-details-after-a-progress-note-has-been-created), [Help: Update session attendees, type and identified patient](https://help.blueprint.ai/en/articles/18491859-how-to-update-session-details-session-attendees-session-type-note-type-identified-patient), [Help: Magic Edit and Memory](https://help.blueprint.ai/en/articles/10986563-using-magic-edit-and-memory-to-fine-tune-your-progress-notes), [Help: Revert to a previous version of a Progress Note](https://help.blueprint.ai/en/articles/10128357-revert-back-to-a-previous-version-of-an-existing-progress-note), [Help: How to sign and lock a Progress Note](https://help.blueprint.ai/en/articles/13595748-how-to-sign-and-lock-a-progress-note), [Help: How to create and use Snippets](https://help.blueprint.ai/en/articles/14290068-how-to-create-and-use-snippets), [Help: How to create a Treatment Plan](https://help.blueprint.ai/en/articles/11408737-how-to-create-a-treatment-plan), [Help: Delete notes, transcripts, sessions and treatment plans](https://help.blueprint.ai/en/articles/10068320-how-to-delete-notes-transcripts-sessions-and-treatment-plans), [Help: Enable or disable Transcripts](https://help.blueprint.ai/en/articles/9170989-how-to-enable-or-disable-transcripts), [Help: Assigning Assessments and Worksheets](https://help.blueprint.ai/en/articles/9953130-assigning-assessments-and-worksheets-to-clients), [Help: Unassigning Assessments and Worksheets](https://help.blueprint.ai/en/articles/9953842-unassigning-assessments-and-worksheets-from-a-client), [Help: How to create a client appointment](https://help.blueprint.ai/en/articles/13595623-how-to-create-a-client-appointment), [Help: How to add an external calendar](https://help.blueprint.ai/en/articles/13595493-how-to-add-an-external-calendar), [Help: Transfer a client to a different clinician](https://help.blueprint.ai/en/articles/14478492-how-to-transfer-a-client-to-a-different-clinician), [Help: How to merge duplicate client profiles](https://help.blueprint.ai/en/articles/15423551-how-to-merge-duplicate-client-profiles), [Help: How to add client insurance information](https://help.blueprint.ai/en/articles/13596176-how-to-add-client-insurance-information), [Help: How to create and submit insurance claims](https://help.blueprint.ai/en/articles/14174710-how-to-create-and-submit-insurance-claims), [Help: How to resubmit insurance claims](https://help.blueprint.ai/en/articles/14625051-how-to-resubmit-insurance-claims), [Help: Secondary insurance and secondary claims](https://help.blueprint.ai/en/articles/15326736-how-to-manage-secondary-insurance-and-submit-secondary-claims), [Help: How to add external insurance payments](https://help.blueprint.ai/en/articles/14303450-how-to-add-external-insurance-payments), [Help: How to create and manage Superbills](https://help.blueprint.ai/en/articles/13596461-how-to-create-and-manage-superbills), [Help: How to create services and set default fees](https://help.blueprint.ai/en/articles/13596499-how-to-create-services-and-set-default-fees), [Help: How to set a sliding scale rate](https://help.blueprint.ai/en/articles/14082269-how-to-set-a-sliding-scale-rate)

## How does the Blueprint MCP server work?

1. **Log in to Blueprint.** Once, in a browser we host for you.
2. **Connect your AI agent.** One address in its settings.
3. **Hand it the notes.** Paste your session summary, then read the note before it is signed.

Your agent works in your own signed-in Cloud Browser. Signing, claims and anything a client receives wait for your OK.

## How to connect Blueprint to your AI agent

1. **Sign in to Blueprint in a Cloud Browser.** Open clinician.blueprint.ai in your Cotlet Cloud Browser and log in with your own clinician account.
2. **Add the Cotlet address.** Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.
3. **Let the agent in.** Chat apps open a Cotlet sign-in page. Editors, n8n and scripts send an API key made in the console.

Blueprint shares `https://cotlet.dev/mcp/v1` with every other app you turn on, so the connector you add once also reaches your calendar or accounting apps. Turned Blueprint on later? Refresh the connector and the 22 Blueprint tools show up.

ChatGPT:

```
Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth
```

Claude:

```
Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"
```

Cursor:

```
// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}
```

Codex:

```
# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
```

n8n:

```
MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: blueprint_read
```

## All 22 Blueprint MCP tools

One tool per clinician workflow in the Blueprint Help Center. Tools with an `action` read with `list` and `get`; every other action writes and asks first.

### Progress notes

Read notes, write one from your summary or a pasted transcript, refine it, go back a version and sign it. Live recording, dictation and telehealth stay with you in Blueprint.

- **Read progress notes** (`list_progress_notes`, read): List a client's sessions and read the progress note of one of them.
- **List progress note templates** (`list_note_templates`, read): List the progress note types your Blueprint clinic can use.
- **Write a progress note from a session summary** (`write_session_summary`, write, asks first): Start a session with the Write session summary method and generate its progress note.
- **Update session details** (`update_session_details`, write, asks first): Change a session's note type, session type, approach, setting, times, attendees or identified patient.
- **Edit a progress note with Magic Edit** (`magic_edit_note`, write, asks first): Give Blueprint an instruction to regenerate a note, and optionally save it to Memory.
- **Revert a progress note version** (`revert_note_version`, write, asks first): List a note's versions or switch it back to an earlier one.
- **Sign and lock a progress note** (`sign_and_lock_note`, write, asks first): Sign and lock a finished progress note.
- **Manage note snippets** (`manage_snippets`, write, asks first): List, create, edit or delete the snippets you insert in notes with "/".

### Treatment plans, measures and records

Plans from the last three transcripts or an uploaded PDF, assessments and worksheets on a schedule, and the permanent deletes Blueprint offers.

- **Create a treatment plan** (`create_treatment_plan`, write, asks first): Generate a treatment plan from a diagnosis and focus, or upload an existing PDF plan.
- **Assign assessments and worksheets** (`assign_assessments_worksheets`, write, asks first): List, assign or unassign a client's assessments and worksheets.
- **Delete notes, transcripts, sessions or treatment plans** (`delete_session_items`, write, asks first): Permanently delete a transcript, a note, a whole session or a treatment plan.
- **Turn session transcripts on or off** (`set_session_transcripts`, write, asks first): Turn the clinic's Session Transcripts setting on or off.

### Calendar and clients

Appointments with or without the client notification, an outside calendar beside them, transfers and merges of client profiles.

- **Create a client appointment** (`create_appointment`, write, asks first): Read your Blueprint calendar or create an appointment for a client.
- **Add an external calendar** (`add_external_calendar`, write, asks first): Show an external calendar, such as Google Calendar, on your Blueprint calendar.
- **Transfer a client to another clinician** (`transfer_client`, write, asks first): Move a client to another clinician, or add or remove assigned clinicians.
- **Merge duplicate client profiles** (`merge_client_profiles`, write, asks first): Merge a duplicate client profile into the one you keep.

### Insurance and billing

Coverage on the client profile, claims from draft to resubmission, payments received outside Blueprint, superbills and your fees.

- **Add client insurance** (`add_client_insurance`, write, asks first): Add a client's primary or secondary insurance to their profile.
- **Submit and resubmit insurance claims** (`manage_insurance_claims`, write, asks first): List claims that need action, then submit, resubmit, mark denied or close one, or submit a secondary claim.
- **Post an external insurance payment** (`add_insurance_payment`, write, asks first): Enter an insurance payment received outside Blueprint and post it to claims.
- **Create superbills** (`manage_superbills`, write, asks first): Create a superbill for a date of service, or turn monthly superbills on or off for a client.
- **Set services and default fees** (`manage_services_fees`, write, asks first): List your services, or create or edit one with its CPT code, description and rate.
- **Set a sliding-scale rate** (`set_sliding_scale_rate`, write, asks first): Change a service's amount on one client's invoice so it becomes their rate.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/blueprint-api-mcp-server#tools

## Who can see my Blueprint session, and how do I revoke it?

- **What we store.** Your signed-in Blueprint browser profile, AES-256-GCM encrypted, in Finland. Never your password.
- **What your agent gets.** The 22 Blueprint tools. The session cookie stays in the Cloud Browser.
- **What the session sees.** The clients your role opens: your own as a clinician, your supervisees' as a supervisor, every profile as an admin.
- **What no tool touches.** Your Blueprint users and roles, your subscription, live telehealth and session recording.
- **If Blueprint logs you out.** You log in again yourself, in the same Cloud Browser.
- **How to cut access.** Disable Blueprint for agents, reset the browser, or change your Blueprint password.

Cotlet never sees or stores your password: you type it yourself, and the agent only uses the session that login leaves behind. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory ([live results](https://cotlet.dev/security.md)).

## Approvals, undo and mistakes

1. **Take your summary.** Your words, at least 30 of them.
2. **Generate the note.** write_session_summary picks the note type.
3. **Show you the note.** list_progress_notes reads it back.
4. **Sign after your OK.** sign_and_lock_note locks it, then the claim can go.

| Action | How to put it right |
|---|---|
| Regenerated note | Switch back with revert_note_version |
| Locked note | Unlock it in Blueprint, then edit |
| Appointment or fee | Call the tool again with the earlier values |
| Submitted claim | Already with the payer: resubmit a corrected claim |
| Delete or merge | Permanent in Blueprint, so it always waits for your OK |

All 20 write tools ask first: by default you confirm each call, and you can switch that off per tool. The 2 read tools, notes and note templates, run at once.

MCP call:

```
{
  "name": "write_session_summary",
  "arguments": {
    "client": "Jordan Example",
    "summary": "Client reported fewer panic episodes this week, two instead of five. Practiced paced breathing daily. Discussed work stress and avoidance of team meetings. Introduced a thought record for meeting worries. Client agreed to attend one meeting and log thoughts before next session.",
    "session_type": "individual",
    "note_type": "SOAP"
  }
}
```

REST:

```
curl -X POST https://cotlet.dev/api/v1/blueprint/session-summary/write \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"client":"Jordan Example","summary":"Client reported fewer panic episodes this week, two instead of five. Practiced paced breathing daily. Discussed work stress and avoidance of team meetings. Introduced a thought record for meeting worries. Client agreed to attend one meeting and log thoughts before next session.","session_type":"individual","note_type":"SOAP"}'
```

Response:

```
{
  "client": "Jordan Example",
  "session_date": "2026-11-17",
  "session_type": "individual",
  "note_type": "SOAP",
  "note_generated": true,
  "locked": false
}
```

The note comes back unsigned, so you read it before sign_and_lock_note runs. A script or n8n flow can make the same call over REST at `/api/v1/blueprint` with the same key and price, in JSON. Failed calls are free.

## How much does the Blueprint MCP server cost?

**About $28 a month** for a therapist with 20 sessions a week, 4,820 credits. Your Blueprint plan stays as it is.

| Job | Calls | Credits |
|---|---|---|
| Progress note from your session summary | 1 × 80 | 800 |
| Read the note back, then sign and lock it | 2 × 80 | 1,600 |
| Weekly list of claims that need action | 1 × 4 | 40 |
| Claim submissions | 1 × 60 | 600 |
| Appointments booked for new or moved clients | 1 × 12 | 120 |
| Insurance payments and resubmissions | 1 × 10 | 100 |
| Treatment plan and measures for a new client | 2 × 3 | 60 |
| Cloud Browser, 30 days |  | 1,500 |
| Total | 332 calls | 4,820 |

The smallest pack, 5,000 credits for $29, covers this month. A group practice with more clinicians uses more calls.

- Free 7-day trial, no card
- 10 credits per successful call, MCP or REST
- 50 credits a day for the Cloud Browser
- Your Blueprint plan and session credits apply as they are

Credit packs are one-time purchases, not a subscription. The month above is built from our own assumptions, not measured customer usage. Blueprint counts one session credit per session however often the note is regenerated.

## Blueprint MCP server: other ways to connect

| Option | What it does | Where it stops |
|---|---|---|
| Blueprint Partner Platform | API and embeddable UI that put Blueprint documentation inside a partner EHR. | Credentials provisioned per partner organization; built for software vendors, not one practice. |
| Blueprint Enterprise | Custom plans with custom EHR integrations and API access. | Annual contracts, arranged on a call with Blueprint. |
| Blueprint's AI assistant | Notes, plans and support inside Blueprint. | Works in Blueprint, not from ChatGPT, Claude or your scripts. |
| By hand | Open each client and session in Blueprint. | One screen at a time, after the last session of the day. |

If you build an EHR or run an enterprise practice with Blueprint API access, use it: it is the vendor's own route. Cotlet fits a practice that wants ChatGPT, Claude or a script working in its own Blueprint account today, with nothing to host.

## Who runs Cotlet

Take Group sp. z o.o. runs Cotlet, a software company registered in Poland, EU (VAT PL6342984273) and working since 2019. Its founders are Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the Blueprint tools go to contact@cotlet.dev.

## Blueprint MCP server: questions

### How do I get access?

Sign up free at https://cotlet.dev/signup?app=blueprint, turn on Blueprint under Integrations in the console and log in at https://clinician.blueprint.ai/login in your Cloud Browser. Then connect your AI agent and hand it your first session summary. The trial needs no card.

### Does Blueprint have an API?

Blueprint documents a Partner Platform API at developer.blueprint.ai for partner organizations, typically EHRs, with credentials Blueprint provisions; its Enterprise plan lists custom EHR integrations and API access (checked 19 Nov 2026). No Blueprint MCP server and no official ChatGPT or Claude connector was found. Cotlet does not use that API: it works in your own signed-in Blueprint account.

### How is this different from Blueprint's own AI assistant?

Blueprint's assistant works inside Blueprint: it writes notes and drafts plans there. Cotlet lets ChatGPT, Claude or a script you choose work in your Blueprint account with the same tools over MCP or REST, next to your other apps.

### Which Blueprint plan do the tools need?

The tools use what your plan shows you. Blueprint lists Alongside your EHR at $69 per seat and All-in-one EHR at $1.49 per session on its pricing page (19 Nov 2026); scheduling, insurance billing and invoices are listed in All-in-one. Assigning assessments and worksheets is documented for the Plus plan.

### Can the agent record or run a telehealth session?

No. Recording, dictation and Blueprint telehealth need your microphone and camera, so they stay with you. The agent writes the note from a summary or transcript you give it, and handles the scheduling and billing around the session.

### Which Blueprint login should I use?

Your own clinician login. The agent sees what your role sees: a clinician their own clients, a supervisor their supervisees' clients, an admin every profile. Clinic settings such as session transcripts need the Admin role.

### Is the MCP server different from the REST API?

Only in how it is called. Both carry the same 22 tools, inputs, answers, API key and price. Agents use MCP; scripts and n8n HTTP steps use REST.

### Is Cotlet affiliated with Blueprint?

No. Cotlet is independent and not affiliated with Blueprint.

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.
