# Orphex

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2 repo stars
- Author: OrphexTech
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/OrphexTech/orphex-agent-plugin
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/orphex

## What it 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.

## Requirements
- Remote server: `https://api.orphex.co/api/interaction-gateway/v1/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://api.orphex.co/api/interaction-gateway/v1/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add orphex --url https://api.orphex.co/api/interaction-gateway/v1/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "orphex": {
            "url": "https://api.orphex.co/api/interaction-gateway/v1/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "orphex": {
            "type": "http",
            "url": "https://api.orphex.co/api/interaction-gateway/v1/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http orphex https://api.orphex.co/api/interaction-gateway/v1/mcp
```

## When to use it
- 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
- 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.

## Similar
- [competitor-ad-intelligence](https://affpapa.org/en/nevibecode/skills/competitor-ad-intelligence.md) — skill · 33 installs
- [ads-copywriter](https://affpapa.org/en/nevibecode/skills/ads-copywriter.md) — skill · 5700 installs
- [ad-copy-writer](https://affpapa.org/en/nevibecode/skills/ad-copy-writer.md) — skill · ★ 116 repo stars
- [paid-ads](https://affpapa.org/en/nevibecode/skills/james-dickerson-at-boringmarke-paid-ads.md) — skill · ★ 778 repo stars
- [ad-copy](https://affpapa.org/en/nevibecode/skills/ad-copy.md) — skill · ★ 249 repo stars
- [Google Ads MCP by Markifact](https://affpapa.org/en/nevibecode/mcp/google-ads-mcp-by-markifact.md) — MCP server · ★ 1 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
