HalloFelix von InsurMagic – MCP Server

HalloFelix von InsurMagic – MCP Server

Official Model Context Protocol server for HalloFelix von InsurMagic, the AI phone and WhatsApp assistant for insurance brokers in Germany, Austria and Switzerland.

Connect Claude, ChatGPT, Cursor, VS Code or any MCP client to your HalloFelix account and let your AI agent read calls and transcripts, manage customers and outbound call campaigns, tune your voice and WhatsApp assistants, and work your WhatsApp inbox.

Server URL: https://app.hallofelix.de/api/mcp (remote, Streamable HTTP)

Authentication

• OAuth (recommended): clients with connector support (Claude.ai, Claude Desktop, ChatGPT, Cursor, VS Code) only need the URL. You sign in with your HalloFelix account and allow access (admins of the account only).
• API token: send your token as Authorization: Bearer <api_access_token>. Create it in the HalloFelix app under Integrationen → API.

Setup

Claude.ai / Claude Desktop

Settings → Connectors → Add custom connector → URL https://app.hallofelix.de/api/mcp → Connect.

ChatGPT

Settings → Apps & Connectors → Advanced → enable Developer mode → Create → URL https://app.hallofelix.de/api/mcp, authentication OAuth.

Claude Code

claude mcp add --transport http hallofelix https://app.hallofelix.de/api/mcp

Then run /mcp to sign in. With a token instead: append --header "Authorization: Bearer <api_access_token>".

Cursor

or in ~/.cursor/mcp.json:

{ "mcpServers": { "hallofelix": { "url": "https://app.hallofelix.de/api/mcp" } } }

VS Code (GitHub Copilot)

Install in VS Code

or code --add-mcp '{"name":"hallofelix","type":"http","url":"https://app.hallofelix.de/api/mcp"}'

Windsurf

~/.codeium/windsurf/mcp_config.json:

{ "mcpServers": { "hallofelix": { "serverUrl": "https://app.hallofelix.de/api/mcp" } } }

OpenAI Codex CLI

codex mcp add hallofelix --url https://app.hallofelix.de/api/mcp
codex mcp login hallofelix

Gemini CLI

~/.gemini/settings.json:

{ "mcpServers": { "hallofelix": { "httpUrl": "https://app.hallofelix.de/api/mcp" } } }

Any stdio-only client

{
  "mcpServers": {
    "hallofelix": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.hallofelix.de/api/mcp"]
    }
  }
}

Tools

Tools that send WhatsApp messages, start campaigns or change live assistants act on real customers; good clients ask you before running them (they carry MCP readOnlyHint/destructiveHint annotations).

Notes

• Free-form WhatsApp messages only work within 24 h of the customer's last message; outside that window send an approved template.
• Call recording links are signed and valid for 60 minutes.
• Full REST API and webhook reference: https://app.hallofelix.de/docs/external-api.md

Support

[email protected] · hallofelix.de · InsurMagic GmbH