Kaiser Permanente MCP server for AI agents
Let Claude, ChatGPT or your own agent read Kaiser Permanente: 4 typed functions through one MCP server. No Kaiser Permanente API key needed.
- Functions
- 4
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Kaiser Permanente alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/kaiser_permanenteOne MCP server for Kaiser Permanente and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
getServiceAreaSays whether a ZIP is inside a Kaiser Permanente plan service area, using the 2026 individual and family plan-shopping dataset, with county, state…Arguments
Name Type Required zipstringYes Returns
KaiserServiceAreaResultinterface KaiserServiceAreaRow { zip: string; county: string; state: string; region: string; lob: string; } interface KaiserServiceAreaResult { zip: string; inServiceArea: boolean; areas: KaiserServiceAreaRow[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/kaiser_permanente/getServiceAreaCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.kaiser_permanente.getServiceArea({ zip: "94612" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.kaiser_permanente.getServiceArea({"zip": "94612"}))curl -X POST https://api.bowmark.ai/v1/sites/kaiser_permanente/getServiceArea \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"zip":"94612"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.kaiser_permanente.getServiceArea({ zip: "94612" });listSearchSuggestionsReads the plan-shopping page's own ZIP / county / state suggestion dataset, filtered by a ZIP prefix or a county or state name.Arguments
Name Type Required querystringPrefix of a ZIP, or part of a county or state name; omit for the whole dataset.No limitnumberDefault 25, max 10000.No Returns
KaiserSearchSuggestion[]interface KaiserSearchSuggestion { zip: string; county: string; state: string; subregion: string; coverage: string; lob: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/kaiser_permanente/listSearchSuggestionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.kaiser_permanente.listSearchSuggestions({ query: "946" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.kaiser_permanente.listSearchSuggestions({"query": "946"}))curl -X POST https://api.bowmark.ai/v1/sites/kaiser_permanente/listSearchSuggestions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"946"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.kaiser_permanente.listSearchSuggestions({ query: "946" });searchFacilitiesByZipRuns Kaiser Permanente's own find-a-facility search for a US ZIP and returns hospitals, medical offices and affiliated facilities nearest first, with…Arguments
Name Type Required argsSearchFacilitiesByZipArgsYes type KaiserFacilityRegion = "NCA" | "SCA" | "COL" | "GGA" | "HAW" | "MID" | "KNW" | "WA"; // `zipCode` is the same field as `zip`: the runtime reads either, so the type admits either. // region: Kaiser's directory region, inferred from the ZIP when omitted. radiusMiles: default 25 // (the site's own default radius). limit: default 20, max 200. type SearchFacilitiesByZipArgs = | { zip: string; region?: KaiserFacilityRegion; radiusMiles?: number; limit?: number } | { zipCode: string; region?: KaiserFacilityRegion; radiusMiles?: number; limit?: number };Returns
KaiserFacilitySearchResulttype KaiserFacilityRegion = "NCA" | "SCA" | "COL" | "GGA" | "HAW" | "MID" | "KNW" | "WA"; interface KaiserFacility { id: string; name: string; facilityType: string; isKaiser: boolean; address: { street: string; city: string; state: string; zip: string }; distanceMiles: number | null; lat: number | null; lng: number | null; phones: Array<{ label: string; number: string }>; services: string[]; // "Pharmacy", "Emergency Services", "Laboratory" plans: string[]; hasEmergency: boolean; hasUrgentCare: boolean; hasPharmacy: boolean; hasAfterHours: boolean; url: string | null; } interface KaiserFacilitySearchResult { zip: string; region: KaiserFacilityRegion; totalResults: number; facilities: KaiserFacility[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/kaiser_permanente/searchFacilitiesByZipCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.kaiser_permanente.searchFacilitiesByZip({ zip: "94612", limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.kaiser_permanente.searchFacilitiesByZip({"zip": "94612", "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/kaiser_permanente/searchFacilitiesByZip \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"zip":"94612","limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.kaiser_permanente.searchFacilitiesByZip({ zip: "94612", limit: 5 });searchQnaSearches Kaiser Permanente's public health question-and-answer content for a term, the same answers its site search shows.Arguments
Name Type Required querystringYes language"en" | "es"No regionKaiserFacilityRegionNo Returns
KaiserQna[]interface KaiserQna { question: string; answer: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/kaiser_permanente/searchQnaCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.kaiser_permanente.searchQna({ query: "flu shot" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.kaiser_permanente.searchQna({"query": "flu shot"}))curl -X POST https://api.bowmark.ai/v1/sites/kaiser_permanente/searchQna \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"flu shot"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.kaiser_permanente.searchQna({ query: "flu shot" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/kaiser_permanente/<function> - OpenAPI
/v1/sites/kaiser_permanente/openapi.json