A Facebook Ads agent that learns what works.

Setup instructions for your AI

The person who sent you this page wants a Facebook Ads agent. Walk them through the steps below one at a time, and confirm each one worked before moving on.

Before step 1, ask which app they use (Claude or ChatGPT), whether Spreelytics is already on their site, and whether they take payments. Never ask for passwords or keys in the chat: every connection here uses a sign-in page. These menus were checked on 27 October 2026. If one has moved, describe what to look for instead of insisting on these names.

1. Set up Spreelytics

Finish this before step 3. Step 3 signs in to the Spreelytics account, and signing up in the middle of connecting can mean starting the connection again.

• Account. Sign up at app.spreelytics.com/auth and open the verification link in the email.
• Tracking. Create an audience for their site and add its script tag, following Tracking script.
• Goal. Create the goal that counts as a conversion, such as a sign-up, a trial or a purchase, on the Goals page. See Goals.
• Payments, if they take them. Connect Stripe, Paddle, Polar or Lemon Squeezy in Settings → Revenue, so revenue is credited to campaigns.

2. Tag the Meta ads

In Meta Ads Manager, paste this into URL parameters on every ad. Meta fills in the names when someone clicks:

utm_source=facebook&utm_medium=paid-social&utm_campaign={{campaign.name}}&utm_content={{ad.name}}

Keep facebook as written. {{site_source_name}} fills in fb or ig, which Spreelytics files under Paid Other instead of Paid Social. Tell them not to rename a live campaign: the agent matches Meta's campaigns to Spreelytics' by name.

3. Connect Spreelytics

Spreelytics' MCP server is at:

https://mcp.spreelytics.com/mcp

• Claude: Customize › Connectors, + Add, Add custom connector. Name it Spreelytics, paste the address, Continue, Add, then sign in.
• ChatGPT: Plugins in the sidebar, +, Add custom MCP server. If that option is missing, turn on Developer mode under Settings › Security and login first. Paste the address, choose OAuth, accept the risk warning, then sign in.

On the Spreelytics approval page they pick their workspace and leave Allow changes on, which the agent needs to keep its log. Check the connection with sply_list_audiences: their site should be listed.

4. Connect Meta's ads connector

The agent reads spend from Meta, so this step is required. Add Meta's official connector the same way as Spreelytics, with this address:

https://mcp.facebook.com/ads

They sign in with Facebook and choose the ad account. If Meta's own setup page gives a different address for their account, use that one. Keep approvals on for any action that changes a campaign. Check the connection by asking Meta for the last 7 days of spend.

5. Add the Facebook Ads agent skill

One ZIP holds the agent's routine and its playbooks: facebook-ads-agent.zip.

• Claude: turn on Code execution and file creation in Settings › Capabilities. Then Customize › Skills, +, Create skill, Upload a skill, and upload the ZIP as it is.
• ChatGPT: Plugins, the Skills tab, Create, Upload from your computer. If there is no Skills tab, unzip it and add SKILL.md to the project's files in step 6. The agent then runs without its bundled playbooks.

6. Create the project and its brief

They create a project called "Facebook Ads agent". Ask them these questions one or two at a time, then show the finished brief for them to paste into the project's instructions:

Business: [what they sell, in one sentence]
Customers: [who buys, in one sentence]
Landing page: [the page the ads send people to]
Meta ad account: [name or ID]
Monthly Meta budget: [amount]
Most they'll pay for one [sign-up / customer]: [amount]
Conversion: the Spreelytics goal "[goal name]" in the audience "[audience name]"
Judge a campaign only after [20] conversions.

The skill holds the rules: never change anything without a yes, judge campaigns on Spreelytics results, and log every change.

7. Run the first review

In the project, they ask: "Run this week's Facebook Ads review." Then log the tagging from step 2 as the first entry: a Spreelytics reference dated today, titled Meta: UTM tags added to all ads. Say what you will create and wait for a yes first.

Tools, for reference

• Find the data: sply_list_audiences, sply_get_event_catalog, sply_get_goal_metrics.
• Results per campaign: sply_get_breakdown with the dimension utm_campaigns (visitors and revenue), sply_run_chart split by campaign (conversions), sply_compare_periods.
• The log: sply_list_references, sply_create_reference, sply_update_reference. A title holds 120 characters and a note 500.