ai-care-agent-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ai-care-agent-mcp Find a primary care doctor in Chicago accepting Cigna"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ai-care-agent-mcp
Headless care coordination agent: MCP tools and A2A skills for case-aware, multi-pathway provider search, powered by ai-carematch. Case-management API integration is planned for later phases.
Documentation
Spec — architecture, tools, case model, phases
Phased plan — status, workstreams, exit criteria
AWS deployment / IaC — Terraform, ECS, API Gateway
Acceptance — program and phase acceptance criteria
Project structure — repo layout and layer conventions
Related MCP server: FHIR MCP Server
Quick start
uv sync --dev --group test
cp .env.example .env # set CAREMATCH_BASE_URL
make verify
make run-mcp # stdio MCP serverLayout
src/ai_care_agent_mcp/
├── mcp/ # FastMCP tools + registry
├── carematch/ # upstream HTTP adapter
├── case/ # case profile resolution (Phase 2)
├── pathways/ # pathway catalog
├── core/ # settings, errors, logging
└── a2a/ # Agent Card (Phase 3)Status
Phase | Name | Status |
0 | Foundation | Complete |
1 | Carematch MCP MVP | In progress — schemas, OpenAPI pin, validation |
2 | Case-backed search | Planned |
3 | A2A + HTTP + AWS IaC | Planned — ECS, API Gateway, Terraform |
4 | Case-management APIs | Planned |
Details: docs/plan/phased-delivery.md.
Available Tools
4 toolsget_case_search_contextC
Resolve a case_ref to search criteria without executing search.
Inputs: case_ref (required), pathway, correlation_id, search_criteria. Returns: result
health_checkA
Report agent health and upstream carematch /health status.
Inputs: no named parameters. Returns: result
list_search_pathwaysA
Return supported search pathways and required field hints.
Inputs: no named parameters. Returns: result
search_providersC
Run a pathway provider search using case_ref, search_criteria, or both.
Inputs: pathway, case_ref, correlation_id, search_criteria. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a distinct and well-defined purpose: resolving case references, checking health, listing pathways, and searching providers. No two tools overlap in functionality.
All tool names use snake_case and are mostly verb_noun (get_, list_, search_), with the exception of health_check which is a noun phrase, but still follows the same style.
Four tools is a reasonable count for a focused care agent server. It covers the essential operations without being sparse or excessive.
The tool set covers the core workflow of obtaining search context, listing pathways, and searching providers. A health check is included. Minor gaps exist (e.g., no direct CRUD for cases), but the surface is adequate for its stated purpose.
Related MCP Connectors
MCP server for AI access to Swagger by SmartBear.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
MCP server for US nursing facility search and ownership lookup (NursingHomeDatabase).
Hosted MCP server for the Healthie EHR & telehealth API: patients, appointments, charting, tasks.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides healthcare tools for interacting with FHIR data and medical resources on EMRs like Cerner and Epic2MIT
- FlicenseNot gradedqualityCmaintenanceA comprehensive MCP server that bridges AI applications with FHIR healthcare data systems, enabling patient data access, clinical data retrieval, and data quality assessment.4-
- AlicenseNot gradedqualityDmaintenanceAn MCP server that brings AI-powered search and conversation to your FHIR clinical documents.19 PyPI1MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server for searching healthcare providers in the US National Provider Identifier (NPI) Registry, enabling natural language queries for provider data in MCP-compatible AI assistants.Apache 2.0