Skip to content
Foreplay logo

Foreplay MCP server

Competitive advertising data and creative insights platform. Search, filter, and analyze ads and brands with live and historical ad creatives, metadata, and competitive intelligence.

Foreplay is not a separate install. One Activepieces MCP server exposes it alongside 760+ other apps, behind a single URL.

Tools
5
Works with
Any MCP client
Auth
API key
License
MIT, open source
Updated
August 2026

About the Foreplay MCP server

Connect Foreplay once in Activepieces and every action it ships becomes a tool your assistant can call, behind the same server URL as the rest of your apps. Your agent reaches Foreplay and 760+ other apps over a single connection, on our cloud or a self-hosted install.

Tools

Foreplay tools your AI can run

Once connected, your assistant can call any of these Foreplay actions by asking in plain language.

  • Get Ad by ID

    Get detailed information about a specific ad by its ID.

    1 field

  • Get Ads by Page

    Get all ads for a Facebook Page ID with filtering and pagination.

    12 fields

  • Find Brands

    Search for brands by name with fuzzy matching.

    2 fields

  • Find Ads

    Search and filter ads by text, dates, platforms, and categories.

    12 fields

  • Find Boards

    Get all boards for the authenticated user with pagination.

    2 fields

Triggers

Foreplay events your agent can watch

These start a run the moment something happens in Foreplay, so work gets picked up on its own.

  • New Ad in Spyder

    Triggers when new ads are added for a brand in Spyder.

    8 fields

  • New Ad in Board

    Triggers when a new ad is added to the selected board.

    8 fields

  • New Swipefile Ad

    Triggers when a new ad is added to your swipefile collection.

    9 fields

Foreplay MCP, answered.

No. That is the point of it. One Activepieces server exposes Foreplay alongside every other piece you connect, so your client keeps a single connection.

Yes. Activepieces is open source and free to start, and the MCP server is included on every plan, from the free cloud tier to any self-hosted deployment.

Connect Foreplay in Activepieces, enable the server under Settings → MCP Server, then paste your server URL into your client config. It authenticates over OAuth on first use.

It can call 5 tools, including Get Ad by ID, Get Ads by Page, Find Brands, and chain them with steps in other apps inside the same run.

Connections use OAuth2 with limited scopes and are stored under 256-bit encryption, with no API to read them back, so an agent gets scoped access rather than your keys.