How to Use the Hookdeck (Webhook Gateway) MCP in Pydantic AI

Q: Can my agent modify webhook transformations using this MCP Server?

Yes. Your agent can call createtransformation or updatetransformation to inject custom JavaScript code for payload mapping. Every transformation schema is validated at runtime to ensure system compatibility using this MCP Server.

Run type-safe webhook management pipelines with Pydantic AI and runtime schema validation.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Hookdeck (Webhook Gateway) MCP to Pydantic AI

Create your Vinkius account to connect Hookdeck (Webhook Gateway) 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 Hookdeck (Webhook Gateway) with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate webhook routing with Pydantic AI

The `create_connection` tool requires strict parameter validation when provisioning new webhook routes. Because you are using Pydantic AI, every source and destination argument is verified against strict schemas before the API call is made. This prevents malformed routing configurations from reaching your gateway. If the agent attempts to pass an invalid URL, the framework catches the validation error instantly. This guarantees that your active connections always match your exact production specs using this MCP connection.

Retrieve raw event payloads with zero schema corruption

The `get_event_raw` tool fetches the exact body data of a processed webhook event. Your agent can inspect the raw payload to debug issues without worrying about silent data corruption. The runtime validation ensures that the returned JSON matches your expected type definitions. If a third-party service sends unexpected fields, your agent catches it immediately during the tool execution phase. You can then trigger `create_transformation` to normalize the payload before it hits your database.

Fail-safe bulk actions via MCP Server

The `bulk_retry_events` tool allows your agent to replay failed webhooks based on precise search queries. In a type-safe environment, your agent validates the query structure before sending the retry command. This prevents accidental bulk retries of the wrong event batches. You can monitor the progress of these retries with `get_bulk_retry_events`. If anything goes sideways, your agent can issue a `cancel_bulk_retry_events` command to stop the process instantly.

Setup guide

Set up Hookdeck (Webhook Gateway) 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": {
        "hookdeck-webhook-gateway-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

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

Use the MCPToolset class pointing to your hosted server URL. Pass this toolset into the Agent constructor. The MCP Server integration enforces runtime validation on every response.

The framework will raise a validation error immediately. This prevents your agent from operating on corrupt data or making decisions based on hallucinated fields, making it ideal for high-reliability webhook pipelines.

Yes. Your agent can call `create_transformation` or `update_transformation` to inject custom JavaScript code for payload mapping. Every transformation schema is validated at runtime to ensure system compatibility using this MCP Server.

This setup supports both Streamable HTTP and SSE transports. You just need to point the MCPToolset to the correct endpoint URL provided by your Vinkius dashboard.

The server processes raw request bodies and webhook metadata entirely in memory within a zero-trust MCP V8 isolate. No raw event data is cached or stored on the server filesystem, ensuring absolute isolation for your customer records.

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