adwell

Connect Claude or ChatGPT to Adwell

Ask an AI app about your Apple Search Ads in plain words: which keywords waste money, what changed this week, which search terms to add. It reads the same numbers as your Adwell dashboard, joined to subscription revenue per keyword. Changes it suggests still wait for a person to approve them in Adwell.

The server address is:

https://mcp.runadwell.com/mcp

It works with any app that supports remote MCP servers with sign-in (OAuth). You need an Adwell account in a workspace with an app.

Claude

  1. In Claude (web or desktop), open Settings → Connectors and choose Add custom connector.
  2. Name it Adwell and paste the address above. Leave the advanced settings empty.
  3. Choose Connect. Adwell opens: sign in, pick the workspace, and choose Allow.
  4. In a chat, turn on Adwell in the tools menu and ask a question.

On a Team or Enterprise plan, an owner adds the connector for the organisation first; then each person connects their own Adwell account.

Claude Code:

claude mcp add --transport http adwell https://mcp.runadwell.com/mcp

Then run /mcp in Claude Code and choose Adwell to sign in.

ChatGPT

  1. In ChatGPT, open Settings → Apps (or Connectors), go to the advanced settings and turn on Developer mode.
  2. Choose Create app, name it Adwell, paste the address above and choose OAuth for authentication.
  3. Sign in to Adwell when asked, pick the workspace and choose Allow.
  4. In a chat, add Adwell from the tools menu and ask a question.

Menu names change from time to time; look for "connectors", "apps" or "MCP".

What it can read

Tool What it gives
list_apps The workspace and its apps
get_overview Spend, installs, trials, paid subscribers, revenue and costs for 7, 28 or 90 days, with the period before and every day
get_spend_breakdown Daily spend for the top campaigns or keywords
list_keywords Keywords with spend, installs, paid, revenue, cost per paid and its range, bid and relevance; sort and filter
get_keyword One keyword in detail, with Adwell's open suggestions for it
list_search_terms Search terms that are not keywords yet
list_proposals Adwell's suggestions and the numbers behind them
list_apple_recommendations Apple's budget recommendations
list_changes Changes made through Adwell, and their outcome
get_settings Guardrails and your target cost per paid subscriber
get_measurement_health Whether the numbers can be trusted right now

Drafting changes

If you tick Also draft changes when you connect (admins and owners only), the app gets one more tool, draft_change: it can draft a pause or resume, a keyword bid, a campaign daily budget, or keywords and negatives to add. A draft lands in Changes marked "Drafted by" the app, with its reason, and waits for a person to approve or reject it. Guardrails are checked when it is drafted (a refusal says why and saves nothing) and again when you approve. Nothing changes in Apple Ads until a person approves.

Money is in your Apple Ads account's currency; revenue is in US dollars. Recent days are not settled: trials and paid conversions keep arriving for about a week.

In Claude, these ready-made prompts appear as slash commands: weekly review, wasted spend, growth ideas and build dashboard.

Try asking

  • "Which keywords spent the most last month without a paying subscriber?"
  • "Compare this week with last week and tell me what changed."
  • "Which search terms should I add as exact keywords?"
  • "Build me a dashboard of spend and paid subscribers for the last 28 days."
  • "Do you agree with Adwell's open suggestions?"

Permissions and safety

  • A connection is for one person in one workspace, and sees only what that person sees in the dashboard. Leaving the workspace ends it.
  • It cannot change your Apple Ads account or approve anything; at most it drafts changes, if you allowed that. It never sees end user identifiers or your team's email addresses.
  • You get an email when an app is connected to your account.
  • See and disconnect connections in the dashboard under Workspace → Connected apps. Admins can disconnect anyone's.
  • Each connection can make 60 requests a minute and 5,000 a day.
  • The data you ask about goes to the AI app's provider under its terms. See our Privacy Policy and Terms.

Trouble connecting

  • "Can't connect to Adwell": start again from the AI app; sign-in requests expire after 10 minutes.
  • It asks which app: your workspace has several; name the app in your question.
  • "Apple Ads is not connected": finish Setup in the dashboard first.

Questions: support@runadwell.com.