How to Use the MoonClerk MCP in OpenAI Agents SDK

Q: Can I pass MoonClerk payment data between different specialized agents?

Absolutely. When one agent fetches records using getpayment, it can pass the structured payload directly to a specialized accounting agent.

Let your OpenAI Agents SDK run guardrailed checks on MoonClerk checkout forms and customer payment histories in real time.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MoonClerk MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Secure MoonClerk MCP Server customer lookups

The `get_customer` tool pulls active subscriber profiles directly into your agent's MCP execution context. This allows your OpenAI Agents SDK pipeline to verify account status before executing automated support handoffs or updating internal CRM records. By feeding these raw MoonClerk profiles to specialized OpenAI agents, you avoid manual billing audit errors. The agent inspects the payload, flags delinquent accounts, and routes high-value users to human reps.

Automated payment reconciliation audits

The `list_payments` tool retrieves historical transaction logs for your billing agents to parse. When an agent runs inside the OpenAI Agents SDK, it matches these transaction records against your database to spot payment discrepancies automatically. You get clean JSON arrays from MoonClerk containing payment amounts, dates, and status codes. The OpenAI agent flags failed checkout payments instantly and triggers follow-up emails without human intervention.

Dynamic coupon and checkout form tracking

The `list_forms` tool exposes active checkout configurations to your OpenAI Agents SDK system. Your agent uses this tool alongside `list_coupons` to analyze which checkout pages have active discounts applied. Instead of hardcoding checkout URLs, the OpenAI agent dynamically selects the correct MoonClerk form for customer outreach. This ensures your OpenAI agents always share valid checkout links with active coupons.

Setup guide

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

Create your Agent

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

Run the agent

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

Install the package and pass the server URL to the MCPServerStreamableHttp constructor. Your openai-agents-sdk agent automatically discovers the 7 tools like `list_customers` during startup.

Yes. The openai-agents-sdk lets you validate tool inputs before the agent calls `get_payment` or `get_customer`. This keeps your billing data safe from rogue agent actions by routing them through an MCP gateway.

It uses the MCP protocol to fetch the tool definitions at runtime. Setting cacheToolsList to true ensures your agent doesn't waste time refetching the schemas for `list_forms` on every turn.

Absolutely. When one agent fetches records using `get_payment`, it can pass the structured payload directly to a specialized accounting agent.

No. The server runs inside an ephemeral V8 sandbox on Vinkius, meaning your customer details and payment records are processed in-memory and never written to disk. All credentials stay encrypted and isolated.

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