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, 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

  1. Visit the Anthropic MCP Directory
  2. Find and connect to Adthena
  3. Complete OAuth authentication with your Adthena credentials
  4. Start a conversation: "What are my top competitors this month?"

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 19 tools available.

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.