README Documentation
🌌 Macrocosmos MCP
Official Macrocosmos Model Context Protocol (MCP) server that enables interaction with X, Reddit and Youtube, powered by Data Universe (SN13) on Bittensor. This server allows MCP clients like Claude Desktop, Cursor, Windsurf, OpenAI Agents and others to fetch real-time social media and video transcript data.
Quickstart with Claude Desktop
- Get your API key from Macrocosmos. There is a free tier with $5 of credits to start.
- Install
uv
(Python package manager), install withcurl -LsSf https://astral.sh/uv/install.sh | sh
or see theuv
repo for additional install methods. - Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:
{
"mcpServers": {
"macrocosmos": {
"command": "uvx",
"args": ["macrocosmos-mcp"],
"env": {
"MC_API": "<insert-your-api-key-here>"
}
}
}
}
Example usage
⚠️ Warning: Macrocosmos credits are needed to use these tools.
Try asking Claude:
- "What has the president of the U.S. been saying over the past week on X?"
- "Fetch me information about what people are posting on r/politics today."
- "Please analyze posts from @elonmusk for the last week."
- "Can you summarize the transcript of the latest video from WolfeyVGC?"
🔮 Upcoming
- 🧠 All the power of Subnets in your AI environment — coming soon.
MIT License Made with ❤️ by the Macrocosm OS team
Quick Actions
Key Features
Model Context Protocol
Secure Communication
Real-time Updates
Open Source