How to Use the Expensya MCP in OpenAI Agents SDK

Q: Can my OpenAI Agents SDK agent use Expensya for automated reporting?

Yes, it can call exportexpensedata to pull your reports into your pipeline. The agent handles the data transfer securely and keeps your records updated.

Sync your expense data directly into your OpenAI Agents SDK workflow. Stop manual entry and let your agents handle the heavy lifting.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Expensya MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate expense capture

Your agent uses `create_new_expense` to log receipts immediately. It pulls the necessary amount, currency, and category data to build a compliant record. This bypasses the usual manual form filling. Your agent validates the entry against your internal policies before pushing it to the system.

Filter and audit reports

Query your financial history using `list_expenses` to find specific records by date or status. This keeps your agent informed on the current state of your books. It works by scanning active reports and cross-referencing them with `list_expense_categories`. You get a clean view of spending without digging through spreadsheets.

Manage organizational data

The MCP Server grants your agent access to `list_expensya_users` and `list_payment_methods`. It knows who is spending and how they are paying. Your agent can now reconcile payments against specific company cards or cash accounts. It makes tracking mileage simple by calling `list_mileage_vehicles` for accurate logs.

Setup guide

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

Create your Agent

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

Run the agent

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

You just need to import the server configuration and pass it into your agent constructor. The SDK auto-discovers all tools once you set the server endpoint.

Yes, it can call `export_expense_data` to pull your reports into your pipeline. The agent handles the data transfer securely and keeps your records updated.

The SDK performs check-ins on tool inputs before execution. This ensures every `create_new_expense` call contains the required fields before it hits the API.

Vinkius manages your connection through an isolated sandbox. Your expense records and user profiles are only accessible via your specific authentication token.

The agent receives a standard error response immediately. You can catch these in your trace logs to see exactly why a specific call failed.

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