API & MCP
Connect your own tools and AI agents. Safely.
A REST API and an MCP server to read data and create drafts and proposals. No API or MCP scope can approve or apply a change.
REST API (/v1)
- API keys that expire after 90 days, with an optional IP allowlist.
- Idempotency keys for safe retries, and documented rate limits.
- Webhooks signed with HMAC, so you can verify that events come from us.
MCP server
- OAuth 2.1 sign-in, with grants per workspace.
- A tenant switch for MCP access: off, allowlisted clients only, or any client.
- The same capability registry as the interface: what the chat can read or draft, your agent can too.
What a key or agent can do
| Capability | API | MCP |
|---|---|---|
| Read data (campaigns, verdicts, profit, reports) | Yes | Yes |
| Create drafts (posts, ad changes, reports) | Yes, on plans with full API | Yes |
| Submit proposals to the approval queue | Yes, on plans with full API | Yes |
| Approve or apply a change | No scope can | No scope can |
Decisions happen only in a human session with recent multi-factor authentication.
Availability by plan
| Plan | Access |
|---|---|
| Starter | API, read only |
| Growth | API |
| Pro, Agency Starter, Agency 15, Agency | API + MCP |
| Enterprise | API + MCP with dedicated limits |
You are responsible for vetting the MCP clients and AI agents you connect, and for granting only the access they need. Pricing →
Build on 1ads without giving up control
Access is by request. A person reviews every request; we aim to reply within 5 business days.