Metadata-Version: 2.4
Name: macrocosmos-mcp
Version: 0.1.1
Summary: MCP server for integrating Macrocosmos SN13 social media data into Claude Desktop and Cursor
Author: Macrocosmos AI
License: MIT
Project-URL: Homepage, https://github.com/macrocosm-os/macrocosmos-mcp
Project-URL: Repository, https://github.com/macrocosm-os/macrocosmos-mcp
Keywords: mcp,claude,cursor,api,social-data,huggingface
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: <3.13,>=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp[cli]
Requires-Dist: httpx
Requires-Dist: macrocosmos
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: pytest-asyncio; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"


# 🌌 Macrocosmos MCP

<p align="center">
  Official Macrocosmos <a href="https://github.com/modelcontextprotocol">Model Context Protocol (MCP)</a> server that enables interaction with powerful Text to Speech and audio processing APIs. This server allows MCP clients like <a href="https://www.anthropic.com/claude">Claude Desktop</a>, <a href="https://www.cursor.so">Cursor</a>, <a href="https://codeium.com/windsurf">Windsurf</a>, <a href="https://github.com/openai/openai-agents-python">OpenAI Agents</a> and others to generate speech, clone voices, transcribe audio, and more.
</p>

---

## Quickstart with Claude Desktop

1. Get your API key from [Macrocosmos](https://app.macrocosmos.ai/account?tab=api-keys). 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](https://github.com/astral-sh/uv) 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
