How to Use the LinkAce MCP in Pydantic AI

Build type-safe Pydantic AI workflows that validate LinkAce bookmark, tag, and collection updates at runtime.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect LinkAce MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-safe bookmark creation with Pydantic AI

The `create_new_bookmark` tool enforces strict validation schemas on every link your agent attempts to save. If your agent tries to write an invalid URL, the runtime catches the error immediately before hitting the LinkAce API. This strictness prevents silent failures in your production pipelines. By using this MCP Server, your Pydantic AI code guarantees that only properly structured data is passed to your LinkAce instance.

Validate tag and collection structures

The `list_all_tags` tool returns structured data that Pydantic AI validates against its internal models. Your agent can run `create_new_tag` knowing that the returned tag object matches your expected Python types. This model-agnostic approach means you can swap LLM providers without rewriting your bookmarking logic. The agent uses `list_all_collections` to verify that folder schemas are correct before attempting to file a link.

Safe search and retrieval workflows

The `search_bookmarks` tool lets your agent find links while ensuring the returned search results conform to strict data types. You can inspect specific entries using `get_bookmark_details` without worrying about unexpected null fields. To set this up, initialize the unified MCP Server toolset in your Python code with the Vinkius endpoint. Pass the toolset directly to your agent to allow safe, type-checked execution of all nine LinkAce tools.

Setup guide

Set up LinkAce 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": {
        "linkace-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

result = await agent.run("List recent LinkAce 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 LinkAce. 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 LinkAce 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 LinkAce MCP in Pydantic AI

Initialize the unified MCP toolset using your Vinkius HTTP URL. Pass this toolset instance directly into the toolsets parameter of your agent constructor.

The framework will raise a validation error at runtime. This prevents corrupt data from propagating through your agent pipeline when running tools like `list_all_bookmarks`.

Yes, Pydantic AI is model-agnostic. You can connect your local models to this MCP Server to manage your bookmark library privately.

This setup supports both Streamable HTTP and SSE transports. Ensure your external LinkAce MCP Server is running and accessible via the configured URL.

Your LinkAce credentials are encrypted in transit and at rest within the Vinkius network. The server only processes bookmark URLs during active tool execution, and logs are kept ephemeral to prevent data leaks.

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