How to Use the BL.INK MCP in Pydantic AI

Q: How do I connect BL.INK to my Pydantic AI agent?

You instantiate the MCPToolset with your Vinkius endpoint. The framework automatically handles the connection and provides the tools for your agent.

Q: Can Pydantic AI handle large lists from BL.INK?

Yes, you can iterate through the results of listlinks while your Pydantic models validate each item. This allows for safe processing of large URL sets.

Get type-safe URL management in Pydantic AI. Use BL.INK tools with runtime validation to keep your agent data clean.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect BL.INK MCP to Pydantic AI

Create your Vinkius account to connect BL.INK to Pydantic AI 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 BL.INK with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-safe URL operations in Pydantic AI

Every response from `get_link` is validated against your Pydantic schemas. If the API returns malformed data, your agent catches it immediately. This prevents your agent from processing bad URLs. It forces your code to handle errors gracefully before they reach your production logic.

Verified link updates for Pydantic AI

Your agent executes `update_link` with strict type checking. It ensures all parameters match your requirements before sending the request to the BL.INK API. Use `list_tags` to fetch your current link categories. Your Pydantic models then confirm that the tags exist before your agent tries to apply them.

Reliable data retrieval for Pydantic AI

Your agent calls `get_account_info` to verify its session state. The result is checked against your expected account structure to prevent silent failures. This makes your agent predictable. If the server returns unexpected data, your agent stops and reports the validation error instead of hallucinating values.

Setup guide

Set up BL.INK MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "blink-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to BL.INK tools.",
)

result = await agent.run("List recent BL.INK transactions")
print(result.output)

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 BL.INK. 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 BL.INK 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 BL.INK MCP in Pydantic AI

Yes, every tool output is mapped to a Pydantic model. If the data structure deviates from your schema, the agent raises a validation error immediately.

You instantiate the `MCPToolset` with your Vinkius endpoint. The framework automatically handles the connection and provides the tools for your agent.

Because we use strict type-safe models, you avoid silent corruption. The server is hosted on Vinkius with ephemeral, zero-trust security.

Yes, you can iterate through the results of `list_links` while your Pydantic models validate each item. This allows for safe processing of large URL sets.

Your link data is validated strictly at the schema level. We keep your credentials and account information siloed and encrypted during the entire lifecycle.

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