Mcp Warpcast Server is an MCP server that connects Claude Desktop and other Model Context Protocol clients directly to the Warpcast decentralized social network. Built using the FastMCP framework from the MCP Python SDK, this tool enables developers, content creators, and decentralized social media managers to read and interact with the Farcaster ecosystem via natural language prompts. The server exposes tools to create casts up to 320 characters, browse public feeds, retrieve recent posts from specific users, and search across casts by keywords or hashtags. It also handles community exploration by listing available channels, fetching channel-specific discussions, and managing channel subscriptions through follow and unfollow actions. Because it runs via an ASGI server like Uvicorn over HTTP Server-Sent Events, users can query real-time trending casts and automate their social posting directly through their AI workspace without switching back and forth between a web browser and an LLM client.
Category: Communication & Messaging
Tags: decentralized-social, farcaster, social-media, warpcast
Follow these steps to set up Mcp Warpcast Server with Claude Desktop: 1. Clone the repository and set up a Python virtual environment: bash python3 -m venv venv source venv/bin/activate pip install -r requirements.txt 2. Obtain an API token by visiting Warpcast, navigating to Settings > Developer, and clicking Create API Token. 3. Open your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows). 4. Add the server entry under mcpServers: json { "mcpServers": { "warpcast": { "command": "uvicorn", "args": [ "--app-dir", "/ABSOLUTE/PATH/TO/mcp-warpcast-server", "main:app", "--port", "8000" ], "url": "http://localhost:8000/mcp", "env": { "WARPCAST_API_TOKEN": "YOUR_API_TOKEN" } } } } 5. Save the configuration and restart Claude Desktop.
Part of MCP Servers
Mcp Warpcast Server allows compatible MCP clients like Claude Desktop to interact with the Warpcast social network. It supports publishing new casts up to 320 characters, reading casts from specific users, searching casts by keyword or hashtag, fetching trending casts, listing channels, reading channel-specific feeds, and following or unfollowing channels.
Clone the repository, create a Python virtual environment, and install dependencies using pip install -r requirements.txt. Obtain an API token from Warpcast under Settings > Developer, then configure your Claude Desktop configuration file with the uvicorn launch command, absolute project path, HTTP URL, and your token in the environment variables.
Mcp Warpcast Server works with Claude Desktop and any client that supports the Model Context Protocol over HTTP and Server-Sent Events. It exposes a standard FastMCP endpoint and requires client configurations that allow specifying an HTTP URL instead of standard input and output.
Yes, Mcp Warpcast Server is open source and licensed under the MIT License. The code and issue tracker are publicly hosted on GitHub.