MCP Server

Connect agents to Amplifier docs and API workflows over MCP.

The Amplifier Health MCP server lets an agent host call Amplifier over Streamable HTTP. Connect via Claude Desktop’s Custom Connector UI (Option A) or any MCP client with your REST credentials (Option B).

Option A — Claude Desktop (Custom Connector)

Claude Desktop supports adding remote MCP servers directly through its integrations settings — no config file editing required.

Open Claude Desktop and go to Settings → Integrations.
Click Add custom integration (the + button).
Enter the server URL: https://mcp.amplifierhealth.com/mcp
Follow the on-screen instructions in Claude to authenticate to Amplifier and finish connecting.

Option B — Direct connection (any MCP client)

Connect a client manually (Claude config file, OpenAI Agents SDK, or any MCP host).

URL: https://mcp.amplifierhealth.com/mcp
Transport: Streamable HTTP (stateless)
Auth: X-Account-ID and X-API-Key request headers

These are the same credentials used for the REST API — see Authentication and Credentials below for where to find them.

Claude Desktop (manual config)

Add this to claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

This block is client configuration rather than an API sample.

{
  "mcpServers": {
    "amplifier-health": {
      "type": "streamable-http",
      "url": "https://mcp.amplifierhealth.com/mcp",
      "headers": {
        "X-Account-ID": "your-account-id",
        "X-API-Key": "your-api-key"
      }
    }
  }
}

Restart Claude Desktop after saving the file. The Amplifier Health server will appear in the integrations list.

OpenAI

Use the openai-agents package to connect from a Python agent. This snippet is client configuration rather than an API sample.

import os
from agents import Agent
from agents.mcp import MCPServerStreamableHTTP

mcp_server = MCPServerStreamableHTTP(
    url="https://mcp.amplifierhealth.com/mcp",
    headers={
        "X-Account-ID": os.environ["AMPLIFIER_ACCOUNT_ID"],
        "X-API-Key": os.environ["AMPLIFIER_API_KEY"],
    },
)

agent = Agent(
    name="Amplifier Agent",
    instructions="Use the Amplifier Health tools to analyze voice recordings with the pulse wellness model.",
    mcp_servers=[mcp_server],
)

Other MCP clients

Any MCP client that supports remote Streamable-HTTP servers can connect using the URL https://mcp.amplifierhealth.com/mcp with X-Account-ID and X-API-Key passed as request headers. Consult your client’s documentation for where to specify the server URL and custom headers.

Credentials

Your Account ID and API Key are available in the Amplifier console: API Keys → Provide Name for Key → Create Key.

Account ID — identifies your account; safe to include in server-side configs.
API Key — secret. Store in an environment variable or secrets manager; do not commit it.

What you can do

Host lists tools after connect. Not a full REST substitute: groups, upload mint, and account webhook stay on REST — Groups API, Audio Uploads, Account API. Confirm the live tool list in your host.

Catalogs and contracts: Model Catalog, Sign Catalog, Response Schema, Audio Requirements.