Bounty Docs

Bounty exposes a read-only Model Context Protocol server for marketing analysis. It gives MCP clients a curated way to inspect campaign, ad, creative, metric, and action data using the authenticated user’s normal Bounty permissions.

Connect To Bounty

Sign in and open Bounty Settings.
Copy the MCP URL shown in Settings.
Follow the instructions there to connect your MCP client.

Settings provides the URL and setup instructions to use for your connection.

What The MCP Server Can Access

The MCP server can read organization-scoped Bounty data that the authenticated user can already access:

Account context and data freshness.
Saved marketing metric definitions, trends, and breakdowns.
Campaign rankings and campaign performance.
Campaign analysis findings.
Facebook ad rankings, campaign ads, and creative analytics.
Google Ads keyword and bidding diagnostics.
Existing Bounty actions.

It does not expose raw warehouse SQL, arbitrary table dumps, arbitrary Python execution, infrastructure credentials, or write actions.

Date Ranges

Most data tools accept either explicit dates:

{
  "startDate": "2026-05-01",
  "endDate": "2026-05-27"
}

or a preset:

{
  "datePreset": "last_30_days"
}

Supported presets are:

today
yesterday
last_7_days
last_30_days
month_to_date

Explicit dates win over presets. Tool responses include the requested range and the effective range used by Bounty.

Tool Reference

All tools are read-only and return both text and structured JSON. Data-bearing tools include freshness, warnings, and a confidence basis.

Tool	Use It For	Key Inputs
`get_account_context`	Understand the authenticated organization, timezone, available paid platforms, primary conversion metadata, catalog counts, and freshness.	None
`search_marketing_catalog`	Search saved metrics, curated data sources, dimensions, and available campaign platforms.	`query`, `limit`
`get_metric_definition`	Inspect a saved metric before making semantic claims.	`metricId`
`get_metric_trend`	Fetch daily, weekly, or monthly values for one or more saved metrics.	`metricId` or `metricIds`, `granularity`, `includeComponents`, date range
`get_metric_breakdown`	Break one saved metric down by an approved catalog dimension.	`metricId`, `breakdownColumn`, `limit`, date range
`rank_campaigns`	Rank paid campaigns by spend, primary conversions, or CAC/CPA.	`platform`, `sortBy`, `sortDirection`, `limit`, date range
`get_campaign_performance`	Fetch daily campaign performance, conversion-event breakdowns, correlated metrics, and fallback flags.	`campaignId`, optional `platform`, date range
`analyze_campaign`	Return executive-ready findings for one campaign with supporting evidence.	`campaignId`, optional `platform`, date range
`rank_ads`	Rank Facebook ads across campaigns by spend, impressions, clicks, CTR, CPC, frequency, fatigue, status, and trend.	`status`, `sortBy`, `sortDirection`, `limit`, date range
`get_campaign_ads`	Fetch ad-level evidence for one Facebook campaign.	`campaignId`, date range
`get_creative_analytics`	Fetch Facebook creative hook, hold, frequency, fatigue, aggregate, and daily performance data.	`adId`, `limit`, date range
`get_google_keyword_diagnostics`	Inspect Google Ads keyword performance and bidding strategy diagnostics.	`campaignId`, date range
`search_actions`	Search existing Bounty actions without mutating them.	`query`, `status`, `includeStale`, `limit`

Example Workflows

Start broad, then drill down:

Use Bounty MCP to get account context, then rank Facebook campaigns by CAC for the last 30 days. If a campaign has weak efficiency, analyze the top issue and cite the freshness warnings.

Inspect metric semantics before reporting:

Search the marketing catalog for "CAC". Pick the most relevant saved metric, show its definition, then fetch its daily trend for month to date.

Investigate a campaign:

Analyze campaign `google_ads:1234567890` for the last 7 days. Include keyword diagnostics if available and say whether the conclusion is directional or high confidence.

Review existing actions:

Search Bounty actions for "creative fatigue". Show live and in-progress actions first, and include stale actions only if there are no current matches.

Evidence And Confidence

Bounty MCP responses are designed for evidence-based analysis:

Use rank_campaigns for campaign CAC rankings instead of ad hoc joins.
Treat stale freshness, missing freshness, or source-alignment warnings as directional.
Prefer configured primary conversion and paid-efficiency semantics over raw platform conversion counts.
Cite the tool outputs, date range, and warnings when making budget or performance recommendations.

Bounty App

Integrations

MCP

Legal

MCP Server

Connect To Bounty

What The MCP Server Can Access

Date Ranges

Tool Reference

Example Workflows

Evidence And Confidence

​Connect To Bounty

​What The MCP Server Can Access

​Date Ranges

​Tool Reference

​Example Workflows

​Evidence And Confidence

Connect To Bounty

What The MCP Server Can Access

Date Ranges

Tool Reference

Example Workflows

Evidence And Confidence