How to Use the Circle.so MCP in Mastra AI

Build resilient community workflows. Mastra AI connects to Circle.so to automate member tracking and event moderation with built-in retries.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Circle.so MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate community moderation workflows

Wrap your `list_community_posts` calls in exponential backoff logic so temporary API glitches never drop a task. Network timeouts kill standard automation scripts. If the initial fetch fails, the Mastra engine waits and tries again automatically. An agent can pull recent activity using `list_post_comments`, analyze the sentiment, and branch the workflow based on whether a discussion looks hostile. You build complex chains that actually survive production without constant manual intervention.

Sync directories across platforms

The `list_community_members` tool feeds directly into Mastra's state machine. Keeping your external CRM matching your community requires constant polling. Your agent pulls the latest roster, compares it against your database, and flags missing accounts. Configure `requireToolApproval` before the agent acts on the admin profile fetched by `get_my_circle_profile`. Add human oversight for sensitive operations. You maintain total control over what the workflow executes.

Circle.so MCP Server event tracking

Trigger `list_community_events` within a Mastra workflow to let the AI parse upcoming sessions. Managing schedules across different time zones breaks simple scripts. It handles the date math and formats the output for your notification systems. Combine this with `list_community_spaces` to target announcements accurately. The framework figures out exactly which sub-group needs to hear about an event and routes the data accordingly. The right members get the right alerts.

Setup guide

Set up Circle.so 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 Circle.so 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: "circleso-mcp-client",
  servers: {
    "circleso-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

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

Install @mastra/mcp and instantiate MCPClient with your Vinkius URL. Mastra auto-detects the Streamable HTTP transport and maps the community tools to your agent.

The framework handles backoff natively. If a request hits a rate limit, the workflow engine automatically pauses and tries again without writing custom loop logic.

Spread mcpClient.listTools() into your agent configuration. The AI can then sequence operations, like fetching spaces before querying specific posts within them.

You configure that per tool. Set requireToolApproval to true on administrative MCP actions to ensure a human reviews the plan before the agent executes it.

Every workflow executes in a zero-trust sandbox. The system fetches your discussion threads and comment text, passes them to your Mastra client, and wipes the container. Nothing persists on our infrastructure.

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