How to Use the Givebutter MCP in LangChain

Q: How do I chain Givebutter donation lookups in LangChain?

You call listdonationtransactions via the MCP Server to fetch recent transactions, then feed those IDs directly into gettransactiondetails inside your chain. LangChain handles the output of the first tool as the input for the next, letting your agent build a complete profile of donor activity.

Q: Can my LangChain agent log offline checks to Givebutter?

Yes, your agent uses recordofflinedonation to write check details directly into your Givebutter campaign. You pass the donor name, amount, and campaign ID from your chain's inputs straight to this tool.

Q: How does the Givebutter MCP Server handle connection errors in LangChain?

You run verifyapiconnection as the initial node in your LangGraph or LangChain sequence. If the API key is invalid, the run halts before wasting tokens on subsequent tool calls.

Q: Can I monitor active fundraising goals with this setup?

Yes, your agent calls listfundraisingcampaigns and getcampaigndetails to read current progress. It pulls real-time goal targets and current amounts raised without manual report exports.

Run multi-step fundraising pipelines and track donor campaigns directly inside your LangChain agents.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Givebutter MCP to LangChain

Create your Vinkius account to connect Givebutter to LangChain 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 Givebutter with LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build chain-linked donation tracking in LangChain

`list_donation_transactions` pulls live donation records directly into your LangChain run, feeding transaction IDs straight to the next step of your chain. Your agent takes the raw transaction output, formats the details, and immediately hands it off to downstream tools without manual data entry. You get full visibility through LangSmith tracing to watch how your agent maps donor details. It checks `get_transaction_details` to verify specific amounts before triggering automated follow-up steps in your pipeline.

Automate offline donor entry via ReAct agents

`record_offline_donation` logs checks and cash directly into your Givebutter account via this MCP Server during live fundraising events. Your agent decides when to run this tool based on text files, emails, or chat inputs parsed earlier in the chain. The agent then calls `sync_donor_contact` to ensure the donor profile matches the new transaction. This eliminates manual copy-pasting between your event logs and your main donor database.

Verify API status before running bulk loops

`verify_api_connection` checks your Givebutter credentials at the start of any LangChain execution sequence. If the connection fails, the chain stops immediately, preventing wasted LLM tokens and API errors. Once verified, the agent safely runs loops across `list_fundraising_campaigns` to gather active campaign metrics. You avoid API timeouts by checking the connection before pulling heavy datasets.

Setup guide

Set up Givebutter 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 Givebutter 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({
    "givebutter-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 Givebutter 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 Givebutter. 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 Givebutter 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 Givebutter MCP in LangChain

You call `list_donation_transactions` via the MCP Server to fetch recent transactions, then feed those IDs directly into `get_transaction_details` inside your chain. LangChain handles the output of the first tool as the input for the next, letting your agent build a complete profile of donor activity.

Yes, your agent uses `record_offline_donation` to write check details directly into your Givebutter campaign. You pass the donor name, amount, and campaign ID from your chain's inputs straight to this tool.

You run `verify_api_connection` as the initial node in your LangGraph or LangChain sequence. If the API key is invalid, the run halts before wasting tokens on subsequent tool calls.

Yes, your agent calls `list_fundraising_campaigns` and `get_campaign_details` to read current progress. It pulls real-time goal targets and current amounts raised without manual report exports.

This MCP Server runs within a secure, zero-trust V8 sandbox that isolates your donor profiles and transaction metadata. Your Givebutter API token is never exposed to the LLM or stored on external servers, keeping sensitive contact details secure.

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