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 770+ other apps, behind a single URL.

Tools
6
Works with
Any MCP client
Auth
API key
License
MIT, open source
Updated
October 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 770+ 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 public ad library ID. Costs 1 Foreplay credit.

    1 field

  • Get Ads by Page

    Get ads for a Facebook Page ID with filtering and pagination. Costs 1 Foreplay credit per ad returned.

    12 fields

  • Find Brands

    Search for brands by name. Costs 1 Foreplay credit per search.

    2 fields

  • Find Ads

    Search and filter ads by text, dates, platforms, and categories. Costs 1 Foreplay credit per ad returned.

    12 fields

  • Find Boards

    Get the boards of your Foreplay account. Leave Limit empty to get all boards.

    2 fields

  • Custom API Call

    Make a custom API call to a specific endpoint

    10 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 Spyder finds a new ad for a tracked brand.

    9 fields

  • New Ad in Board

    Triggers when a new ad shows up in the selected board.

    9 fields

  • New Swipefile Ad

    Triggers when a new ad is saved to your swipe file.

    10 fields

Give your assistant Foreplay

Connect Foreplay once and every tool above is callable from Claude, Cursor or any MCP client, behind the same server URL as 770+ other apps. Free to start.

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 6 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.