How to Use the Fuzzy String Distance Engine MCP in OpenAI Agents SDK

Build production agents with the OpenAI Agents SDK to clean up text and link records with deterministic string comparisons.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Fuzzy String Distance Engine MCP to OpenAI Agents SDK

Create your Vinkius account to connect Fuzzy String Distance Engine 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 Fuzzy String Distance Engine with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Calculate String Distance Locally

The `calculate_fuzzy_distance` tool gives your agent three ways to measure how similar two strings are: Levenshtein, Jaro-Winkler, and Dice's Coefficient. It's a fundamental operation for any kind of data cleanup or record linkage task. Because this MCP server tool runs locally, the calculation is fast and private. Your OpenAI agent calls the tool, the framework's guardrails can validate the inputs, and you get a score back without sending your data to another web service. It's simple, self-contained logic.

Deterministic Record Linkage

Use this to make an agent that can finally tackle that messy CSV file. The agent can iterate through rows, use `calculate_fuzzy_distance` to compare names or addresses, and decide if two records are a match based on the score. This isn't guesswork. The algorithms are deterministic. Every comparison your agent makes is logged in the OpenAI tracing dashboard, so you have a full audit trail. You can see the exact inputs and outputs, which makes debugging your agent's logic much easier.

Specialized Agents for Data Prep

Don't bloat one agent with a dozen jobs. The OpenAI Agents SDK is designed for handoffs between specialized agents. You can build a dedicated 'data janitor' agent whose only job is to clean up text using this MCP Server. This specialist agent takes messy data, uses `calculate_fuzzy_distance` to find duplicates or fix typos, and then passes the clean, structured data to another agent for analysis or reporting. It's a clean way to organize your agent's workflow.

Setup guide

Set up Fuzzy String Distance Engine 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 Fuzzy String Distance Engine tools at runtime.
3

Create your Agent

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

Run the agent

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

Just pass the MCP Server to your Agent constructor. It will auto-discover the `calculate_fuzzy_distance` tool. For name matching, call the tool with the 'Jaro-Winkler' algorithm, as it's designed for short strings like names.

For comparing longer documents, use Dice's Coefficient. It's better at finding similarity when text blocks are moved around. Levenshtein is a good general-purpose choice but can be slow on very long strings.

Yes. Every tool call made by an agent in the OpenAI Agents SDK is logged, including the parameters sent and the result received. You'll see the exact strings and algorithm used for every calculation.

Yes, it's designed for it. The calculations are performed by a lightweight, local process without external network calls. This makes it suitable for interactive agents that need to respond quickly.

Your text strings are processed within the ephemeral, sandboxed environment of this MCP server. Vinkius ensures the runtime is isolated and torn down after execution, and the data is only used for the calculation. Nothing is stored or logged beyond the agent's own trace.

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