Flagsmith MCP Server for Mastra AIGive Mastra AI instant access to 8 tools to Create Environment, Delete Segment Override, Get Environment Document, and more
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect Flagsmith through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The Flagsmith MCP Server for Mastra AI is a standout in the Developer Tools category — giving your AI agent 8 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
import { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"flagsmith": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "Flagsmith Agent",
instructions:
"You help users interact with Flagsmith " +
"using 8 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with Flagsmith?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Flagsmith MCP Server
Connect your Flagsmith account to any AI agent to control feature releases and remote configurations through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and Flagsmith tool infrastructure. Connect 8 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Flag Management — Retrieve default flag states and remote configuration values for any environment instantly.
- Identity Control — Fetch specific flags and traits for user identities or identify new users with custom traits to test personalized experiences.
- Environment Admin — Create new environments within projects and fetch full configuration documents for local evaluation modes.
- Dynamic Updates — Update flag values (single or batch) and manage segment overrides using the Admin API for rapid iteration.
- Local Evaluation — Access the entire environment configuration document for high-performance SDK integrations.
The Flagsmith MCP Server exposes 8 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 8 Flagsmith tools available for Mastra AI
When Mastra AI connects to Flagsmith through Vinkius, your AI agent gets direct access to every tool listed below — spanning feature-flags, remote-config, feature-toggles, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Create environment on Flagsmith
Requires FLAGSMITH_API_KEY. Create a new environment within a project
Delete segment override on Flagsmith
Requires FLAGSMITH_API_KEY. Delete a segment override
Get environment document on Flagsmith
Requires FLAGSMITH_ENVIRONMENT_KEY. Get the entire environment configuration document
Get environment flags on Flagsmith
Requires FLAGSMITH_ENVIRONMENT_KEY. Get all default flag states for an environment
Get identity flags on Flagsmith
Requires FLAGSMITH_ENVIRONMENT_KEY. Get flags and traits for a specific user identity
Identify user on Flagsmith
Requires FLAGSMITH_ENVIRONMENT_KEY. Identify user and set traits
Update flag v1 on Flagsmith
Requires FLAGSMITH_API_KEY. Update a flag value (Single change)
Update flag v2 on Flagsmith
Requires FLAGSMITH_API_KEY. Update flags (Batch change)
Connect Flagsmith to Mastra AI via MCP
Follow these steps to wire Flagsmith into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the Flagsmith MCP Server
Mastra AI provides unique advantages when paired with Flagsmith through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add Flagsmith without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every Flagsmith tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
Flagsmith + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the Flagsmith MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query Flagsmith, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed Flagsmith as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query Flagsmith on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using Flagsmith tools alongside other MCP servers
Example Prompts for Flagsmith in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with Flagsmith immediately.
"Get all default flag states for my current environment."
"Identify user 'user_99' and set their 'subscription' trait to 'premium'."
"Update the flag value for environment 'ser_key_123' to enable the 'maintenance_mode' feature."
Troubleshooting Flagsmith MCP Server with Mastra AI
Common issues when connecting Flagsmith to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpFlagsmith + Mastra AI FAQ
Common questions about integrating Flagsmith MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Coupa
10 toolsManage purchase orders, invoices, suppliers, and procurement workflows on Coupa — the enterprise procurement platform.

FastGPT
12 toolsManage FastGPT Knowledge Bases — automate dataset creation, document ingestion, and RAG search directly from any AI agent.

BoardEffect
10 toolsManage board activities via BoardEffect — list meetings, members, and documents directly from any AI agent.

Chargebee
10 toolsAutomate recurring billing via Chargebee — manage subscriptions, customers, invoices, and hosted checkouts natively with any AI agent.
