How to Use the GUIDEcx MCP in Pydantic AI

Build type-safe onboarding workflows in Pydantic AI using runtime-validated GUIDEcx tools.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GUIDEcx MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate your GUIDEcx MCP Server actions at runtime

Silent data corruption breaks your customer onboarding pipeline before you even notice. By running this integration within Pydantic AI, every project created via `create_project` is validated against strict schemas before execution. If your agent tries to pass an invalid date format or a missing field, the framework halts the execution immediately. Reading project details works the same way. When your agent calls `get_project`, the returned data is parsed directly into Pydantic models, guaranteeing your application code never encounters unexpected null values or broken types.

Run bulletproof task updates with Pydantic AI

Automating task status changes requires high reliability when customers are watching. Your agent uses `list_tasks` to scan active milestones and prepares updates with complete structural confidence. When triggering `update_task`, the framework ensures the status payload matches your schema exactly. If you need to dive deeper, `get_task` retrieves specific task metadata. Because the response is validated at the application boundary, your downstream logic assumes all fields are present and correct.

Validate professional services logs automatically

Logging hours incorrectly ruins your professional services billing pipeline. Your agent uses `create_time_record` to write time logs that are guaranteed to fit your internal accounting schemas. By validating inputs before they reach the API, you avoid failed requests and broken records. To keep team assignments clean, the agent queries `list_project_users` and `list_users` to verify user directories. This ensures that only active, authorized team members are assigned to client-facing tasks.

Setup guide

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

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

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

Install the package with the MCP extra enabled, then instantiate the unified toolset class with your Vinkius HTTP endpoint. Pass this toolset directly to your agent to auto-discover the available tools.

The framework will raise a validation error instantly instead of passing corrupt data to your agent. This prevents the model from hallucinating or executing actions based on broken API responses.

Yes, the toolset is model-agnostic. You can run your onboarding automation using local models or commercial APIs while maintaining the same type-safety guarantees.

The unified toolset class handles HTTP connections efficiently, making it ideal for production environments. This allows your agent to query tools like `list_projects` without managing complex local process lifecycles.

Your task updates, time logs, and project setups are isolated within Vinkius's ephemeral runtime environment. No customer data is stored on Vinkius servers, keeping your customer onboarding records fully compliant with enterprise standards.

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