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.

Last reviewed: September 5, 2026

Model Context Protocol (MCP)

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

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: /openapi.json.

Errors, rate limits & versioning

API errors use RFC 9457 problem details (application/problem+json) with a machine-readable type, a 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: what Karpa runs, published pricing, key facts, canonical FAQs, and instructions on how to call the MCP/REST tools
  • /pricing.md Canonical, AI-only pricing source (plan types + platform tiers)
  • /developers.md Developer & agent access reference
  • /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

Discovery & well-known

  • GET /.well-known/mcp.json MCP server manifest (registry server.json format)
  • GET /openapi.json OpenAPI 3.0 contract for the REST endpoints
  • GET /.well-known/api-catalog RFC 9727 API catalog (application/linkset+json)
  • GET /.well-known/acp.json Agentic Commerce Protocol manifest
  • GET /.well-known/agent-card.json A2A Agent Card

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:

Compliance & accuracy

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 /offers.

A plain-markdown mirror of this page is available at /agents.md.