How to Use the Salsa Engage MCP in LangChain

Q: How does a LangChain agent use Salsa Engage to find top donors?

Your agent creates a chain. It calls listsupporters with sorting parameters for donation amounts, then uses that list to call listsupportergroups to see which segments they're already in.

Q: Can I create new supporter groups in Salsa Engage using LangChain?

Yes. Your agent calls upsertsupportergroup with the new group's name and criteria. You can make this part of a larger chain that first analyzes supporters before deciding what new group is needed.

Q: How do I check if my Salsa Engage integration with LangChain is working?

The simplest way is to have your agent call checkapihealth. A successful response confirms the connection and authentication are good to go.

Q: What's the main benefit of using this over a direct API script?

LangChain agents decide which tools to use and in what order. You give it a goal, like 'segment high-value donors,' and it builds the chain from tools like listsupporters and assignsupporterstogroup on its own.

Build custom supporter management chains for Salsa Engage with LangChain. Turn multi-step donor tasks into single-prompt automations.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Salsa Engage MCP to LangChain

Create your Vinkius account to connect Salsa Engage to LangChain — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Salsa Engage with LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain Supporter Segmentation

Start by defining a process. Your LangChain agent can first `list_supporters` based on donation history, then use that output to automatically `assign_supporters_to_group`. It's a direct pipeline from data to action. You build the logic, the agent executes the steps. Chain `list_supporter_segments` with `upsert_supporter_group` to refine audiences without manual work. Each tool call is just one link in your custom chain.

Automate Performance Reporting

This isn't just about pulling data; it's about processing it. Create a chain that runs `get_engagement_metrics` for a specific campaign, formats the results, and then decides if a follow-up action is needed. The agent can reason over the data. If engagement is low, it could trigger another chain to check for new activities with `list_engagement_activities`. You're building a system that doesn't just report numbers, it reacts to them.

Build Workflows with this LangChain MCP Server

Your agent can manage the entire supporter lifecycle. It can `upsert_supporter_profile` for a new donor, add them to a welcome series with `assign_supporters_to_group`, and then track their journey. Because LangChain connects to other systems, you can pull data from an external source, use it to update a record via `upsert_supporter_profile`, and then log the result somewhere else. This MCP server becomes a key part of a much larger process.

Setup guide

Set up Salsa Engage MCP in LangChain

Prerequisites

Python 3.10+ installed
langchain-mcp-adapters + langgraph packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChain BaseTool objects.
2

Connect via HTTP transport
Use MultiServerMCPClient with "transport": "http" pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create a ReAct agent
Pass the discovered tools to create_react_agent() from LangGraph. The agent automatically routes Salsa Engage tool calls through the MCP protocol.
4

Run with any LLM
Swap ChatOpenAI for ChatAnthropic, ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.

agent.py

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

async with MultiServerMCPClient({
    "salsa-engage-mcp": {
        "transport": "http",
        "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    }
}) as client:
    tools = client.get_tools()

    agent = create_react_agent(
        ChatOpenAI(model="gpt-4o"),
        tools,
    )
    result = await agent.ainvoke({
        "messages": "List recent Salsa Engage transactions"
    })
    print(result["messages"][-1].content)

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 Salsa Engage. 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 Salsa Engage 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 Salsa Engage MCP in LangChain

Your agent creates a chain. It calls `list_supporters` with sorting parameters for donation amounts, then uses that list to call `list_supporter_groups` to see which segments they're already in.

Yes. Your agent calls `upsert_supporter_group` with the new group's name and criteria. You can make this part of a larger chain that first analyzes supporters before deciding what new group is needed.

The simplest way is to have your agent call `check_api_health`. A successful response confirms the connection and authentication are good to go.

LangChain agents decide *which* tools to use and in *what order*. You give it a goal, like 'segment high-value donors,' and it builds the chain from tools like `list_supporters` and `assign_supporters_to_group` on its own.

All data, including supporter profiles and donation records, is passed through Vinkius's ephemeral environment. Your Salsa Engage credentials and the data from `list_offline_donations` are encrypted in transit and never stored on our servers.

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