generated: '2026-08-14' method: derived source: >- mcp/health-gorilla-mcp.yml, fhir/health-gorilla-r4-capabilitystatement.json, openapi/*.yml description: >- Crosswalk between Health Gorilla's agent-facing surface and its machine-readable API contract. The finding is a clean split rather than an overlap: the only MCP server Health Gorilla operates serves its DOCUMENTATION, and the entire clinical API is REST-only. There is no MCP tool bound to any FHIR operation, so crosswalk[] is empty by measurement — not for lack of mapping. The value in this file is the rest_only[] inventory: 43 FHIR resources and 46 custom operations that an agent can reach only by writing FHIR REST calls, with the twenty operations our OpenAPI actually grounds called out separately. surfaces: openapi: files: openapi/*.yml count: 10 operations: 20 gated: false note: >- Health Gorilla publishes no OpenAPI of its own. These ten documents are API Evangelist artifacts covering ten of the 43 declared resource types. fhir_capabilitystatement: url: https://api.healthgorilla.com/fhir/R4/metadata file: fhir/health-gorilla-r4-capabilitystatement.json gated: false note: >- The provider's authoritative machine-readable contract, served anonymously and generated by the running server. 43 resources, 46 custom operations. graphql: endpoint: null note: Health Gorilla exposes no GraphQL surface. mcp: url: https://developer.healthgorilla.com/mcp gated: true gate: 'HTTP 401 JSON-RPC -32001 Authorization required on tools/list' scope: documentation note: >- A ReadMe-hosted documentation MCP server. Its tools search and read developer-portal pages; none of them call api.healthgorilla.com. Tool names and inputSchemas could not be read anonymously and were not guessed. crosswalk: [] crosswalk_note: >- Empty by measurement. No MCP tool binds to a Health Gorilla FHIR operation, because the only MCP server in front of this provider is a documentation server and the clinical API has no MCP front end at all. mcp_only: - tool: '(documentation search and page retrieval tools)' reason: >- The developer.healthgorilla.com MCP server operates over the documentation corpus indexed in llms/health-gorilla-llms.txt, which has no REST equivalent on api.healthgorilla.com. Tool names are unknown because tools/list is auth-gated; they are described here by function, not named, to avoid inventing an inputSchema or a tool that may not exist under that name. confidence: low rest_only: - capability: Patient identity and demographics operations: [searchPatients, readPatient, createPatient, updatePatient] spec: openapi/health-gorilla-patient-api-openapi.yml binding: rest mcp_tool: null - capability: Complete patient record retrieval operations: [patientEverything] fhir_operations: ['Patient/$everything', 'Patient/$export-ccda'] spec: openapi/health-gorilla-patient-api-openapi.yml binding: rest mcp_tool: null - capability: Diagnostic ordering operations: [createRequestGroup, searchRequestGroups, readRequestGroup, createServiceRequest, searchServiceRequests, readServiceRequest] fhir_operations: ['RequestGroup/$submit', 'RequestGroup/$abn', 'RequestGroup/$label', 'RequestGroup/$pdf', 'ServiceRequest/$pdf'] spec: openapi/health-gorilla-requestgroup-api-openapi.yml, openapi/health-gorilla-servicerequest-api-openapi.yml binding: rest mcp_tool: null - capability: Results retrieval operations: [searchDiagnosticReports, readDiagnosticReport, searchObservations] fhir_operations: ['DiagnosticReport/$pdf', 'DiagnosticReport/$hl7'] spec: openapi/health-gorilla-diagnosticreport-api-openapi.yml, openapi/health-gorilla-observation-api-openapi.yml binding: rest mcp_tool: null - capability: Clinical documents operations: [searchDocumentReferences, readDocumentReference, readBinary] fhir_operations: ['DocumentReference/$ocr', 'DocumentReference/$pdf', 'DocumentReference/$export-ccda'] spec: openapi/health-gorilla-documentreference-api-openapi.yml, openapi/health-gorilla-binary-api-openapi.yml binding: rest mcp_tool: null - capability: Coverage and eligibility operations: [searchCoverage, readCoverage] spec: openapi/health-gorilla-coverage-api-openapi.yml binding: rest mcp_tool: null - capability: Provider directory operations: [searchPractitioners, readPractitioner] spec: openapi/health-gorilla-practitioner-api-openapi.yml binding: rest mcp_tool: null - capability: Server capability discovery operations: [getCapabilityStatement] spec: openapi/health-gorilla-capabilitystatement-api-openapi.yml binding: rest mcp_tool: null - capability: Federated record retrieval (Patient360, QHIN, CommonWell, Carequality) operations: [] fhir_operations: ['DocumentReference/$p360-retrieve', 'DocumentReference/$p360-search', 'DocumentReference/$qhin-search', 'DocumentReference/$hghin-search', 'DocumentReference/$ehex-search', 'DocumentReference/$cw-search', 'DocumentReference/$cq-search', 'Patient/$qhin-search', 'Patient/$cw-enroll', 'Patient/$cw-match', 'Patient/$cw-lookup', 'Patient/$cw-unenroll', 'Patient/$patient-qhin-smart-endpoints'] spec: null binding: rest mcp_tool: null note: >- Declared in the live CapabilityStatement, documented in the Patient360 and IAS guides, and not covered by any OpenAPI in openapi/. - capability: Event subscriptions operations: [] fhir_operations: [Subscription create/read/patch/delete/search] binding: rest mcp_tool: null detail: asyncapi/health-gorilla-webhooks.yml - capability: Terminology operations: [] fhir_operations: ['ValueSet/$expand', 'ValueSet/$search', 'CodeSystem/$lookup'] binding: rest mcp_tool: null - capability: Provider signatures and requisition settings operations: [] fhir_operations: ['PractitionerRole/$addSignature', 'PractitionerRole/$removeSignature', 'PractitionerRole/$signatures', 'Location/$requisition-settings', 'Organization/$requisition-settings'] binding: rest mcp_tool: null - capability: Direct Secure Messaging and fax operations: [] fhir_operations: ['DirectMessage/$searchProviders'] resources: [DirectMessage, FaxMessage, InstantMessage] binding: rest mcp_tool: null coverage: mcp_tools_named: 0 mcp_tools_bound: 0 mcp_only: 1 rest_capabilities: 13 rest_operations_in_openapi: 20 rest_operations_with_a_tool: 0 fhir_resources_declared: 43 fhir_custom_operations_declared: 46 fhir_resources_covered_by_openapi: 10 agent_readiness_finding: >- An agent that wants to read a patient chart, place a lab order or retrieve records across TEFCA has no tool to call. It must construct FHIR REST requests against api.healthgorilla.com and authenticate with OAuth 2.0. The MCP endpoint Health Gorilla does operate can answer questions about the documentation but cannot touch clinical data. The gap between the two is the whole clinical API. related: - mcp/health-gorilla-mcp.yml - fhir/health-gorilla-fhir.yml - skills/_index.yml