Skip to content

Getting Started

Prerequisites

  • An active Adthena subscription with API access enabled
  • An MCP-compatible client (e.g., Claude.ai, Claude Desktop, Claude Code, ChatGPT, or any other MCP client)

If you're unsure whether API access is enabled on your account, contact your Adthena account manager.

Connect from Claude.ai or Claude Desktop

Add Adthena as a custom connector:

  1. Open Settings → Connectors in Claude.ai or Claude Desktop
  2. Click Add custom connector
  3. Name it Adthena and enter the server URL https://mcp.adthena.com/mcp
  4. Complete OAuth authentication with your Adthena credentials
  5. Start a conversation: "Who are my top competitors this month?"

On a Team or Enterprise plan?

On Team and Enterprise plans, an Owner or Primary Owner must add the connector at the organization level first, under Organization settings → Connectors, using the same server URL https://mcp.adthena.com/mcp. Until then, individual members won't see the option to add it — ask your organization admin to add it. On Free, Pro, and Max plans you can add it directly yourself.

Coming soon

Adthena will be listed in the Anthropic MCP Directory. Once published, you'll be able to connect in one click:

  1. Visit the Anthropic MCP Directory
  2. Find and connect to Adthena
  3. Complete OAuth authentication with your Adthena credentials

Until then, use the custom connector steps above.

Connect from Claude Code

claude mcp add --transport http adthena https://mcp.adthena.com/mcp

Run /mcp inside Claude Code to verify the connection — you should see 21 tools available.

Connect from ChatGPT

Adthena is listed in the ChatGPT Apps directory, so you can connect in one click:

  1. Open the Adthena app in ChatGPT
  2. Click Connect and complete OAuth authentication with your Adthena credentials
  3. Start a conversation and enable the Adthena app, then ask: "Who are my top competitors this month?"

You can also find it from inside ChatGPT: open Apps in the left-hand menu, search for Adthena, and connect it there.

Other MCP Clients

Any MCP client that supports Streamable HTTP transport and OAuth can connect directly:

  • Server URL: https://mcp.adthena.com/mcp
  • Transport: Streamable HTTP
  • Authentication: OAuth 2.0 (the server handles the flow automatically)

First Steps

Once connected, a good starting point is to discover your accounts:

"List my Adthena accounts"

Your agent will call list_accessible_accounts and show you the accounts you have access to, including their IDs, domains, and locations. Use the account ID in subsequent queries.

Then try:

"Show me my market share summary for the last 30 days"

"Who are my top 5 competitors by share of clicks?"

"Are there any search terms my competitors bid on that I'm missing?"

See Examples for more detailed walkthroughs.

Troubleshooting

Problem Solution
No accounts listed Your Adthena account may not have API access enabled. Contact your account manager.
Authentication fails Ensure you're using the email address associated with your Adthena account.
"Access denied" on a specific account You only see accounts linked to your user. Ask your admin to grant access.
Slow responses Large date ranges or unfiltered queries can take longer. Try narrowing the date range or adding filters.