How to Use the Marketo MCP in Windsurf

Q: How do I connect the Marketo MCP Server to Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server config under the mcpServers key. Once you hit refresh in the Windsurf MCP panel, Cascade instantly discovers all 11 marketing tools.

Q: Can Windsurf Cascade chain Marketo getleadbyid and listactivities together?

Yes, Cascade reads the output of getleadbyid and automatically feeds that lead ID into listactivities to build a complete profile in one go. You only need to ask Cascade to fetch the history for a specific Marketo user.

Q: How does Windsurf handle Marketo rate limits during deep list audits?

Cascade paces its tool executions when running listleadsbylist across large static lists. If it hits an API limit, the agent pauses, reads the error headers, and resumes once the window resets.

Q: Can I use Windsurf to verify program IDs before running tests?

Yes, you can ask Cascade to run getprogrambyid to pull live metadata directly into your test suite. This ensures your integration tests run against actual Marketo programs instead of mocked data.

Q: How does Vinkius protect sensitive Marketo lead emails in Windsurf?

All lead emails queried via getleadbyemail route through a secure, zero-trust V8 Isolate Sandbox. Vinkius processes these requests in an ephemeral environment, ensuring no customer data is ever stored on disk.

Run multi-step marketing automation workflows autonomously in Windsurf using live Marketo data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Marketo MCP to Windsurf

Create your Vinkius account to connect Marketo 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 Marketo with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain lead qualification workflows with Windsurf Cascade

`get_lead_by_email` pulls the profile of a prospect directly into your Windsurf active session when you ask Cascade to check a lead. Cascade reads the returned JSON, grabs the lead ID, and immediately triggers `list_activities` to map out their entire touchpoint history without you writing a single line of glue code. This autonomous loop runs entirely within your Windsurf workspace while querying Marketo's API. Cascade handles the Marketo payload translation behind the scenes, letting you focus on writing the React components that consume this user history.

Map static lists to active campaigns via MCP Server tools

`list_leads_by_list` fetches target prospects from a specific Marketo static list so Windsurf can analyze who needs to be enrolled in your next nurture sequence. Cascade reads this cohort data, matches it against campaign structures retrieved via `list_campaigns`, and maps out the exact flow. You don't have to bounce back and forth between your Windsurf editor and the Marketo browser interface. Windsurf chains these Marketo tools sequentially to verify that your code targets the correct marketing segment before you deploy.

Audit smart campaigns directly inside your workspace

`list_smart_campaigns` lets your Windsurf agent inspect active automation logic to find broken triggers or outdated rules. Cascade uses `get_smart_campaign_by_id` to drill into specific Marketo assets, comparing the live API responses against your local configuration files. The Windsurf agent flags any mismatches between your local codebase and your live Marketo programs. You get a clear, step-by-step plan to fix the discrepancies, executed autonomously by Cascade using Marketo metadata.

Setup guide

Set up Marketo 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 Marketo 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 Marketo payment history." If connected, Cascade will call the Marketo tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "marketo-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 Marketo. 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 Marketo 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 Marketo MCP in Windsurf

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server config under the `mcpServers` key. Once you hit refresh in the Windsurf MCP panel, Cascade instantly discovers all 11 marketing tools.

Yes, Cascade reads the output of `get_lead_by_id` and automatically feeds that lead ID into `list_activities` to build a complete profile in one go. You only need to ask Cascade to fetch the history for a specific Marketo user.

Cascade paces its tool executions when running `list_leads_by_list` across large static lists. If it hits an API limit, the agent pauses, reads the error headers, and resumes once the window resets.

Yes, you can ask Cascade to run `get_program_by_id` to pull live metadata directly into your test suite. This ensures your integration tests run against actual Marketo programs instead of mocked data.

All lead emails queried via `get_lead_by_email` route through a secure, zero-trust V8 Isolate Sandbox. Vinkius processes these requests in an ephemeral environment, ensuring no customer data is ever stored on disk.

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