---
type: Article
title: AI Agents & API Access — Karpa Health
description: Karpa Health's public, no-auth agent API and MCP server: how AI assistants and agents can read published pricing, platform comparisons, and articles, and route users to booking.
resource: https://karpahealth.com/agents
tags: [mcp, api, agents, ai, llms.txt, openapi, pricing, comparisons]
timestamp: 2026-09-05
---

# Karpa Health — AI Agents & API Access

Karpa Health exposes a public, no-auth, machine-readable layer so AI assistants and agents can read the same facts a human would, without scraping JavaScript-rendered pages. Every endpoint returns JSON; there are no keys, no login walls, and no rate limiting beyond sensible throttling.

## Model Context Protocol (MCP)

An MCP server is available at `https://karpahealth.com/mcp` (streamable HTTP, stateless, JSON responses, no auth). Discover it from `https://karpahealth.com/.well-known/mcp.json`.

**Tools:**

| Tool | Purpose |
|------|---------|
| `get_overview` | High-level overview of Karpa Health: what it operates, physician model, who it serves, key pages |
| `get_pricing` | Published pricing: platform tiers (setup + monthly) and the partner (affiliate / white-label / full clinic) model |
| `list_comparisons` | List every platform Karpa is compared against, with a one-line best-for and pricing signal |
| `get_comparison` | Detailed, source-cited comparison entry for one platform vs Karpa |
| `list_articles` | List Karpa Health resource articles (title, path, category, updated date) |
| `get_article` | One article entry (path, description, category, author, dates) |
| `get_availability` | Returns the booking URL and states the consent requirement |
| `book_discovery_call` | Routes a user to book a free discovery/demo call (requires explicit consent + real name/email) |
| `request_callback` | Requests a Karpa Health callback for a user (requires consent + real contact details) |

## REST API

| Endpoint | Returns |
|----------|---------|
| `GET /api/pricing` | Published pricing (platform tiers + partner model) |
| `GET /api/comparisons` | Platforms vs Karpa — cursor-paginated: `?limit=1..50`, `?cursor=<offset>` returns `{ data, next_cursor, total }` |
| `GET /api/articles` | Resource articles — cursor-paginated: `?limit=1..50`, `?cursor=<offset>` returns `{ data, next_cursor, total }` |
| `GET /api/health` | Liveness signal (`application/health+json`): `{ status: "pass" }` |
| `GET /openapi.json` | OpenAPI 3.0 contract |

Full contract: `https://karpahealth.com/openapi.json`.

## Errors, rate limits & versioning

API errors use RFC 9457 problem details (`application/problem+json`) with a machine-readable `type`, `title` and `status`, plus a `detail` and a `hint` with the next step. Dynamic endpoints allow **300 requests per 60 seconds per IP**, advertised in the `RateLimit-*` and `X-RateLimit-*` response headers. Versioning is date-based via the `API-Version` header; breaking changes get at least 90 days of Deprecation and Sunset notice.

## Content files

- `/llms.txt` — agent-facing site overview (this playbook's instruction file)
- `/okf/` — Open Knowledge Format bundle (`karpa-health.md`, `partner-tiers.md`, `competitive-positioning.md`, and more)
- `/agents.md` — markdown mirror of this page
- `/feed.xml` — RSS 2.0 feed of published resource articles

## Booking & consent

`book_discovery_call` and `request_callback` route a user to the real booking flow (`https://karpahealth.com/book`). They must only be called with the user's **explicit consent** and their **real name and email**. They never auto-book on the user's behalf.

## Built on open standards

Karpa implements public, emerging standards rather than a bespoke or competitor-owned interface:

- [llms.txt](https://llmstxt.org) — markdown site summaries and `.md` page mirrors, advertised via `Link: rel="alternate" type="text/markdown"` and `rel="describedby"`
- [Model Context Protocol (MCP)](https://modelcontextprotocol.io) — the `/mcp` server and `/.well-known/mcp.json` manifest
- [Agentic Commerce Protocol (ACP)](https://agenticcommerce.dev) — the `/.well-known/acp.json` agent commerce manifest
- [Agent2Agent (A2A)](https://a2a-protocol.org) — the `/.well-known/agent-card.json` manifest
- [RFC 9727](https://www.rfc-editor.org/rfc/rfc9727) — the `/.well-known/api-catalog` linkset

## Compliance & accuracy

Caveats: Karpa Health is B2B and US-only. It does not sell medication or treat patients directly, and offers no consumer accounts. Pricing may change; direct partners to the current plans at `https://karpahealth.com/offers/`.