Integration · Marketing

Connect Claude & ChatGPT to Roaspy

Ask your AI which campaigns brought in revenue last month, what a lead clicked before converting, or how your funnel performed this week. It reads Roaspy's attribution reports, creative results, funnels and contacts, and can record bookings and purchases or create tracking links. You get ad numbers in a sentence instead of a report export.

Connect Roaspy free

Free plan, no credit card. Takes about a minute.

Try asking

“What was ROAS per campaign last month, last-click?”
The AI pulls the ads report at campaign level for the dates you name, with spend, revenue, ROAS and conversions.
“Which sales came from the ad set 'Retargeting DK'?”
It finds the ad set row in the report and lists the individual sales attributed to it.
“How did this month compare to last month on cost and revenue?”
It gets total ad cost and revenue for both periods and shows the difference.

What your AI can do

Attribution reports

Spend, revenue, ROAS and conversions by platform, ad account, campaign, ad set or ad, with last-click, first-click, linear or scientific attribution.

Contacts and journeys

Search leads, sales, bookings and applications, read a contact's journey and purchases, and update qualification or show-up status.

Funnels and tracking

Read funnel conversion and daily performance, list products and funnels, and create tracking links for your ads.

“What did [email protected] click before she bought?”
It searches for the contact and reads their touchpoint journey: clicks, visits and ads.
“Which creatives on Meta did best this week?”
It gets the creatives report for that platform and dates, sorted by the metric you ask for.
“Mark order 1234 as refunded.”
It marks the recorded purchase as refunded in Roaspy so revenue figures are correct. No money is sent back.

26 tools for Roaspy

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

create_contactChanges dataCreate a contact with `email` and optional first name, last name and phone.
create_tracking_linkChanges dataCreate a tracking link with a `slug`, the `destination_url`, and the ad `platform`, `account` and `campaign` it belongs to.
delete_contactDeletesPermanently delete a contact by `contact_id`. This cannot be undone.
get_ads_reportGet the attribution report broken down by `tab` (platforms, ad-accounts, campaigns, ad-sets, ads) between `from_date` and `to_date`: spend, revenue, ROAS and conversions.
get_ads_report_totalsGet the summed totals for the attribution report, using the same `tab`, dates, filters and `attribution_mode` as the ads report.
get_contactGet one contact by `contact_id`, with their details, source and revenue.
get_contact_journeyGet the touchpoint journey (clicks, visits, ads) that led a contact to convert, by `contact_id`.
get_contact_pipelineGet the contact pipeline board (cards per stage), filtered by `keyword`, `email`, revenue range or date range.
get_cost_and_revenueGet total ad cost and revenue between `from_date` and `to_date`, optionally compared to a previous period.
get_creatives_reportGet performance per ad creative for one ad `platform` between `from_date` and `to_date`, sortable by metric.
get_current_userGet the connected Roaspy user and their businesses. Use to confirm which account you are working in.
get_daily_performanceGet day-by-day performance data between `from_date` and `to_date`, optionally compared to a previous period.
get_funnel_reportGet step-by-step funnel conversion data between `from_date` and `to_date`, optionally for a saved funnel view (`view_id`).
list_contact_purchasesList the purchases recorded for a contact by `contact_id`.
list_funnelsList your tracked funnels, optionally searching by name.
list_productsList your products, optionally searching by name.
list_report_bookingsList the individual bookings behind one row of the ads report: pass the `tab` level and that row's ID as `resource_id`, plus `from_date` and `to_date`.
list_report_leadsList the individual leads behind one row of the ads report: pass the `tab` level and that row's ID as `resource_id`, plus `from_date` and `to_date`.
list_report_salesList the individual sales behind one row of the ads report: pass the `tab` level and that row's ID as `resource_id`, plus `from_date` and `to_date`.
list_tracking_linksList your tracking links, optionally filtered by `platform` or `account`.
mark_purchase_refundedMoves moneyMark a recorded purchase as refunded by `purchase_id`, optionally with `refunded_at`. This updates Roaspy's revenue figures; it does not send money back to the customer.
record_bookingChanges dataRecord a booked call or meeting for a contact with `email`, `first_name`, `last_name`, `start_time`, `status`, the `booking_platform` and its `external_id`.
record_purchaseChanges dataRecord a purchase for a contact by `email` with `amount` in cents, `currency`, `status` (pending, paid, failed, refunded), `purchase_platform` and optional products and UTM data.
search_contactsSearch contacts in a `tab` (leads, sales, bookings, applications) by `keyword`, `email`, `source`, product, revenue range or date range. Use this to find a contact ID.
set_contact_statusChanges dataSet a contact's `qualification_status` (qualified, unqualified) or `appointment_status` (show_up, no_show) by `contact_id`.
update_purchaseChanges dataUpdate a recorded purchase by `order_id`: amount, status, currency, products or UTM data. Only the fields you pass change.

Set up in three steps

1
Pick the app
Create a free PipMCP account and choose Roaspy from the app list.
2
Paste your key
Paste your Roaspy API key and your Business ID. In Roaspy go to Settings > General > API Keys, click Create API Key, name it and copy the key. Your Business ID is shown under Settings > General.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Roaspy?

The AI can read ads reports and totals, creative performance, cost and revenue, daily performance, funnel analytics, attributed leads and sales, contacts, journeys, purchases, the pipeline, funnels, products and tracking links. It can create contacts and tracking links, record bookings and purchases, update purchases and contact status, mark purchases as refunded and delete contacts.

Does the AI see my Roaspy credentials?

No. Your Roaspy API key and Business ID are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with reports only. Marking a purchase as refunded changes your revenue figures and deleting a contact is permanent, and both can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your PipMCP link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

PipMCP has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Roaspy account.

Does recording a purchase or refund move money?

No. record_purchase and mark_purchase_refunded only update Roaspy's own records, so your revenue and ROAS figures are right. Amounts are given in cents. Any real payment or refund still happens in your payment system.