How to Use the All Digital Rewards MCP in Pydantic AI

Add type-safe access to All Digital Rewards in any Python agent with Pydantic AI. Get validated data structures for every API call, guaranteed.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect All Digital Rewards MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Interact with Participants Safely

This server provides tools to manage your program's users, like `create_participant` and `get_participant_details`. When you use them with Pydantic AI, the response is automatically parsed and validated against a Pydantic model. If All Digital Rewards ever changes its API response for `get_participant_details`, your code won't silently fail or process bad data. Pydantic AI will raise a `ValidationError` immediately. You'll know exactly what went wrong and where.

Award Points with Confidence using Pydantic AI

The `issue_points` tool lets your agent grant rewards, while `list_reward_products` fetches your catalog. Pydantic AI ensures the data you get back matches the structure you expect. This means no more defensive coding or manual JSON parsing. You can trust that the data from the `get_product_details` tool is a clean, validated object from this MCP server. It makes your agent's logic simpler and way more reliable.

Track Order Status with Zero Guesswork

Use the `list_orders` and `get_order_details` tools to give your agent visibility into reward redemptions. You can also inspect campaign rules with `get_program_details`. With Pydantic AI, you're not just calling an endpoint; you're getting back a guaranteed data structure. This is critical for building reliable systems that manage real-world rewards. No more worrying about missing keys or wrong data types from the API.

Setup guide

Set up All Digital Rewards 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": {
        "all-digital-rewards-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

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

Pydantic AI automatically fetches the OpenAPI schema from the MCP server. It uses this schema to generate Pydantic models on the fly for validating both the data you send and the responses you get back.

Yes. Pydantic AI is model-agnostic. You can use the All Digital Rewards tools with OpenAI, Anthropic, Gemini, or any local model that you configure as the backend LLM.

Data integrity. Pydantic AI's runtime validation guarantees that the data your agent gets from the All Digital Rewards API is always correct and well-structured. If the API returns something unexpected, your agent fails loudly instead of corrupting data.

It's straightforward. You install the library, then instantiate the `MCPToolset` with your Vinkius server URL. Pass that toolset into your `Agent`, and you're ready to go.

Your connection to the Vinkius-hosted MCP server is secure and authenticated. Pydantic AI interacts with this endpoint, but the data itself—like order details and participant info—is processed within a temporary, sandboxed environment for each request. Vinkius isolates your session completely.

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