How to Use the Smarty MCP in OpenAI Agents SDK

Q: How does Smarty help my OpenAI Agents SDK process US addresses?

Your OpenAI Agent calls the validateusaddress tool directly. The agent sends the required street address, and the tool returns the DPV status and coordinates immediately. This gives you confidence in your data before any action is taken.

Q: What happens if Smarty finds an international address using my OpenAI Agents SDK?

When your agent encounters a global address, it uses validateintladdress. You just need to provide the address line and country. The tool then validates and geocodes that specific international street address for you.

Q: What account details does Smarty expose to my OpenAI Agents SDK?

The agent uses getaccountinfo to retrieve specific Smarty account information. This lets your system check user permissions or billing status before running a major operation, keeping the workflow safe.

Get perfect location data into your production agents with the OpenAI Agents SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Smarty MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Validate US addresses instantly

The `validate_us_address` tool checks if a given US street address is valid and returns its Delivery Point Validation (DPV) status along with coordinates. This means your agent doesn't just guess; it confirms the exact delivery point. It also provides the necessary geometry data for mapping services, letting your OpenAI Agent build out location-aware features without needing a separate geo-service call.

Handle international addresses

Need to handle global inputs? The `validate_intl_address` tool requires the address line and country to validate and geocode an international street address. This makes sure your agent doesn't fail when processing foreign data. If you're building a multi-country system, this tool is essential for maintaining high data integrity across diverse global formats.

Clean raw text of addresses

Sometimes the address isn't in a clean field; it’s buried in an email or document. The `extract_addresses` function pulls physical addresses out of messy raw text, alongside emails and documents. Your agent gets exactly what it needs to proceed. This capability is crucial when integrating with unstructured data sources that don't guarantee address format.

Setup guide

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

Create your Agent

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

Run the agent

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

Your OpenAI Agent calls the `validate_us_address` tool directly. The agent sends the required street address, and the tool returns the DPV status and coordinates immediately. This gives you confidence in your data before any action is taken.

When your agent encounters a global address, it uses `validate_intl_address`. You just need to provide the address line and country. The tool then validates and geocodes that specific international street address for you.

Yeah, you can. If the address is mixed into a document or email body, the agent uses `extract_addresses`. This tool pulls out physical addresses from raw text, so your workflow doesn't stop because the data isn't formatted perfectly.

The agent uses `get_account_info` to retrieve specific Smarty account information. This lets your system check user permissions or billing status before running a major operation, keeping the workflow safe.

The core data type this MCP Server touches is physical address information (US and international formats). It handles validation and extraction across various text inputs, ensuring your agent deals with structured location intelligence.

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