Orphex — Claude Code MCP server: analysis and setup
Orphex — an MCP server for Claude Code analyzes ad spend, ROAS, and campaigns across connected accounts. It compares periods and applies changes only after approval.
Apache-2.0 ★ 2 updated 2026-11-16
claude mcp add --transport http mcp https://api.orphex.co/api/interaction-gateway/v1/mcpWhat Orphex does
The server brings Orphex ad-account data into an AI assistant. It can inspect spend, ROAS, live campaigns and budgets, prepare reports, review account changes, and flag pacing or conversion anomalies. It can also apply an approved action, such as pausing a campaign.
An Orphex account with at least one workspace is required. Sign-in uses OAuth in a browser, so no API key is pasted. The remote MCP endpoint is https://api.orphex.co/api/interaction-gateway/v1/mcp; Claude Code needs port 33418 free during sign-in.
What it helps with
- compare ad spend and ROAS across periods
- build a report for advertising campaigns
- check live campaigns and their budgets
- spot pacing and conversion anomalies
- apply an approved campaign change
Example prompts for the agent
- Compare spend and ROAS for last week with the previous week across the ad platforms.
- Build a monthly campaign report for October with an executive summary.
- Show a preview before pausing the Meta campaign, then apply the change after approval.
How to install Orphex
Platform CLI: remote server
claude mcp add --transport http mcp https://api.orphex.co/api/interaction-gateway/v1/mcpPlatform CLI: remote server
codex mcp add orphex --url https://api.orphex.co/api/interaction-gateway/v1/mcpConfig file
{
"mcpServers": {
"orphex": {
"url": "https://api.orphex.co/api/interaction-gateway/v1/mcp"
}
}
}Config file
{
"servers": {
"orphex": {
"type": "http",
"url": "https://api.orphex.co/api/interaction-gateway/v1/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http orphex https://api.orphex.co/api/interaction-gateway/v1/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Orphex
How do I install Orphex in Claude Code?
Run claude mcp add --transport http mcp https://api.orphex.co/api/interaction-gateway/v1/mcp, then sign in to Orphex in the browser on the first call.
What does Orphex do?
Orphex lets an AI assistant inspect spend, ROAS, campaigns, reports, and account change history across connected ad accounts. Changes are applied after approval.
What does Orphex require to work?
An Orphex account with at least one workspace and browser-based OAuth sign-in are required. No API key is needed; Claude Code requires port 33418 to be free during sign-in.