Give your AI client a live Rival Ads workspace.

Ask for current competitor ads, organize a swipe file or update a client report through tools that call the same services as the dashboard.

Open Developer settings Need REST instead? Explore the API

OAuth connection

Rival Ads

{
  "mcpServers": {
    "rival-ads": {
      "url": "https://www.rivalads.io/api/mcp"
    }
  }
}

OAuth-first

OAuth 2.1 + PKCE for owners. API keys for machines.

Interactive clients can connect without copying a secret. Servers, CI and unattended agents can use the same scoped key as the REST API.

Discover: The client reads standards-based protected-resource and authorization-server metadata from the MCP URL.
Approve: A workspace owner signs in, sees the client and requested permissions, then approves or cancels on a clear consent screen.
Work: The client receives a short-lived access token and can call only the tools in workspaces that account owns.

Connect with OAuth.

Paste only the server URL. Your client discovers the flow, opens owner sign-in and requests consent. Access tokens expire after one hour; refresh tokens last seven days and can be revoked sooner.

No secret to copy

Rival Ads

{
  "mcpServers": {
    "rival-ads": {
      "url": "https://www.rivalads.io/api/mcp"
    }
  }
}

Connect with an API key.

Create a read-only or read/write key in Developer settings, copy it once and send it as a Bearer token. This is the dependable path for headless and non-interactive agents.

Static credential

Rival Ads

{
  "mcpServers": {
    "rival-ads": {
      "url": "https://www.rivalads.io/api/mcp",
      "headers": {
        "Authorization": "Bearer ra_live_your_key"
      }
    }
  }
}

Purpose-built tools

Give the model actions, not a database.

Tool names are explicit, inputs are validated and destructive actions are marked. Cross-workspace IDs still resolve as not found.

Research: list_workspaces
list_monitors
get_monitor
get_project
get_monitor_ads
list_monitor_analyses
Organize: list_projects
create_project
list_library_ads
save_library_ad
create_library_folder
Operate: create_monitor
update_monitor
request_monitor_sync
get_monitor_sync
update_report_share

Connect once. Work with live evidence.

Use OAuth for an interactive client or create a key for an unattended agent.

Open Developer settings