Provider & Connections

Tools for discovering healthcare providers and data-source endpoints, and for managing a connection's lifecycle
once established. These are the tools shared across every connection type (PROA, IAS-discovered, direct, or
device) rather than specific to one -- e.g. create_connection's integration_type spans DIRECT, PROA,
DIRECT_IAS, INDIRECT_IAS, and IAL2 in a single tool, and list_connections returns every connection
regardless of type, device connections included. Draws from the provider_search and search_connections
modules in mcpfhiragent/mcp_servers/tools/.

Tools specific to one connection flow live in subfolders instead of here:

  • proa/ -- starting and tracking the PROA OAuth flow
  • ias/ -- tracking the RLS/IAS network search and its discovered connections
  • devices/ -- wearable/health-tracking device provider discovery and status

Identity verification (IAL2) and consent management (the IAS consent decision) are distinct concerns split out of
search_connections in EA-2514 -- see the sibling identity/ and
consent/ groups for those.

ToolDescription
provider_searchBrowses and discovers healthcare providers, practices, insurance entities, labs, and pharmacies in the b.well provider directory (read-only).
search_connectionsSearches for healthcare data source endpoints a user can connect to in order to import their health records.
list_connectionsLists the data source connections the current user already has and each connection's status, across every connection type.
create_connectionCreates a new, non-OAuth data source connection (PROA/DIRECT_IAS/INDIRECT_IAS require credentials; DIRECT/IAL2 do not).
get_data_sourceGets static metadata for a single existing connection by connection_id.
disconnect_datasourceDisconnects an existing data source connection (idempotent, reversible via reconnect).
delete_connectionPermanently removes an existing data source connection (not self-service reversible).
activate_direct_connectionReactivates an existing, previously disconnected direct connection.

##



Did this page help you?