JUHE API Marketplace
macrocosm-os avatar
MCP Server

macrocosmos-mcp

A Python-based MCP server that provides access to X (Twitter), Reddit, and Hugging Face data through the SN13 and SN1 APIs.

15
GitHub Stars
8/18/2025
Last Updated
No Configuration
Please check the documentation below.

README Documentation

🌌 Macrocosmos MCP

Macrocosmos MCP lets you integrate SN13 and SN1 APIs directly into Claude for Desktop or Cursor. Instantly tap into social data, perform live web searches, and explore Hugging Face models — all from within your AI environment.


⚡ Features

  • 🔍 Query X (Twitter) and Reddit data on demand
  • 📚 Explore SN13 Hugging Face repositories and datasets

🚀 Quick Setup

1. Clone the Repo

git clone https://github.com/macrocosm-os/macrocosmos-mcp.git
cd macrocosmos-mcp/src

2. Install Requirements (requires uv)

uv venv
source .venv/bin/activate
uv add "mcp[cli]" httpx macrocosmos

3. Configure Claude or Cursor

Open the MCP config file:

  • Claude: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Cursor: ~/Library/Application Support/Cursor/cursor_mcp_config.json

Add this entry:

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

Replace /full_path_to_repo/ with your full local path and insert your API keys.


🔮 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