Skip to content
Go to wickedreports.com
  • There are no suggestions because the search field is empty.

MCP Server setup for Claude and other AI tools

This document covers how to connect your Wicked Reports data to Claude, ChatGPT, or any other AI using our MCP server.

Connect Claude to your Wicked Reports data

Ask Claude about your attribution, ROAS, and customer journeys in plain English — it reads live from your Wicked Reports account. You sign in once with your Wicked Reports login. No API keys, no config files.

What is this?

The Wicked Reports MCP server connects Claude (and other AI tools that support the Model Context Protocol) directly to your Wicked Reports account. Once connected, you just ask questions — Claude pulls the numbers, walks the funnel, and explains what's happening, using the same attributed data you see in your dashboard.

What you can ask

"How healthy is my tracking right now?" — attribution & tracking status at a glance

"Show me ROAS and CAC by channel for last quarter." — FunnelVision performance, ranked

"Which campaigns drove the most new-customer revenue?"

"Any tracking errors on my Meta ads?"

"Give me a strategic Five Forces overview of my marketing."

Wicked Reports reports attributed marketing performance — it won't match Shopify/Meta/Google totals exactly, and that's expected. Claude will never return individual customer names, emails, or contact details.

You'll need:

  • A Wicked Reports account — you'll sign in with your normal login.
  • A Claude account on a plan that supports custom connectors (Pro, Max, Team, or Enterprise), or Claude Desktop / Claude Code.
Server URL

This is the only thing you paste. One URL covers every tool:

MCP URLhttps://mcp-api.wickedreports.com/mcp

Don't search for it. A custom connector never shows up in Claude's connector search or directory — pasting the URL into a search box won't find anything.

You add it manually with the + / Add custom connector button described below, and paste the URL there.1.Connect in Claude (web & desktop)

The exact path depends on your plan.

Pro & Max

Personal plans

  1. Open connector settings. Go to Settings → Connectors (in the sidebar this appears under Customize → Connectors).
  2. Add a custom connector. Click +, then choose Add custom connector.
  3. Paste the URL. Enter https://mcp-api.wickedreports.com/mcp and click Add. Leave Advanced settings (OAuth Client ID / Secret) empty — you don't need them.
Team & Enterprise

Organization plans

  1. An Owner adds it once. An org Owner goes to Settings → Connectors (Organization settings), clicks Add, hovers Custom → Web, pastes the URL and clicks Add.
  2. Everyone else enables it. Each member opens Settings → Connectors, finds the connector marked Custom, and clicks Connect.

Then sign in — once

  1. Sign in to Wicked Reports. A Wicked Reports login window opens in your browser. Log in with your normal Wicked Reports credentials.
  2. Approve access. Review the authorization screen and click Authorize. That's it — no key to copy.
  3. Start asking. The connector shows as connected. Open a new chat and ask about your data.
Your login is what grants access — Claude never sees a password or an API key. You can disconnect any time from the same Connectors screen.2.Connect in Claude Code (CLI)

Add the server as a remote HTTP connector; Claude Code walks you through the browser sign-in on first use:

# add the connector claude mcp add --transport http wicked-reports https://mcp-api.wickedreports.com/mcp  # then authorize in the browser # run /mcp inside Claude Code and pick "wicked-reports" to sign in3.Other MCP tools

Any MCP client that supports remote servers over OAuth can connect — for example Cursor, Claude Desktop, ChatGPT (custom connectors), OpenAI Codex, and VS Code. It's always the same flow: add https://mcp-api.wickedreports.com/mcp as a remote MCP server and complete the browser sign-in when prompted. You never need an API key or a client ID/secret — the connector registers itself and your Wicked Reports login grants access.

Working with multiple Wicked Reports clients

If your login has access to more than one Wicked Reports client (agencies, multiple brands), you don't reconnect to switch. Just tell Claude which one:

"Which Wicked Reports clients can I see?" — Claude lists them"Use Acme Storefront and show me this month's ROAS." — name the client in your question

If you don't name a client and you have more than one, Claude will ask which to use.

Verify the connection

Open a new chat and try:

"Give me an overview of my Wicked Reports account health."

If Claude returns tracking / attribution numbers, you're connected. The first data request in a chat may ask you to authorize — approve it and continue.

Troubleshooting

I pasted the URL in the search box and nothing came up

Custom connectors aren't searchable — the URL will never appear in Claude's connector search or directory. Use the + → Add custom connector button (Pro/Max) or Add → Custom → Web (Team/Enterprise) and paste the URL there. See step 1.

Claude says it needs to authorize again

Normal after a while — approve the sign-in window and your session refreshes. If it loops, remove the connector under Settings → Connectors and add it again.

"No data" for a request

If a tool comes back empty, check the client and date range in your question — if your login has more than one Wicked Reports client, name the one you mean (see Working with multiple Wicked Reports clients above).

Numbers don't match Shopify / Meta / Google

Expected. Wicked Reports shows attributed marketing performance, not raw platform or finance totals — it's answering "what actually drove revenue," which is a different question than a platform's own reporting.

Wicked Reports MCP · getting started · endpoint https://mcp-api.wickedreports.com/mcp