How to Use the Bluesky Social MCP in Mastra AI

Q: Can I require manual approval before Mastra AI follows someone on Bluesky Social?

Yes. You can configure requireToolApproval for specific tools like followuser or muteuser. The Mastra agent will pause execution and wait for your confirmation before modifying your social graph.

Q: How do I register the Bluesky Social MCP tools inside a Mastra AI agent?

Initialize the MCPClient with the Vinkius endpoint, call mcpClient.listTools(), and spread those tools directly into your Agent's tool configuration. The agent can then use tools like getprofile or searchprofiles dynamically.

Automate your Bluesky Social workflows with Mastra AI's resilient, multi-step agent pipelines.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Bluesky Social MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate moderation queues with Mastra AI.

Automating feed moderation is driven by the `list_notifications` tool to check for spam in your workflows. Build workflows that monitor and clean up your social feed. Mastra can run a continuous loop that calls `list_notifications` to check for spam, runs conditional logic to flag bad actors, and immediately executes `mute_user` to keep your feed clean. If the system flags an account by mistake, Mastra's workflow engine can trigger a manual review step. Once a human approves, the agent runs `unmute_user` to restore access, keeping your moderation pipeline safe and auditable.

Schedule and retry Bluesky Social posts.

Publishing resilient updates is managed by the `create_post` tool inside Mastra's workflow engine. Network hiccups shouldn't break your posting schedule. Mastra's built-in retry engine with exponential backoff ensures that when your agent calls `create_post`, the action completes even if the AT Protocol is temporarily rate-limiting requests. You can chain actions together. For example, your agent can run `get_profile` to check an account's metrics before deciding whether to follow them using `follow_user`, executing the entire decision tree autonomously.

Require approval before your MCP Server publishes updates.

Controlling automated updates is managed by the `create_post` tool combined with Mastra's human-in-the-loop approval. Keep control over what your agent says online. By enabling `requireToolApproval` on your Mastra client, any attempt by the agent to run `create_post` is paused until you click approve in your dashboard. This lets you use `list_popular_feeds` to find trending topics and draft replies automatically, while ensuring a human always has the final edit before anything goes live on the decentralized network.

Setup guide

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

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

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

Mastra AI has a built-in workflow engine that automatically handles retries with exponential backoff. If `create_post` fails due to AT Protocol rate limits, the agent will pause and retry the action without crashing your application.

Yes. You can configure `requireToolApproval` for specific tools like `follow_user` or `mute_user`. The Mastra agent will pause execution and wait for your confirmation before modifying your social graph.

Initialize the `MCPClient` with the Vinkius endpoint, call `mcpClient.listTools()`, and spread those tools directly into your Agent's tool configuration. The agent can then use tools like `get_profile` or `search_profiles` dynamically.

Yes. The Mastra client automatically detects the transport type, supporting both Streamable HTTP and SSE to communicate with the Vinkius sandbox, allowing you to poll `list_timeline` or notifications efficiently.

Your Bluesky Social session tokens and profile data are passed securely to the MCP Server running on Vinkius. They are passed securely through environment variables directly to the Vinkius V8 sandbox. No tokens are written to disk or logged.

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