How to Use the Salesforce Marketing Cloud MCP in OpenAI Agents SDK

Q: How do I connect the Salesforce Marketing Cloud MCP Server to my OpenAI Agents SDK pipeline?

Install the SDK, then initialize the server using MCPServerStreamableHttp pointing to your Vinkius endpoint. Pass this instance in the mcpservers list when creating your OpenAI Agents SDK Agent and set cacheToolsList=True to speed up tool discovery.

Q: Can an OpenAI Agents SDK pipeline add multiple leads to a campaign at once?

Yes, the agent executes this by calling sfaddcampaignmember sequentially for each Salesforce Marketing Cloud lead. It must provide either a lead ID or a contact ID for each call, returning the created membership record to confirm successful enrollment.

Q: How do I monitor Salesforce Marketing Cloud performance queries run by the agent?

Use sfcampaignperformance inside your OpenAI Agents SDK agent's execution loop. The OpenAI dashboard logs the exact inputs and outputs of this tool, showing you how the agent calculates cost-per-lead metrics.

Build and run production OpenAI Agents SDK pipelines directly against Salesforce Marketing Cloud using this MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Salesforce Marketing Cloud MCP to OpenAI Agents SDK

Create your Vinkius account to connect Salesforce Marketing Cloud to OpenAI Agents SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Salesforce Marketing Cloud with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Build Campaigns with OpenAI Agents SDK

`sf_create_campaign` lets your OpenAI Agents SDK pipelines build new marketing initiatives directly within your python runtime. Your agent spins up a Salesforce Marketing Cloud trade show or email blast by specifying the required name, type, and budgeted cost. Before execution, the OpenAI Agents SDK guardrails validate the campaign payload to prevent malformed API calls. The agent then runs `sf_search_campaigns` to verify the creation and pull back the unique Salesforce ID, ensuring your agentic workflow remains grounded in real-time CRM state without silent execution failures.

Track Member Enrollment via Guardrailed Agents

`sf_add_campaign_member` injects leads or contacts into active Salesforce Marketing Cloud campaigns for attribution tracking. The tool requires a campaign ID and either a contact ID or a lead ID, enforcing strict API constraints inside the OpenAI Agents SDK execution loop. Your OpenAI agent uses `sf_campaign_members` to inspect active Salesforce Marketing Cloud lists and verify membership statuses like Sent or Responded. The built-in OpenAI Agents SDK tracing shows exactly when the agent modified a membership, preventing runaway loop operations on high-value lead databases.

Query Performance Data Safely

`sf_campaign_performance` aggregates Salesforce Marketing Cloud campaign metrics including total leads, conversions, and costs grouped by campaign type. This tool provides your OpenAI agent with raw numbers to run budget allocation logic. By pairing this tool with `sf_campaigns_by_status`, the agent filters active or completed Salesforce Marketing Cloud campaigns to isolate low-performing channels. The OpenAI Agents SDK dashboard traces these analytical queries, giving you a clear audit trail of how the agent makes budget decisions.

Setup guide

Set up Salesforce Marketing Cloud MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Salesforce Marketing Cloud tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Salesforce Marketing Cloud tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Salesforce Marketing Cloud tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Salesforce Marketing Cloud Agent",
            instructions="You have access to Salesforce Marketing Cloud tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 Salesforce. 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 Salesforce Marketing Cloud 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 Salesforce Marketing Cloud MCP in OpenAI Agents SDK

Install the SDK, then initialize the server using `MCPServerStreamableHttp` pointing to your Vinkius endpoint. Pass this instance in the `mcp_servers` list when creating your OpenAI Agents SDK Agent and set `cacheToolsList=True` to speed up tool discovery.

Yes, the agent executes this by calling `sf_add_campaign_member` sequentially for each Salesforce Marketing Cloud lead. It must provide either a lead ID or a contact ID for each call, returning the created membership record to confirm successful enrollment.

The OpenAI Agents SDK built-in guardrails intercept the tool call before it hits the Salesforce Marketing Cloud API. If your agent attempts to pass an invalid type to `sf_create_campaign`, the execution halts immediately to keep your CRM data clean.

Use `sf_campaign_performance` inside your OpenAI Agents SDK agent's execution loop. The OpenAI dashboard logs the exact inputs and outputs of this tool, showing you how the agent calculates cost-per-lead metrics.

This MCP server only accesses campaign IDs, lead IDs, contact IDs, and financial budget data. Vinkius runs the server in an isolated V8 sandbox, meaning your credentials never persist on disk, and the OpenAI Agents SDK only receives the specific fields defined in the tool schemas.

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