How to Use the GiveWP MCP in OpenAI Agents SDK

Q: Can OpenAI Agents SDK fetch specific donor histories?

Yes, use finddonorhistory to pull records for specific donors. The agent receives the result as a structured object, ready for your processing logic.

Q: Will GiveWP donation forms load correctly in my agent?

Use listdonationforms to enumerate everything on your site. The agent maps the metadata, allowing you to target specific forms for performance analysis.

Q: What happens if the GiveWP API connection drops?

The server provides verifyapiconnection to check your link. You should ping this before running heavy tasks to ensure your agent doesn't hang.

Build safe GiveWP donation pipelines with OpenAI Agents SDK. Validate actions before they hit your database.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GiveWP MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Real-time donor data access

Your agent pulls transaction history directly from your site using `find_donor_history` and `list_plugin_donors`. It handles the raw data without manual exports. Keep your donor records current while the SDK guardrails check every call. You get reliable data flow into your Python environment.

Automated donation performance monitoring

Connect your agent to `get_form_performance` or `get_plugin_stats` to track fundraising spikes. The agent reads these metrics to inform your next outreach move. Stop checking dashboards manually. Your agent alerts you when donation rates shift, using the server to parse site activity.

GiveWP MCP Server tool discovery

The SDK automatically maps all nine tools upon connection. You define the agent parameters and the tools appear as native functions. This MCP Server integration means less boilerplate code for you. The agent handles the handshake and execution flow, letting you focus on the logic.

Setup guide

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

Create your Agent

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

Run the agent

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

The server uses standard endpoint tokens. You pass these to the SDK, which then wraps every request in the required headers. Use the built-in guardrails to restrict which tools your agent can actually run.

Yes, use `find_donor_history` to pull records for specific donors. The agent receives the result as a structured object, ready for your processing logic.

Use `list_donation_forms` to enumerate everything on your site. The agent maps the metadata, allowing you to target specific forms for performance analysis.

The server provides `verify_api_connection` to check your link. You should ping this before running heavy tasks to ensure your agent doesn't hang.

Your donor data stays between your WordPress site and your agent. No third-party servers store your records, and the connection remains ephemeral.

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