CrowdTangle MCP Server for Mastra AI 10 tools — connect in under 2 minutes
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect CrowdTangle 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
Vinkius supports streamable HTTP and SSE.
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: {
"crowdtangle": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "CrowdTangle Agent",
instructions:
"You help users interact with CrowdTangle " +
"using 10 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with CrowdTangle?"
);
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 CrowdTangle MCP Server
Integrate CrowdTangle, the public insights tool from Meta, directly into your AI workflow. Monitor social media trends, track how links are being shared across platforms, and identify high-performing content using natural language.
Mastra's agent abstraction provides a clean separation between LLM logic and CrowdTangle tool infrastructure. Connect 10 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
- Post Monitoring — List and search for recent public posts on Facebook, Instagram, and other supported platforms.
- Viral Discovery — Identify overperforming and viral content based on actual vs. expected interaction.
- Link Tracking — See which public accounts and pages have shared specific URLs.
- Leaderboards & Lists — Monitor account leaderboards and manage your custom tracking lists.
The CrowdTangle MCP Server exposes 10 tools through the Vinkius. Connect it to Mastra AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect CrowdTangle to Mastra AI via MCP
Follow these steps to integrate the CrowdTangle MCP Server with Mastra AI.
Install dependencies
Run npm install @mastra/core @mastra/mcp @ai-sdk/openai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the agent
Save to agent.ts and run with npx tsx agent.ts
Explore tools
Mastra discovers 10 tools from CrowdTangle via MCP
Why Use Mastra AI with the CrowdTangle MCP Server
Mastra AI provides unique advantages when paired with CrowdTangle through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add CrowdTangle 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 CrowdTangle 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
CrowdTangle + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the CrowdTangle MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query CrowdTangle, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed CrowdTangle as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query CrowdTangle on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using CrowdTangle tools alongside other MCP servers
CrowdTangle MCP Tools for Mastra AI (10)
These 10 tools become available when you connect CrowdTangle to Mastra AI via MCP:
get_account_details
Touches dashboard settings, API rate limits, and workspace configuration boundaries. Retrieve metadata for your CrowdTangle account
get_account_leaderboard
Resolves account rankings, total interactions, and average engagement rates. Get engagement leaderboard for accounts in your lists
get_link_shares
Resolves which tracked accounts shared the link, their follower counts, and total interactions generated per share. See which accounts have shared a specific URL
get_post_details
Touches reaction breakdowns, share history, and platform-specific metadata boundaries. Get full engagement details for a specific post ID
get_top_performing_posts
Resolves "score" metrics (actual vs expected interactions) and associated social media metadata. Get the highest performing posts based on actual vs. expected interaction
list_media_posts
Resolves media URLs, content types (Photo, Video), and associated post captions. List recent posts that contain photos or videos
list_monitored_lists
Resolves list IDs, names, platform affiliations, and the number of accounts within each list. List all account lists you are tracking
list_recent_posts
Resolves post content, platform identifiers (Facebook, Instagram, etc.), account names, and engagement metrics (likes, shares, comments). List recent social media posts tracked by CrowdTangle
search_posts_by_keyword
Resolves relevant posts, associated accounts, and comparative performance data. Search for posts across platforms using a keyword
search_tracking_lists
Resolves list metadata matching the specified title filter. Search for specific tracking lists by title
Example Prompts for CrowdTangle in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with CrowdTangle immediately.
"Search for recent viral posts about 'Electric Vehicles' on Instagram."
"Who has shared the link 'https://vinkius.com/blog/mcp-server' recently?"
"Show me the engagement leaderboard for my 'Competitors' list."
Troubleshooting CrowdTangle MCP Server with Mastra AI
Common issues when connecting CrowdTangle to Mastra AI through the Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpCrowdTangle + Mastra AI FAQ
Common questions about integrating CrowdTangle 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?
Connect CrowdTangle with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect CrowdTangle to Mastra AI
Get your token, paste the configuration, and start using 10 tools in under 2 minutes. No API key management needed.