How to Use the Unkey API Management MCP in Mastra AI

Q: What happens if an API key is compromised during a Mastra AI run?

You can use revokeapikey to permanently delete the key. This stops any further actions immediately, keeping your multi-step workflows secure from unauthorized access.

Q: Can I list all available APIs using Unkey API Management with Mastra AI?

Yes. The listapis tool gives you a complete inventory of every service exposed in the Unkey project, allowing your agent to choose the right connection for its task.

Q: Is updating an API key safe for long-running processes in Mastra AI?

Yes. The updateapikey tool allows you to refresh credentials without manual intervention, which is essential for ensuring the reliability of your automatic retries and complex workflows.

Build robust, failure-proof workflows using Unkey API Management with 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 Unkey API Management MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Revoke Keys During Failure

If a workflow detects suspicious activity, you can use `revoke_api_key` to instantly kill the credential. This is vital for maintaining system integrity during complex, multi-step processes. This capability lets your Mastra AI agent framework handle failures gracefully by cutting off compromised access immediately.

Audit Available APIs

Before a workflow runs, it needs to know what's available. Calling `list_apis` retrieves all Unkey project APIs, giving your Mastra AI agent the full scope of potential connections. If you need more detail on one service, `get_api_details` provides everything you need for the next step in the workflow.

Maintain Key Credential State

Need to retry a connection with fresh credentials? Use `update_api_key` to refresh existing tokens. The agent can then use `verify_api_key` to ensure the new key works before proceeding. This helps Mastra AI handle credential rotation automatically within its defined workflow engine.

Setup guide

Set up Unkey API Management 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 Unkey API Management 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: "unkey-api-management-mcp-client",
  servers: {
    "unkey-api-management-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Unkey API Management 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 Unkey. 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 Unkey API Management 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 Unkey API Management MCP in Mastra AI

It provides the necessary credentials lifecycle management. By accessing tools like `verify_api_key`, your Mastra AI agent can check credential validity before executing a critical workflow step.

You can use `revoke_api_key` to permanently delete the key. This stops any further actions immediately, keeping your multi-step workflows secure from unauthorized access.

Yes. The `list_apis` tool gives you a complete inventory of every service exposed in the Unkey project, allowing your agent to choose the right connection for its task.

It handles API keys and usage analytics. Its reliability is key when your Mastra AI workflows need to manage state, retry connections, or conditionally branch based on resource access.

Yes. The `update_api_key` tool allows you to refresh credentials without manual intervention, which is essential for ensuring the reliability of your automatic retries and complex workflows.

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