How to Use the CurseForge MCP in Mastra AI

Q: Can I require human approval before downloading CurseForge files in Mastra AI?

Yes, you can configure Mastra's requireToolApproval flag for the getmodfiledownloadurl tool. This pauses the agent workflow until a human clicks approve.

Q: How do I register the CurseForge MCP Server within a Mastra AI agent?

Instantiate the MCPClient with our endpoint URL, then spread the tools into your Mastra agent definition. The framework automatically discovers tools like searchmods.

Q: How does the fuzzy matching tool handle modified game files?

The getfingerprintsmatchesfuzzy tool compares local file hashes against known mod variations. It returns the closest match so your agent can identify altered files.

Build resilient CurseForge mod pipelines and automated update workflows using Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect CurseForge MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Resilient Mod Indexing with Mastra AI and CurseForge

The `get_mods_batch` tool retrieves details for multiple Minecraft or WoW mods in a single round-trip. Mastra AI uses this to build scheduled indexing workflows that check for new versions and categorize them automatically. If the CurseForge API drops a request, Mastra's built-in retry engine handles exponential backoff. Your sync pipeline keeps running without manual intervention or lost data.

Fuzzy Fingerprint Resolution for Broken Installs

The `get_fingerprints_matches_fuzzy` tool resolves corrupted or modified mod files against the official database. This gives your agent the power to identify broken game installations and suggest exact replacements. You can build a multi-step Mastra workflow that runs fuzzy matching, checks the compatible game version with `list_game_versions_v2`, and automatically fetches the clean file.

Targeted Game Version and Category Audits

The `list_categories` tool lists all available mod categories and classes for games like Minecraft or World of Warcraft. Your Mastra agent uses this taxonomy to clean up messy user inputs before running searches. By chaining this with `list_game_version_types`, the MCP Server validates that a mod actually fits the player's specific game build before triggering a download.

Setup guide

Set up CurseForge MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All CurseForge tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "curseforge-mcp-client",
  servers: {
    "curseforge-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "CurseForge Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to CurseForge tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent CurseForge transactions"
);
console.log(result.text);

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 CurseForge. 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 CurseForge 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 CurseForge MCP in Mastra AI

Mastra AI has native retry mechanisms that wrap around our MCP Server tools. If `get_mod_file` fails due to a network glitch, Mastra automatically retries with exponential backoff.

Yes, you can configure Mastra's `requireToolApproval` flag for the `get_mod_file_download_url` tool. This pauses the agent workflow until a human clicks approve.

Instantiate the `MCPClient` with our endpoint URL, then spread the tools into your Mastra agent definition. The framework automatically discovers tools like `search_mods`.

The `get_fingerprints_matches_fuzzy` tool compares local file hashes against known mod variations. It returns the closest match so your agent can identify altered files.

All search terms, game IDs, and mod IDs pass through an ephemeral, zero-trust V8 sandbox built for this MCP connection. We do not store your queries or tracking parameters.

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