How to Use the Basin MCP in OpenAI Agents SDK

Q: Can the OpenAI agent delete Basin submissions?

Yes. The agent calls the deletesubmission tool when instructed. You should set up guardrails to require human approval before destructive actions happen.

Q: How does the Basin MCP Server handle webhook retries?

Agents use the refirewebhooks tool targeting a specific submission ID. This forces Basin to send the payload to your configured endpoints again.

Connect Basin to the OpenAI Agents SDK to manage form submissions and trigger webhooks inside production agent pipelines.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Basin MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Read Forms and Qualify Leads

The `list_forms` and `list_submissions` tools pull your Basin lead data directly into your agent's context. Your OpenAI agent can fetch the newest entry using `get_latest_submission` and evaluate the lead quality against your custom instructions. Because the OpenAI SDK supports strict guardrails, you can safely let the agent read incoming form data without worrying about it taking unapproved actions. It pulls the raw payload via `get_submission` and passes the structured data to your downstream sales agents.

Automate Spam Management

You manage junk entries using the `mark_as_spam` and `mark_as_not_spam` tools. Developers can configure an OpenAI agent to evaluate form payloads against a known blacklist and automatically flag the bad actors. Tracing in the OpenAI dashboard shows exactly why an agent flagged a specific record. If a false positive slips through, another agent can reverse the decision and recover the lead without manual intervention.

Trigger Webhooks via MCP Server

Triggering downstream systems via this MCP Server requires the `refire_webhooks` tool. Your agent spots a high-value submission, qualifies it, and pushes it to your CRM by manually firing the Basin webhook. Handoffs between specialized agents make this powerful. One agent reads the entry, a second agent scores the lead, and a third agent executes the `update_submission` or `delete_submission` command based on the final score.

Setup guide

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

Create your Agent

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

Run the agent

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

Install openai-agents via pip. Pass the Basin endpoint using MCPServerStreamableHttp into your agent's mcp_servers list.

Yes. The agent calls the delete_submission tool when instructed. You should set up guardrails to require human approval before destructive actions happen.

Agents use the refire_webhooks tool targeting a specific submission ID. This forces Basin to send the payload to your configured endpoints again.

The SDK catches the error during the tool execution phase. You can check the connection status anytime using the get_account_check tool.

Vinkius runs the Basin integration in an ephemeral V8 Isolate sandbox. Form payloads and PII only exist in memory during the request and disappear the second the connection drops.

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