Skip to main content

​
Get started

1

Create an account

Sign up at leverhq.app. You’ll get a secret key in your dashboard under Settings → API Keys — this is how your agent authenticates with Lever.
2

Connect your ad accounts

In your dashboard, click Connect Google Ads or Connect Meta Ads. You’ll be redirected to authorize Lever to manage your campaigns.You can connect one or both platforms. Lever works with whatever accounts you have.
3

Configure your agent

Add Lever to your AI agent’s configuration:
{
  "mcpServers": {
    "lever": {
      "url": "https://api.leverhq.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
See the full setup guide for your agent: Claude Desktop, Cursor, Claude Code, or ChatGPT.
4

Verify the connection

Ask your agent to list your connected accounts:
“What ad accounts do I have connected?”
Your agent will call the list_connections tool and return something like:
Connected accounts:

• Google Ads — Account ID: 123-456-7890
• Meta Ads — Account ID: act_987654321

You can use these account IDs with the platform tools,
or omit them if there's only one account per platform.

​
Try it

Once connected, try these prompts:
“Show me my Google Ads campaign performance for the last 7 days”
“What’s my total spend across all platforms this month?”
“Pause the campaign with the highest CPA”
Write operations go through draft-preview-confirm. Your agent will always show you a preview of changes before executing them. You have 5 minutes to confirm — after that, the draft expires automatically.

​
Next steps

Connect your agent

Detailed setup guide for your specific agent.

Tools reference

See all built-in actions and what they can do.

Troubleshooting

Common issues and how to fix them.