UpHex

Plugin that connects agents to UpHex, the ad-operations platform for marketing agencies, through UpHex's official remote Model Context Protocol server.

Search clients and campaigns, pull Meta and Google Ads performance, review leads and EZ Forms, inspect and validate campaign templates, check ad-account and connection health, and prepare, confirm, and track campaign launches, all from chat.

Install

1. Open Settings → Plugins (Grok Bot or Cursor).
2. Search for UpHex.
3. Click Install, then complete the UpHex sign-in prompt.

Or run /add-plugin uphex in chat.

MCP

{
  "mcpServers": {
    "uphex": {
      "type": "http",
      "url": "https://app.uphex.com/api/mcp"
    }
  }
}

Auth is OAuth 2.1 with PKCE and Dynamic Client Registration. The client registers itself and prompts for UpHex sign-in when the plugin connects. There is no client ID or API key to configure. Each user signs in with their own UpHex agency login, and every call is scoped to that user's agency.

• Protected-resource metadata: https://app.uphex.com/.well-known/oauth-protected-resource/api/mcp
• Authorization-server metadata: https://app.uphex.com/.well-known/oauth-authorization-server/api/mcp

Before you connect

You need an UpHex agency account with an active subscription (sign up). MCP requests from inactive or unpaid agencies are rejected with 403 Subscription inactive.

The consent screen asks for one or both scopes:

Scope	Grants
mcp:read	Metrics, lists, details, search, and status tools
mcp:write	Launching campaigns, creating and updating templates, sending outreach, and AI image generation

Grant only mcp:read for a read-only install.

What agents can do

Category	Examples
Clients & agency	client_search, client_list, client_details, agency_info, agency_operations_summary
Performance	campaign_performance, campaign_metrics, ad_performance, adset_data, agency_campaign_performance_export
Leads & forms	lead_list, lead_details, client_lead_stats, ez_form_list, ez_form_leads
Templates	template_search, template_details, template_validation, template_metrics
Health & diagnostics	ad_account_health, ad_account_resources, check_account_status, diagnose_facebook_connection
Launches	campaign_launch_prepare → campaign_launch → campaign_launch_status / campaign_launch_errors
Alerts	alerts_set_subscription, alerts_poll, alerts_acknowledge
Search	search, fetch

The hosted server is the source of truth for tool names and schemas. The live catalog is shown in-app at https://app.uphex.com/help/mcp_connectors.

Notes

• Launches affect real ad accounts and spend. Always use campaign_launch_prepare first, review the returned plan with the user, and call campaign_launch with only the returned plan_id after explicit confirmation. Use launch_mode: "draft" when the user wants a non-delivering campaign.
• If a launch confirmation times out, check campaign_launch_status with the same plan_id before retrying. Never prepare a new plan just because the confirm response was lost.
• Tool annotations (readOnlyHint, destructiveHint) are published on every tool. Keep the host's tool-approval prompts on for write tools.

Docs

• Product: https://uphex.com
• Privacy policy: https://uphex.com/privacy
• Terms: https://uphex.com/tos
• MCP spec (Streamable HTTP): https://modelcontextprotocol.io/specification/2025-06-18/basic/transports

Support

Questions or issues: support@uphex.com

Logo is UpHex's official hexagon mark.

License

MIT © UpHex LLC