Loading languages...
MA

macrocosmos-mcp

@macrocosm-os25

The MCP for macrocosmos subnets.

social data
web search
hugging face
claude integration
cursor integration

🌌 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

  1. Get your API key from Macrocosmos. There is a free tier with $5 of credits to start.
  2. Install uv (Python package manager), install with curl -LsSf https://astral.sh/uv/install.sh | sh or see the uv repo for additional install methods.
  3. 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

# mcpServer Config

{
  "mcpServers": {
    "macrocosmos": {
      "command": "uv",
      "args": [
        "--directory",
        "/full_path_to_repo/macrocosmos_mcp/src/",
        "run",
        "macrocosmos_mcp.py"
      ],
      "env": {
        "MC_API": ""
      }
    }
  }
}

# stdio

uv --directory /full_path_to_repo/macrocosmos_mcp/src/ run macrocosmos_mcp.py
Transport:
stdio
Language:
Python
Created: 4/11/2025
Updated: 1/17/2026