How to Use the Fortnite Cosmetics & Item Shop MCP in Pydantic AI

Q: What happens if the Fortnite Cosmetics & Item Shop API changes? Will my Pydantic AI agent break?

Your agent will raise a ValidationError on its next call, which is exactly what you want. This prevents silent failure and tells you immediately that your data model needs an update.

Q: What's the setup for Pydantic AI and this MCP server?

It's straightforward. After pip install, you just create an MCPToolset instance with the server's URL. Then you pass that toolset into your Pydantic AI agent.

Build type-safe Python agents with Pydantic AI to query the Fortnite shop. Get validated data, not runtime errors or corrupted JSON.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Fortnite Cosmetics & Item Shop MCP to Pydantic AI

Create your Vinkius account to connect Fortnite Cosmetics & Item Shop 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 Fortnite Cosmetics & Item Shop with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Get Correct Data, Guaranteed

Never trust an external API. Pydantic AI validates every response from this server against a Pydantic model. When your agent calls `get_combined_shop`, you know the data structure is exactly what you expect. If the upstream Fortnite API adds a field or renames something, your agent won't fail silently. It will raise a `ValidationError` immediately. This means you can fix the issue, not spend hours debugging corrupted data downstream.

Model-Agnostic Cosmetic Search

Use whatever LLM you want. Pydantic AI is model-agnostic, so you can plug in OpenAI, Anthropic, Gemini, or a local model. The tools from this MCP server just work. Your agent can use `search_cosmetics` to find an item by name or `get_cosmetic_details` to pull its full data. The logic is the same no matter which LLM is driving the agent, giving you the freedom to switch providers without rewriting your tool-using code.

Build a Reliable Pydantic AI Bot

Build a Discord or Twitter bot that never posts garbage. Have it call `get_item_shop` right at the 00:00 UTC reset. Because Pydantic AI validates the response, your bot can detect a malformed API reply and post an error message instead of a broken image. You can also build alerts for rare items. Use `search_cosmetics_by_rarity` to check if any 'OG' skins are in the shop. The type-safe response ensures your bot's logic for checking release dates or names won't break due to unexpected `null` values.

Setup guide

Set up Fortnite Cosmetics & Item Shop 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": {
        "fortnite-cosmetics-item-shop-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

result = await agent.run("List recent Fortnite Cosmetics & Item Shop 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 Fortnite-API. 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 Fortnite Cosmetics & Item Shop 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 Fortnite Cosmetics & Item Shop MCP in Pydantic AI

It forces every response from the server to be parsed by a Pydantic model. If the data doesn't match the expected schema, it raises a validation error instead of letting your agent use bad data.

Yes, Pydantic AI doesn't care which LLM you use. Just connect your local model, provide the `MCPToolset`, and your agent can start calling tools like `get_new_cosmetics`.

Your agent will raise a `ValidationError` on its next call, which is exactly what you want. This prevents silent failure and tells you immediately that your data model needs an update.

It's straightforward. After `pip install`, you just create an `MCPToolset` instance with the server's URL. Then you pass that toolset into your Pydantic AI agent.

Only the information needed to call a tool, like the name of a cosmetic for a search. This server is stateless and only handles public game data; Vinkius's security model ensures no personal data is ever exposed or stored.

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