# Pushnami Ads Help Center

> Documentation for Pushnami Ads, a push notification advertising network. Advertisers and their AI agents can manage campaigns, creatives and source bids through the Campaign Management API and MCP server.

## For AI agents

- [Agent Guide](https://help.pushnami.com/developers/agents): start here. How to connect, the tools, validation rules, and the actions that need the user's confirmation.
- [MCP Server](https://help.pushnami.com/developers/mcp-server): MCP endpoint https://ads-api.pushnami.com/mcp (Streamable HTTP, Bearer API key).
- MCP sign-in without a key: MCP clients that support OAuth sign-in can connect to https://ads-api.pushnami.com/mcp and sign in (OAuth) with the email address and password the advertiser uses for Pushnami Ads (an email address, not a username). REST /v1 needs an API key.
- [Campaign Management API](https://help.pushnami.com/developers/campaign-management-api): REST reference. OpenAPI: https://ads-api.pushnami.com/v1/openapi.json. Read-only balance: GET /v1/balance.
- Keys: 30, 90 or 365 days (365 by default), renewed in place on the dashboard's API Access page. Warnings in the last 14 days: header `Pushnami-Api-Key-Expiry-Warning` (REST) or `key_expiry_warning` (MCP). Tell the user; never renew a key yourself.
- [Spend Report API](https://help.pushnami.com/developers/spend-report-api): reporting (spend, clicks, conversions by campaign, creative and source).

## Discovery

- AI Catalog: https://help.pushnami.com/.well-known/ai-catalog.json (also on https://ads.pushnami.com and https://ads-api.pushnami.com)
- MCP server card: https://ads-api.pushnami.com/mcp/server-card
- API catalog (RFC 9727): https://ads-api.pushnami.com/.well-known/api-catalog

## Product docs

- [Campaigns](https://help.pushnami.com/campaigns)
- [Creatives](https://help.pushnami.com/creatives)
- [Creative review process](https://help.pushnami.com/creatives/review-process)
- [Dynamic variables for creatives](https://help.pushnami.com/creatives/dynamic-variables-for-creatives)
- [Dynamic values for tracking](https://help.pushnami.com/creatives/dynamic-values-for-tracking)
- [Source optimization](https://help.pushnami.com/campaigns/source-optimization)
- [Push notification specifications](https://help.pushnami.com/best-practices/push-notification-specifications)