How to Use the Sharpei MCP in OpenAI Agents SDK

Q: Can Sharpei list all applications when using the OpenAI Agents SDK?

Yep. The listapplications tool lets your agent get a full roster of every application linked to the store, which is useful for auditing purposes.

Q: What happens if I use Sharpei with the OpenAI Agents SDK and need document details?

You can call getdocument or listdocuments. The agent retrieves specific documents associated with a given application, keeping your data handling process clean.

Q: Are there any limitations when using Sharpei and the OpenAI Agents SDK for webhooks?

The listwebhooks tool shows you all active hooks. This visibility helps prevent configuration errors that could stop payment updates from reaching your system.

Manage Shopify subscriptions and rentals. Built for OpenAI Agents SDK deployments.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Sharpei MCP to OpenAI Agents SDK

Create your Vinkius account to connect Sharpei to OpenAI Agents SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Sharpei with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Verify API Health

You can check the connection status using `check_sharpei_status`. If the endpoint reports a failure, your agent knows immediately that it needs to pause and alert an engineer. This prevents failed transactions down the line. Use `list_applications` to get a full rundown of every active application linked to the merchant store. It’s quick, clean, and gives you a clear inventory before running any complex tasks.

Handle Subscription Data

`get_subscription` pulls all necessary details for any given subscription ID. You'll get payment cycle information and customer billing records right away. This is crucial when your agent needs to confirm renewal timing. You can also list multiple plans with `list_subscriptions`. This gives you a bulk view, letting your team quickly identify which customers are on annual vs. monthly payments.

Manage Store Integrations

`create_application` sets up a new verification application for the store. Your agent can then use `get_application` to pull specific details about that setup. It’s the first step when onboarding a merchant. Don't forget `list_webhooks`. This tool lets you see all the webhooks currently active, ensuring your agent knows exactly where data is flowing within Shopify.

Setup guide

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

Create your Agent

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

Run the agent

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

The MCP Server handles the payment logic. Your OpenAI Agent calls tools like `get_subscription` to pull current billing details, and then uses that data to advise the user on next steps.

Yep. The `list_applications` tool lets your agent get a full roster of every application linked to the store, which is useful for auditing purposes.

You can call `get_document` or `list_documents`. The agent retrieves specific documents associated with a given application, keeping your data handling process clean.

The `list_webhooks` tool shows you all active hooks. This visibility helps prevent configuration errors that could stop payment updates from reaching your system.

This MCP Server primarily handles application documents. You can use `get_document` to pull details on any stored document type associated with a customer's account.

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