MCP Server

The HMS4all MCP Server exposes 46 tools that AI agents can use to interact with the hospital management platform. It follows the Model Context Protocol specification.

Connecting

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "hms4all": {
      "url": "https://your-api.hms4all.com/sse",
      "headers": {
        "Authorization": "Bearer hms4all_sk_your_api_key"
      }
    }
  }
}

Cursor / Other MCP Clients

Transport: SSE
URL: https://your-api.hms4all.com/sse
Headers:
  Authorization: Bearer hms4all_sk_your_api_key

Custom MCP Client

import { Client } from '@modelcontextprotocol/sdk/client';
import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse';

const transport = new SSEClientTransport(
  new URL('https://your-api.hms4all.com/sse'),
  { headers: { Authorization: 'Bearer hms4all_sk_...' } }
);
const client = new Client({ name: 'my-app', version: '1.0' });
await client.connect(transport);

const result = await client.callTool('search-patients', {
  query: 'John Doe'
});

Tool Reference

46 tools organized by category. Each tool requires appropriate API key scopes. Tools marked null scope are public (no scope check).

Resources

The MCP server also provides read-only resources:

Human-in-the-Loop (HITL)

The propose-* tools create pending actions that must be approved by a human before execution. This is the safety mechanism for clinical AI actions.

Flow

1. AI agent calls propose-prescription with patient/medication data
2. An AgentAction record is created with status PENDING
3. Admin/doctor reviews in the Agent Actions dashboard
4. On Approve: status becomes APPROVED, execution event dispatched
5. On Reject: status becomes REJECTED with reason
6. After expiry (default 60 min): status auto-transitions to EXPIRED

Auto-Approval

Tenants can configure auto-approval per action type in Settings. CRITICAL priority actions are never auto-approved.

Interactive Tool Tester

Rate Limits

MCP endpoints are rate-limited to 10 requests/minute per client. If you hit the limit, you will receive a 429 response.