Quota Experience & Error Clarity
Completely overhauled how Adspirer communicates quota limits and errors across all AI clients.Usage Warnings Before You Hit the Wall
Tool responses now include a visible usage footer when you’re approaching your quota limit:- 75%+ usage —
📊 12/15 free calls used (80%) — 3 remaining. Upgrade: ... - 90%+ usage —
🚨 2 calls remaining! Upgrade now to avoid interruption: ...
Diagnostic Tools Always Available
get_usage_status, get_connections_status, and echo_test now work even when your quota is exhausted. You can always check your usage and connection status regardless of your remaining calls. These tools don’t count against your quota.Clear Error Messages
- Quota exceeded — shows a clean upgrade message with pricing and payment link (previously showed a generic “Error occurred during tool execution” on Claude)
- Session expired — now tells you exactly what happened and how to reconnect (previously showed the same generic error)
- Server errors — include the actual error details and retry guidance
Demand Gen: Multi-Region Ad Groups
Add ad groups to existing Demand Gen campaigns withadd_demandgen_ad_group:- Each ad group can target different locations (e.g., US cities vs India cities vs UAE cities)
- Each ad group can have its own audience signals (in-market + affinity segments)
- Reuse existing account images and YouTube videos across ad groups
- Different creative variations per ad group
Meta Ads: City Targeting & Placement Creatives
- City-level targeting — target specific cities in Meta campaigns with
search_meta_targeting - Placement-specific creatives — upload different images for Feed, Stories, and Reels placements
- Emoji support — use emoji in Meta ad headlines and descriptions
AI Client Input Resilience
Adspirer now handles common input mistakes from AI clients automatically:- JSON strings sent as text instead of objects are auto-parsed
- Integer IDs sent instead of strings are auto-coerced
- Extra whitespace and unknown fields are silently handled
- Works across all 100+ tools — no more validation errors from formatting issues
PMax: Multiple Asset Groups & Bidding Control
- Multiple asset groups per campaign — create campaigns with distinct asset groups for different product lines or audiences
- Bidding strategy control — your explicit bidding choice (Maximize Conversions, Target ROAS, etc.) is now always honored
- Auto-derived search themes — search themes are automatically suggested from your headlines and descriptions
- Post-creation nudge — after creating a PMax campaign, you’re prompted to add search themes and audience signals
Demand Gen Campaign Creation
Full support for Google Demand Gen campaigns — reach users across YouTube, Discover, Gmail, Display, and Maps from a single campaign.Create Demand Gen campaigns withcreate_demandgen_campaign:- Multi-asset format — landscape, square, and portrait images with headlines and descriptions
- Video responsive format — YouTube videos with text overlays
- Automatic sitelink, callout, and structured snippet extensions
- Location and language targeting at the campaign level
- All bidding strategies supported: Maximize Clicks, Maximize Conversions, Target CPA, Target ROAS
Audience Targeting
- In-market and affinity audience segments via
search_audiences - Reuse existing audiences from Google Ads UI
- Per-ad-group audience customization
Meta Ads Fixes
- Fixed lead form handling for OUTCOME_LEADS and OUTCOME_ENGAGEMENT campaigns
- Fixed Meta page and Instagram account lookup for business accounts
- Wasted spend analysis now respects learning phase and minimum spend thresholds
PMax Search Themes & Audience Signals
Added 7 new tools for managing search themes and audience signals on Google Ads Performance Max campaigns. These PMax-only features give you direct control over how Google’s automation targets search queries and audience segments.New Tools
| Tool | Type | Description |
|---|---|---|
add_pmax_search_themes | Write | Add search themes to guide PMax targeting (max 50 per asset group) |
get_pmax_search_themes | Read | View current search themes on a PMax campaign |
remove_pmax_search_themes | Write | Remove specific search themes |
add_pmax_audience_signal | Write | Add audience signal combining in-market, affinity, custom audiences, and user lists |
get_pmax_audience_signals | Read | View current audience signals |
remove_pmax_audience_signal | Write | Remove an audience signal |
search_audiences | Read | Search for audiences by keyword across all Google Ads audience types |
Search Themes
Short phrases (max 50 per asset group) that tell Google which search queries your PMax campaign should target. They supplement Google’s automated targeting with explicit intent signals. Supports add and remove operations — to update, remove and re-add.Audience Signals
Tell Google which audience segments are most likely to convert. Combine multiple segment types in a single signal:- In-market audiences — users actively researching products in a category
- Affinity audiences — users with sustained interests and habits
- Custom audiences — account-level custom audience segments
- User lists — first-party data (website visitors, customer lists, CRM uploads)
Agent Skills Updated
The Ad Campaign Management skill and Performance Marketing Agent now include search themes and audience signals in the PMax campaign creation workflow (steps 9-10). The agent will automatically recommend search themes based on keyword research and suggest relevant audience segments.Bug Fixes
- Fixed GAQL query syntax for asset group signals (
campaign.idinstead ofasset_group.campaign.id) - Fixed audience search returning zero results (replaced case-sensitive GAQL LIKE with client-side filtering +
taxonomy_typeenum) - Added
user_list_idssupport for remarketing lists in audience signals - Increased max search themes from 25 to 50 (Google’s actual limit)
API Key Authentication (Personal Access Tokens)
Adspirer now supports Personal Access Tokens for headless and remote server authentication. Generate API keys from the dashboard and use them on remote servers, Docker containers, and CI/CD pipelines where browser-based OAuth isn’t available.What’s New
- API Key Management UI — Generate, name, and revoke API keys from adspirer.ai/keys
- OpenClaw
--tokenflag —openclaw adspirer login --token sk_live_...for headless authentication ADSPIRER_API_KEYenv var — Set the environment variable for zero-config server authentication- Tier-based key limits — Free: 2 keys, Plus: 5, Pro: 10, Max: 20
- Key expiration — Optional expiration (30 days, 90 days, 1 year, or never)
- Admin controls — Admin dashboard for API key analytics, per-user key management, and emergency revocation
- Auth method tracking — Tool call logs now track whether each call used OAuth or an API key
Security
- Keys use
sk_live_prefix for easy identification - SHA-256 hashed storage — raw tokens never stored server-side
- Instant revocation with audit trail
- Keys cannot be used to create other keys (prevents privilege escalation)
Documentation
- OpenClaw Remote Server Setup — Step-by-step guide
- Security — API Key Authentication — Security model and comparison
- Updated How MCP Works — Authentication section
- Updated FAQ — Remote server and API key questions
Claude Cowork Setup Guide
New documentation page with step-by-step visual guide for connecting Adspirer to Claude Cowork. Includes 9 annotated screenshots covering the full flow: plugin install from marketplace, connector setup, OAuth authentication, and brand folder workspace.Claude Connector Simplified
Claude Chat setup no longer requires manual OAuth configuration. Just paste the URL — Claude auto-discovers the server name and authentication settings.ChatGPT Setup Updated
ChatGPT setup updated to match current UI: new field names, OAuth advanced settings callout, “I understand and want to continue” checkbox, and the new Reference memories and chats preferences screen.LinkedIn Exhaustive Campaign Features
Extended LinkedIn campaign tools with exhaustive targeting and management capabilities. Fixed Googlelist_campaign_extensions returning incorrect data.Database Performance
Phase 1 database performance improvements for faster query execution across campaign metrics and user analytics.Documentation: Agent Pages & Support
Added 8 new documentation pages:- Claude Code Agent, Cursor Agent, Codex Agent, OpenClaw Agent — per-client agent architecture docs
- How It Works — 5-layer architecture page
- FAQ, Glossary, Support — knowledge base expansion
- Added Support tab to top navigation
Pricing V2
Updated pricing across all tiers:| Plan | Price | Tool Calls |
|---|---|---|
| Free | $0/mo | 15/month |
| Plus | $49/mo | 150/month |
| Pro | $99/mo | 600/month |
| Max | $199/mo | 3,000/month |
- Annual pricing option now available with savings
- Tool call counter resets to 0 on tier upgrade
- Fixed subscription cancellation on upgrade to prevent double-billing
- Stripe webhook handlers now sync quota correctly
MCC/Manager Account Warnings
Connections page now warns users attempting to connect MCC (Google) or Business Manager (Meta) accounts instead of individual ad accounts.OpenClaw Plugin Updates
openclaw adspirer uninstallCLI command added- OAuth retry logic improved
- Skill metadata updated with security section and privacy policy
Skill Reference & Performance Marketing Agent Docs
Added 2 new pages to the Agent Skills section:- Skill Reference — Complete reference for all 5 Adspirer skills with invocation commands per IDE (Claude Code, Cursor, Codex), step-by-step execution details, and example prompts
- Performance Marketing Agent — How the agent orchestrates skills with brand knowledge, strategy persistence, and memory across sessions
Strategy-Aware Execution
Skills now readSTRATEGY.md before executing — a persistent file where strategic decisions (AVOID, PREFER, CONSTRAINT, REQUIRE directives) survive across sessions:- Campaign creation loads strategy directives at Step 0 and flags conflicts with research results
- Keyword research cross-references results against AVOID/PREFER directives
- Performance review flags “Strategy Drift” when campaigns violate active directives
- Wasted spend prioritizes campaigns violating strategy as waste sources
Agent Documentation Highlights
- Mermaid architecture diagram showing Agent → Context + Strategy + Memory → Skills → Tools → Platforms
- IDE comparison table for agent features across Claude Code, Cursor, and Codex
- Brand Workspace setup flow and context file structure
- Cursor Rules and Codex Safety Rules explained with before/after examples
Asset Discovery & PMax Validation
- Fixed asset discovery across platforms
- YouTube logo upload support for PMax campaigns
- Mandatory extensions enforcement for Google Ads
- PMax logo validation improvements
CLI OAuth Fix
Resolved OAuth failures for CLI clients (Claude Code, Codex). Loopback redirect now correctly routes web vs CLI authentication flows.Cross-Domain Attribution
Added referrer-based UTM fallback for cross-domain tracking between adspirer.com and adspirer.ai.Help & Contact Page
Added in-app Help page with documentation link and contact options.YouTube Ads Campaign Support
Added YouTube Ads campaign creation to the Google Ads toolset. Create video ad campaigns targeting YouTube viewers with budget controls and audience targeting.Automation Tools
Launched 8 automation tools:- Scheduled briefs — automated performance summaries on a recurring schedule
- Performance monitors — alerts when campaigns cross KPI thresholds
- Cross-platform reports — unified reporting across Google, Meta, and LinkedIn
UI Redesign
Mobile dropdown and desktop tab redesign for the main app. Removed trial language from onboarding flow.Documentation Updates
- Enhanced Mintlify components: Frame, Badge, Check, Info, Tooltip across all pages
- Tabbed install methods for Claude Code setup
- Resend-style navbar redesign
- GA4 tracking added to docs site
- 6 new Knowledge Base articles, MCP explainer page, Mermaid workflow diagrams
- UTM tracking on all CTA links
Documentation Site Launch
Launched comprehensive documentation at adspirer.com/docs with 24 pages covering all AI clients, ad platforms, agent skills, and in-depth guides.- AI client guides for ChatGPT, Claude, Claude Code, Cursor, Codex, OpenClaw, and Windsurf
- Ad platform guides for Google Ads (39 tools), Meta Ads (20 tools), LinkedIn Ads (28 tools), and TikTok Ads (4 tools)
- Agent skills documentation with workflows, tool catalog, and safety rules
- 7 in-depth guides covering keyword research, automation, and strategy
- Auto-generated
llms.txt,llms-full.txt, andskill.mdfor AI agent discovery - Contextual sharing to ChatGPT, Claude, Cursor, and VS Code
ChatGPT MCP Connector
Added native MCP connector support for ChatGPT Plus and Pro users. Connect Adspirer directly in ChatGPT Settings with OAuth 2.1 authentication.Claude MCP Connector
Added native MCP connector for Claude Pro, Max, Team, and Enterprise. Includes progress streaming for real-time updates during campaign creation.Codex Agent Support
Added autonomous agent setup for OpenAI Codex with YAML configuration and skill files.OpenClaw Plugin
Released zero-configuration OpenClaw plugin with bundled 14.4KB skill file. Install withopenclaw plugins install openclaw-adspirer.ChatGPT MCP Connector Fix
Fixed dynamic client registration to correctly detect Claude vs ChatGPT during OAuth. Claude clients now receive the correct redirect URIs instead of ChatGPT credentials.OpenAI Apps SDK Integration
Added domain verification, OAuth protected resource endpoints, MCP annotations for tool hints, and OpenAI Platform redirect URI for app submission.LinkedIn Campaign Fixes
Fixed LinkedIn campaign creation and update workflows. Resolved API version errors.Conversion Tracking
Set up end-to-end conversion tracking infrastructure for measuring signup-to-paid funnel. Multiple fixes to Google Ads metrics accuracy.Onboarding Revamp
Redesigned onboarding flow with mobile-responsive screens, auto-completion logic, and MCP OAuth gating to prevent onboarding bypass.Enterprise Readiness
Account lifecycle management, metrics pause for inactive accounts, and sign-in/sign-up page revamp.Meta Ads Traffic Management
Added Meta video and carousel campaign creation, ad management workflows, and traffic management tools.GTM Cross-Domain Tracking
Added Google Tag Manager (GTM-PQGBFK5Q) to frontend. GA4 sessions now persist across domains via the_gl parameter.LinkedIn Ads Full Integration
Complete LinkedIn Ads integration across 8 phases:- LinkedIn account setup and OAuth
- Single image sponsored content campaigns
- Campaign performance analytics
- Unified tools for cross-platform management
Meta Video & Carousel Campaigns
Added video campaign creation and carousel ad support for Meta Ads.Local Currency Support
Fixed currency handling across all MCP tools and backend APIs. Campaigns now display metrics in the user’s local currency.Smart Metric Collection
Automated background metric collection for historical performance tracking.Asset Reuse & PMax Improvements
- Smart asset discovery and reuse for Performance Max campaigns
- Domain filtering for sitelinks
- Location targeting fix for MCP/ADK PMax campaigns
Account Tier System
Account tier infrastructure with 120-day metric backfill for new users. Accurate daily metrics viasegments.date in queries.ChatGPT Apps SDK Widgets
In-app quota widget and account management tools for ChatGPT users. OAuth improvements for API routes.Custom GPT Support
Added ChatGPT Actions support with OAuth compatibility for Custom GPT configurations.MCP Protocol Improvements
- Progress streaming (MCP 2025-03-26) for real-time updates during campaign creation
- False success message elimination
- OAuth token rotation on reconnect
- JWT expiry fix and performance routing improvements
TikTok Ads Integration
Complete TikTok Ads platform integration:- OAuth setup and multi-platform architecture
- In-feed video campaign creation
- Image upload and asset validation
- Session handling and location targeting
MCP Server Launch
Initial MCP server deployment atmcp.adspirer.com:- OAuth 2.1 with PKCE authentication
- Complete PMax campaign creation via ChatGPT
- Modular architecture for multi-platform support
Creative Canvas
Multi-image upload UX improvements and character limit enforcement for PMax campaigns.Adspirer Launch
Initial release with 100+ tools across Google Ads and Meta Ads.Google Ads (39 tools)
- Keyword research with real CPC data from Google Keyword Planner
- Search and Performance Max campaign creation
- Wasted spend analysis, budget optimization, and ad extensions
- Asset discovery, validation, and ad copy generation
Meta Ads (20 tools)
- Image, video, and carousel campaign creation
- Audience targeting and creative fatigue detection
- Placement optimization and performance analysis
Core Features
- OAuth 2.1 authentication with PKCE
- Multi-platform account management
- Agent skills system with SKILL.md instruction files