Troubleshooting Guide
Having issues with Ad Superpowers? Find solutions to common problems below.
Quick Checklist
Before diving into specific issues, verify these basics:
- Your Ad Superpowers account is active
- At least one platform is connected on the Integrations page
- Your AI assistant is properly configured with the server URL
- You've restarted your AI app after configuration changes
Common Issues
Tools not appearing in Claude?
- 1Make sure you've restarted Claude after adding the configuration
- 2Check that your API key is valid on the API Keys page in your dashboard
- 3Verify the JSON syntax in your config file is correct
- 4Look for the hammer icon in Claude - click it to see available tools
Getting "No accounts found" error?
- 1Make sure you've connected your platform on the Integrations page
- 2Your OAuth connection may have expired - try reconnecting
- 3Ensure your platform account has the necessary permissions
Platform shows "not connected"?
- 1OAuth tokens expire after some time - go to Integrations and reconnect
- 2Make sure you granted all required permissions during the OAuth flow
- 3Check that your platform account is still active and accessible
Connection issues?
- 1Check your internet connection
- 2Ad Superpowers may be temporarily unavailable - check status.adsuperpowers.ai
- 3Verify the server is reachable: https://mcp.adsuperpowers.ai/health
API rate limits or slow responses?
- 1Large accounts with many campaigns may take longer to load
- 2Try narrowing your date range or requesting specific campaigns
- 3Some platforms have API rate limits - wait a moment and try again
Data looks outdated or missing?
- 1Meta and Google can have reporting delays of 24-48 hours
- 2Check that the date range in your request is correct
- 3Some metrics require specific campaigns or ad sets to be running
Server Health Check
Verify Ad Superpowers is online by checking the health endpoint:
A healthy response will return {"status":"healthy"}
Common Error Messages
401 UnauthorizedYour API key is invalid or expired. Generate a new key from the API Keys page.
403 Platform not available on your planThe platform you're trying to access requires a higher plan. View pricing to see which platforms are included in each tier.
No accounts found for platformYou haven't connected this platform yet. Go to the Integrations page and connect your account via OAuth.
OAuth token expiredYour connection to the platform has expired. Reconnect from the Integrations page. This typically happens every 60-90 days.
Rate limit exceededYou've made too many requests. Wait a few minutes and try again. For high-volume use cases, consider the Team or Enterprise plan.
Platform-Specific Issues
Meta Ads
- Make sure you're an admin on the ad account(s) you want to access
- Business verification may be required for some permissions
- Reporting data may be delayed 24-48 hours
Google Ads
- Manager accounts (MCCs) must grant access to child accounts
- Ensure you have at least read access to the account
- Some metrics require active campaigns to be running
Google Analytics
- Only GA4 properties are supported (not Universal Analytics)
- Ensure you have Viewer access or higher
- Data processing may take 24-48 hours
LinkedIn Ads
- Account Manager or higher role required on the ad account
- Company page admin access may be required
Still having issues?
We're here to help. Reach out to our support team and we'll get you sorted.