Endpoint directory for agents

Beta — This feature is subject to change. The MCP specification and our implementation may evolve.

The Endpoint Directory is available to AI agents as four public capabilities in Health tools for agents, Flexpa's public MCP registry. They search and validate health insurance and healthcare provider endpoints, including plan type support and the authentication flow each endpoint uses. They do not require authentication.

Use them to build payer or provider selection flows, validate endpoint support for specific plan types, or let AI agents help users find their health insurance company or healthcare provider.

Endpoint

POST https://api.flexpa.com/mcp

#Configuration

The directory capabilities come with the registry connection. Paste the setup message into your agent, or follow the manual setup options in Health tools for agents. Either way, the server is https://api.flexpa.com/mcp with no authentication.

Once connected, the directory capabilities appear in search_tools results with the directory. prefix. Call them through execute_tool with the namespaced name and the arguments documented below.

Setup message

Connect this agent to Flexpa’s health tool search.

Read https://www.flexpa.com/agents.md and follow the setup instructions. Help me complete any steps that need my input.

If I have not already told you what I need help with, ask me. Otherwise, find relevant health tools for my request.

#Tools

#directory.search_endpoints

Search for health insurance payers and healthcare providers by name, brand, acronym, or state.

Returns up to 10 matching endpoints with organization details, connection status, and supported lines of business.

Parameters

querystringRequired: Search query — payer name, provider name, brand, acronym, or state. Examples: "Aetna", "BCBS Illinois", "Mayo Clinic"

Blue Cross Blue Shield is a federation of independent companies per state. If a user says "BCBS", the tool's instructions guide the AI to ask which state before searching.

{
  "name": "execute_tool",
  "arguments": {
    "name": "directory.search_endpoints",
    "arguments": {
      "query": "Aetna"
    }
  }
}

#directory.get_endpoint_details

Get detailed information about a specific endpoint, including supported lines of business with authentication flow info, connection status, features like inactive member access and 2FA requirements, and any ONC-certified EHR products linked to the endpoint via the CHPL.

Parameters

endpointIdstringRequired: The endpoint ID from directory.search_endpoints results

{
  "name": "execute_tool",
  "arguments": {
    "name": "directory.get_endpoint_details",
    "arguments": {
      "endpointId": "cae5e9f1-b6d6-4c7d-947a-f1f22c1e1420"
    }
  }
}

#directory.check_lob_support

Validate whether an endpoint supports a specific line of business (plan type) and determine the correct authentication flow.

Lines of business:

Type	Flow
`medicaid`	OAuth
`medicare_advantage`	OAuth
`chip`	OAuth
`aca_on_exchange`	OAuth
`aca_off_exchange`	OAuth or Credentials
`employer`	OAuth or Credentials
`original_medicare`	Special
`veterans`	Special

Parameters

endpointIdstringRequired: The endpoint ID from directory.search_endpoints
lineOfBusinessstringRequired: One of the line of business types listed above

{
  "name": "execute_tool",
  "arguments": {
    "name": "directory.check_lob_support",
    "arguments": {
      "endpointId": "cae5e9f1-b6d6-4c7d-947a-f1f22c1e1420",
      "lineOfBusiness": "employer"
    }
  }
}

The response includes pass/fail validation, the authentication flow type (OAuth or Credentials), and recommended next steps.

#directory.list_endpoints

List all endpoints in the directory, optionally filtered by status or line of business.

Parameters

statusstring: Filter by connection status. One of CONNECTED, IN_PROGRESS, BROKEN, UNKNOWN, or UNAVAILABLE. Default: CONNECTED
lobTypestring: Filter by line of business support. One of the line of business types listed under directory.check_lob_support (medicaid, medicare_advantage, chip, aca_on_exchange, aca_off_exchange, employer, original_medicare, veterans).
limitnumber: Maximum results to return (default 50, max 100)

{
  "name": "execute_tool",
  "arguments": {
    "name": "directory.list_endpoints",
    "arguments": {
      "lobType": "medicaid",
      "limit": 20
    }
  }
}

#Legacy directory connection

The deprecated https://api.flexpa.com/mcp/directory connection remains available. It exposes only the four original tools (search_endpoints, get_endpoint_details, check_lob_support, and list_endpoints) and retains these three prompts. The registry tools are not added to this connection. Use /mcp for new connections; its tools are search_tools and execute_tool.

find_insurance walks through identifying a user's insurer and plan type, then validates endpoint support.
find_provider walks through finding a healthcare provider or medical record system.
explore_directory browses all available endpoints with line of business details.

Prompts

{
  "method": "prompts/get",
  "params": {
    "name": "find_insurance"
  }
}

#Use cases

AI-powered endpoint selection — Let an AI assistant discover directory.search_endpoints and help users find their health insurance company or healthcare provider. Its instructions cover BCBS state disambiguation and Medicaid regional plans.

Endpoint validation — Before initiating a patient authorization, validate that the endpoint supports the user's plan type and determine whether to use the OAuth or Credentials flow.

Directory exploration — Build tools that help operations teams browse available payer and provider endpoints, filter by line of business, and understand coverage gaps.

#Next steps

Browse the Endpoint Directory for endpoint details and connection statuses
Explore Health tools for agents for the other servers and tools in the registry
Review Consent for OAuth and Credentials authorization flows