How to Use the Toket MCP in Pydantic AI

Q: How do I verify the status of my minting transactions using Toket and Pydantic AI?

You use getmintstatus. Since your agent relies on type-safe data, any unexpected response from this tool will throw a clear validation error, letting you know exactly what went wrong.

Q: Can I list all NFT collections using the Toket MCP Server with my Pydantic AI setup?

Absolutely. You run listcollections, and because of Pydantic's validation, you can trust that every collection object returned has the expected fields and data types.

Q: What specific data types does the Toket MCP Server touch regarding gas status when using Pydantic AI?

The server provides Gas Tank balance. The getgastankstatus tool returns this metric, which your agent validates against a defined type before proceeding with any NFT action.

Ensure data correctness with Pydantic AI and the Toket MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Toket MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

List and Create NFT Collections via MCP Server

Your agent can list all available collections using `list_collections`. If you need to build a new line, use `create_collection` by providing the name, symbol, and owner wallet. Every response from this process validates against Pydantic models. This type-safety means if the API returns unexpected data for a collection detail (`get_collection`), your agent fails loudly with an error—no silent corruption.

Monitor NFT Lifecycle Statuses

The agent tracks every step of the process. It can use `list_mints` to pull an inventory or check a single mint's progress using `get_mint_status`. If you want to deploy a new asset, calling `easy_mint` handles the creation. If gas is low, the agent first checks the balance with `get_gas_tank_status` before attempting any transaction.

Handle Crypto Payments and Deployments

The server accepts crypto payments—Bitcoin, Ethereum, and stablecoins—through a checkout widget. Your agent uses this data to confirm sales. The `mint_nft` tool allows the agent to execute an NFT sale while ensuring all input parameters are correct. This whole setup gives you a reliable way to handle e-commerce transactions without worrying about malformed data fields.

Setup guide

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

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

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

You use `get_mint_status`. Since your agent relies on type-safe data, any unexpected response from this tool will throw a clear validation error, letting you know exactly what went wrong.

The server accepts Bitcoin, Ethereum, and major stablecoins. It processes these payments using a checkout widget that confirms payment data integrity at runtime.

Absolutely. You run `list_collections`, and because of Pydantic's validation, you can trust that every collection object returned has the expected fields and data types.

Yes. The connection change only affects the active session. Your previously listed collections or mint records remain untouched; you just need to re-authenticate your agent.

The server provides Gas Tank balance. The `get_gas_tank_status` tool returns this metric, which your agent validates against a defined type before proceeding with any NFT action.

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