How to Use the Adobe Analytics MCP in Windsurf

Q: How does Windsurf use the Adobe Analytics MCP Server to get reports?

Windsurf's Cascade agent uses the getreport tool. You give it a high-level goal, and it constructs the necessary JSON request to pull the exact Adobe Analytics report you need, often chaining it with listreportsuites first.

Set a goal in Windsurf and let Cascade pull Adobe Analytics reports, segments, and metrics for you. No more manual step-by-step.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Adobe Analytics MCP to Windsurf

Create your Vinkius account to connect Adobe Analytics to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Adobe Analytics with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Generate Full Reports Autonomously

The `get_report` tool lets Cascade pull a complete analytics report with a single prompt. Just tell Windsurf what you need to know about your users. Cascade plans the whole sequence. It can `list_report_suites` to find the right one, then `get_report` with a JSON request it builds itself. You get the final report without having to guide each step.

Audit Metrics and Dimensions in Windsurf

Use the `get_metrics` and `get_dimensions` tools to check what data is available in a report suite. This is perfect for auditing your analytics setup or just figuring out what's possible before you build a big query. Ask Windsurf's Cascade agent to list all available dimensions for your main site. It will call `get_dimensions` on the correct report suite and give you a clean list. No more digging through the Adobe UI.

Find and Analyze Audience Segments

The `list_segments` tool gives your agent a direct line into your defined audience segments. You can ask Windsurf to check if a specific segment exists or list all of them to find the one you need. This is way faster than clicking around. Tell Cascade to 'find all segments related to mobile users in the US' and it will run `list_segments` and filter the results for you. It's a simple, direct way to work with your audience data.

Setup guide

Set up Adobe Analytics MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Adobe Analytics MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Adobe Analytics payment history." If connected, Cascade will call the Adobe Analytics tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "adobe-analytics-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Adobe Analytics. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Adobe Analytics now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Adobe Analytics MCP in Windsurf

Windsurf's Cascade agent uses the `get_report` tool. You give it a high-level goal, and it constructs the necessary JSON request to pull the exact Adobe Analytics report you need, often chaining it with `list_report_suites` first.

Yes. Just ask Windsurf to list the metrics for a report suite. It will use the `get_metrics` tool from the connected MCP server to give you a complete list so you know what you can query.

Prompt Windsurf to find the segment by name or description. It uses the `list_segments` tool to search through all your available Adobe Analytics segments and gives you the ID you need for reporting.

Definitely. If you're not sure which report suite to use, tell Windsurf's Cascade agent what you're looking for. It will run `list_report_suites` via the MCP connection to get all the options and help you choose the right one.

Yes, your data is secure. The MCP Server only passes Adobe Analytics report data, segment lists, and metric/dimension metadata to Windsurf through an encrypted connection. Vinkius handles the auth token, and the execution environment is ephemeral, meaning no data is stored after your request is complete.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript