Skip to content
Amplifier
Console

MCP Server

The Amplifier Health MCP server lets you connect AI assistants and agents to the voice biomarker API without writing custom integration code. Connect via the Claude Desktop Custom Connector UI (Option A) or configure any MCP client directly with your 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.

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

Option B — Direct connection (any MCP client)

Use this path when you want to connect a specific client manually, including Claude Desktop via its config file, the OpenAI Agents SDK, or any other MCP-compatible host.

The server details:

  • 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 Credentials below for where to find them.

Claude Desktop (manual config)

Add the following to your claude_desktop_config.json file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "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:

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.",
  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 under API Keys.

  • Account ID — identifies your account; safe to include in server-side configs.
  • API Key — treat this as a secret; store it in an environment variable or secrets manager rather than committing it to source control.

Note

Keep your API Key out of client-side or publicly accessible configurations. Use environment variables or a secrets manager to inject credentials at runtime.

What you can do

Connect your AI assistant or agent to the Amplifier Health voice biomarker API to submit audio for analysis and retrieve results, without writing custom API integration code. The MCP server exposes the same capabilities as the REST API — use it from within Claude, an OpenAI agent, or any other MCP-compatible host.

For full details on available models, signs, result fields, and audio requirements, see the Guides and API Reference.