How to Use the GiveForms MCP in OpenAI Agents SDK

Q: Can the agent search for specific donors using GiveForms and OpenAI Agents SDK?

Yes, it can. The agent invokes finddonationsbyname or finddonationsbyemail depending on what the user asks, pulling matching donor records back to the context window in one turn.

Q: How do I list all donations with GiveForms?

The agent executes listalldonations to get the raw list. It can then parse the records or pass them to another specialized agent for processing.

Feed live donor data straight to your OpenAI Agents SDK pipelines without writing API glue code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GiveForms MCP to OpenAI Agents SDK

Create your Vinkius account to connect GiveForms to OpenAI Agents SDK 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 GiveForms with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Trace donor lookup tools in OpenAI Agents SDK

The `find_donations_by_email` and `find_donations_by_name` tools let your agents run targeted lookups on your fundraising database instantly. You don't need to write manual tool definitions. Just hand the agent the user's name or email and let it fetch the match. Because it plugs into this MCP Server, you get full tracing on the OpenAI dashboard. Watching the agent run `get_donation_details` lets you verify exactly what metadata came back during the execution loop.

Verify connections before executing actions

The `verify_api_connection` tool lets your production agents establish connection safety guardrails before executing tasks. If credentials expire, the agent handles the handoff immediately. You won't have to worry about silent failures breaking your production runs. Handling failures gracefully is built right into the SDK flow. Your python code can catch any connection drops before the agent attempts to pull donor details.

Aggregate campaign performance data

The `list_campaign_donations` and `list_recent_donations` tools pull live metrics without custom API scripts. Your agent can isolate specific fundraising pushes or monitor incoming funds in real-time. Instead of guessing, the agent acts on actual data returned by `get_organization_info`. Clean, structured outputs feed directly into your custom reporting runs.

Setup guide

Set up GiveForms 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 GiveForms tools at runtime.
3

Create your Agent

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

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate GiveForms 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="GiveForms Agent",
            instructions="You have access to GiveForms 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 GiveForms. 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 GiveForms 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 GiveForms MCP in OpenAI Agents SDK

Install the SDK first. Register the server using the streamable HTTP client pointing to your Vinkius endpoint, then pass it to your Agent constructor to discover the eight tools automatically.

Yes, it can. The agent invokes `find_donations_by_name` or `find_donations_by_email` depending on what the user asks, pulling matching donor records back to the context window in one turn.

Yes, you can configure the MCP tool cache flag to prevent extra network hops on startup. This makes agent initialization significantly faster.

The agent executes `list_all_donations` to get the raw list. It can then parse the records or pass them to another specialized agent for processing.

Your donor email addresses, names, and transaction amounts never touch third-party servers. All requests go through Vinkius's isolated MCP runtime directly to the API, ensuring no storage of sensitive donor financial details.

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