Skip to main content

MCP server for integrating Macrocosmos SN13 social media data into Claude Desktop and Cursor

Project description

🌌 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

macrocosmos_mcp-0.1.2.tar.gz (8.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

macrocosmos_mcp-0.1.2-py3-none-any.whl (9.1 kB view details)

Uploaded Python 3

File details

Details for the file macrocosmos_mcp-0.1.2.tar.gz.

File metadata

  • Download URL: macrocosmos_mcp-0.1.2.tar.gz
  • Upload date:
  • Size: 8.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.22

File hashes

Hashes for macrocosmos_mcp-0.1.2.tar.gz
Algorithm Hash digest
SHA256 903e625908aa1c6cefe458162ae9370a519c2ef6b6442d0a5b34c7da803d8d46
MD5 cce2e443297b44588004c03601ced628
BLAKE2b-256 fcef8f1de930d23b6baf5ee17beeb636eb5c2dfa434538d37663f449a1eca2fe

See more details on using hashes here.

File details

Details for the file macrocosmos_mcp-0.1.2-py3-none-any.whl.

File metadata

File hashes

Hashes for macrocosmos_mcp-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 ede71dedf6280e85c9051dfa89ebfa5270bf782eed0780f42608af89e109e110
MD5 65bfddffa09536372ea9344f083a4551
BLAKE2b-256 763657ef94d92292532a54041308fe21e4b721fac2abe4f70e192fbda2200548

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page