Back to Catalog

macrocosmos-mcp

macrocosm-os/macrocosmos-mcp
🔗 Latest commit:fdaba8d
🕒 Updated:Sep 9, 2025, 01:06 PM
Python
AI Tools

The MCP for macrocosmos subnets.

MCP Trust Score
Based on our comprehensive evaluation criteria
🤖 Evaluated by gemini-2.5-flashFix
Trust Score53/100
GitHub Metrics
Repository statistics and activity
⭐ GitHub Stars:10
👥 Contributors:2
📋 Total Issues:0
📦 Has Releases:Yes
🔧 Has CI/CD Pipeline:No
Configuration
Configuration example extracted from README.md for Claude Desktop and other clients.
🤖 Evaluated by gemini-2.5-flashFix
{
  "macrocosmos-configured": {
    "command": "uv",
    "args": [
      "--directory",
      "/full_path_to_repo/macrocosmos_mcp/src/",
      "run",
      "macrocosmos_mcp.py"
    ],
    "env": {
      "MC_API": ""
    }
  }
}
MCP Protocol Support
Implemented MCP protocol features
🤖 Evaluated by gemini-2.5-flashFix
Tools:
Prompts:
Resources:
Sampling:
Roots:
Logging:
STDIO Transport:
HTTP Transport:
OAuth2 Auth:
Dependencies
3 dependencies
Libraries and frameworks used by this MCP server
🤖 Evaluated by gemini-2.5-flashFix
Add Quality Badge
Show your MCP trust score in your README
Trust Score Badge
[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/macrocosm-os/macrocosmos-mcp)](https://archestra.ai/mcp-catalog/macrocosm-os__macrocosmos-mcp)
README.md

🌌 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

macrocosmos-mcp MCP Server | Documentation & Integration | Archestra