How to Use the Laravel Forge MCP in Pydantic AI

Q: How do I install the Laravel Forge MCP toolset in Pydantic AI?

Install pydantic-ai-slimmcp and use the unified MCPToolset class pointing to your Vinkius HTTP endpoint. Pass this toolset directly to your Agent constructor to expose the tools.

Q: Can I use Pydantic AI to monitor Laravel Forge worker queues?

Yes, your agent calls listworkers to inspect queue configurations. Because the response validates against strict Pydantic models, your agent safely parses the active worker states.

Type-safe Laravel Forge server management and deployments validated at runtime with Pydantic AI and our 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 Laravel Forge MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate Laravel Forge server data with Pydantic AI

The `get_server` tool returns detailed droplet configurations that Pydantic AI parses into strict Python models. If Forge returns unexpected fields, the runtime fails immediately, preventing corrupted data from entering your agent's decision loop. This strict validation applies to `list_servers` as well, ensuring your agent always operates on structured, verified server lists. You write type-safe code that handles infrastructure changes without silent failures.

Execute safe `deploy_site` runs with runtime checks

The `deploy_site` tool triggers site deployment scripts on your Forge servers. Pydantic AI wraps this action in type-safe tools, verifying that the server and site IDs match your strict schema before sending the payload. The agent checks the deployment status using `get_site` to confirm success. If the site status schema changes, Pydantic AI raises a validation error, halting the agent pipeline before it can make incorrect assumptions.

Audit active queues and databases via type-safe MCP tools

The `list_workers` tool retrieves active queue configurations for your Laravel sites. Pydantic AI validates the worker payload, allowing your agent to safely monitor queue health and restart failed workers. Your agent inspects database schemas using `list_databases` with the same level of validation. This ensures database names, hosts, and ports conform to your internal security schemas before any query runs.

Setup guide

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

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

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

Install `pydantic-ai-slim[mcp]` and use the unified `MCPToolset` class pointing to your Vinkius HTTP endpoint. Pass this toolset directly to your `Agent` constructor to expose the tools.

Pydantic AI raises a validation error immediately at runtime. This prevents your agent from acting on malformed server or database payloads, keeping your infrastructure management safe.

Yes, your agent calls `list_workers` to inspect queue configurations. Because the response validates against strict Pydantic models, your agent safely parses the active worker states.

Yes, the server handles asynchronous requests through the Vinkius SSE or HTTP transports. This allows your Pydantic AI agents to query multiple Forge servers concurrently.

The MCP Server processes your SSH keys and database configurations within an isolated V8 sandbox on Vinkius. Pydantic AI validates the data locally in your python runtime, ensuring credentials are never leaked or logged in plaintext.

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