canonical: https://jentic.com/apis/getmcpads.com/getmcpads

# Get MCP Ads Data API

The getmcpads.com advertising data API delivers shared advertising reports, authenticated downloads, and scheduled data syncs. It lists the accounts and report sources a key may read, discovers the metrics, dimensions, and levels available for a source, and queries a report where larger requests return an asynchronous extraction. Completed extractions expose their status, immutable result pages, and a full download, while scheduled syncs push report results to allowed destinations on a cadence. A usage endpoint reports consumption and limits, and test keys return synthetic data for safe integration. It is aimed at analysts and tools that need advertising report data pulled or delivered on a schedule.

## For AI agents

Pull and deliver advertising report data: discover metrics and dimensions, query reports, create and download extractions, and schedule syncs that push results to allowed destinations.

## Scope

Does not create or edit ad campaigns, manage budgets, or place bids. Use for querying advertising reports and syncing the results to destinations only.

## Capabilities

- List the accounts and report sources the current key is allowed to read
- Discover the metrics, dimensions, and levels available for a report source
- Query a report where larger requests return an asynchronous extraction
- Read extraction status, immutable result pages, and the full download
- Schedule syncs that push report results to allowed destinations on a cadence
- Read usage and limits for the current key

## Use cases

### Agent-run advertising report pull

An AI agent preparing a performance summary can call the getmcpads.com API through Jentic to discover a source's metrics and dimensions, query the report, and download the extraction once it completes. Jentic returns the report query operation from a natural-language query, so the agent pulls the data without reading the reference first.

Example prompt: Discover the source's metrics and dimensions, query the report for the requested date range, then read the extraction rows once the status is complete.

### Scheduled sync to a destination

Create a paused sync that pushes advertising report results to an allowed destination, then run or resume it on a cadence so a warehouse or sheet stays current. The sync operations expose pause, resume, run, and archive so a pipeline can control delivery without re-querying by hand.

Example prompt: Create a paused sync to the allowed destination, run it once to confirm delivery, then resume it so results push on the schedule.

### Metric and dimension discovery

Discover the metrics, dimensions, and levels a report source supports before building a query, which keeps a report definition valid as sources change. Analysts use the catalog to assemble correct report requests rather than guessing field names.

Example prompt: Read the catalog for the chosen source, list the available metrics and dimensions, and assemble a valid report query from them.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/v1/accounts` | List accounts the key may read |
| GET | `/v1/catalog/{source}` | Discover metrics, dimensions, and levels |
| POST | `/v1/reports/query` | Query a report |
| POST | `/v1/exports` | Create an extraction |
| GET | `/v1/exports/{id}` | Get extraction status |
| GET | `/v1/exports/{id}/rows` | Read a result page |
| GET | `/v1/syncs` | List synchronizations |
| POST | `/v1/syncs` | Create a paused synchronization |

## Key resources

- **Accounts** — List the accounts and report sources the current key may read
- **Reports** — Discover a source's catalog and query reports and saved definitions
- **Exports** — Create extractions and read their status, result rows, and downloads
- **Syncs** — Schedule, run, pause, resume, and archive syncs to destinations

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 56 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 99 / 100
  - Developer Experience & Jentic Compatibility: 69 / 100
  - AI-Readiness & Agent Experience: 31 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 61 / 100
- **View full report:** https://jentic.com/apis/getmcpads.com/getmcpads/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the getmcpads.com advertising data API by hand means handling its organization-scoped key as a bearer token, polling asynchronous extractions, and coding the catalog, query, and sync calls yourself. Through Jentic you install once, import the API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** The API puts export and sync ids in the URL path, so a rule can bound your agent to the operations it needs, such as discovering catalogs and querying reports. You choose which operations it may call, so the sync write operations are not included unless you add them.
- **Credential handling:** Your getmcpads key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'query an advertising report' or 'schedule a sync', and Jentic returns the matching getmcpads operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **SEMrush API** — Marketing analytics and competitive advertising data
- **Segment Public API** — Customer data pipeline that routes events between systems
- **Domo API** — Business-intelligence dashboards and data visualization

## FAQ

### Is there a Get MCP Ads Data API MCP server?

You do not need a separate MCP server to give your agent the getmcpads.com advertising data API. Jentic connects it directly from the API Directory: import the API, store your key once, and your agent calls the catalog, report query, export, and sync operations. Operations are discovered on demand, so no extra server definitions load into the agent's context.

### What authentication does the Get MCP Ads Data API use?

The API authenticates with an organization-scoped API key passed as a bearer token per its OpenAPI spec, and test keys return synthetic data for safe integration. Through Jentic the key is stored encrypted in your own Jentic One instance and supplied only when an allowed call runs, so it never reaches the agent's context.

### Can I schedule a sync to a destination with the Get MCP Ads Data API?

Yes. The sync operations create a paused sync, then run, resume, pause, or archive it so report results push to an allowed destination on a cadence. Polling and downloads do not consume additional request credits.

### What are the rate limits for the Get MCP Ads Data API?

The OpenAPI spec does not state fixed rate limits, and overages are blocked rather than throttled. A usage endpoint reports your current consumption and limits, and you can confirm the account caps in the getmcpads documentation at https://getmcpads.com.

### Can I limit what my agent is allowed to do with the Get MCP Ads Data API?

Yes. Write a rule that permits only the read operations, discovering catalogs and querying reports, when the agent should only report, and add the sync write operations only for workflows that actually schedule deliveries, with every call logged.

### How do I query an advertising report with the Get MCP Ads Data API through Jentic?

Search Jentic for 'query an advertising report' to surface the report query operation, load its input schema, pass the source, metrics, and date range, and execute, then read the extraction once it completes. To run it on your own infrastructure, install Jentic One from its GitHub repo.