mcp-warpcast

The Warpcast MCP Server enables Claude to interact with your Warpcast account using the MCP protocol. It exposes tools that let Claude post casts, read casts from Warpcast, search for casts by keywords or hashtags, browse and interact with channels, and manage follows. The server adheres to the FastMCP pattern, serving an /mcp endpoint and a warpcast-specific HTTP interface when run with an ASGI server. After starting the server, you can issue commands through Claude like: posting a new cast, retrieving a user’s recent casts, searching for casts by topic, listing trending casts, or following a channel. The included tools map to common Warpcast actions (post-cast, get-user-casts, search-casts, get-trending-casts, get-all-channels, get-channel, get-channel-casts, follow-channel, unfollow-channel).

Prerequisites:

• Python 3.11+ installed on your system
• Access to Warpcast API token (see setup steps)
• A shell with Python and pip available

Installation steps:

1. Create and activate a Python virtual environment: python3 -m venv venv source venv/bin/activate

2. Install dependencies (the requirements include the MCP Python SDK): pip install -r requirements.txt

3. Obtain a Warpcast API token:

   • Log in to Warpcast, go to Settings > Developer, create an API Token, and copy it.
   • Add WARPCAST_API_TOKEN to your environment or Claude configuration (see config snippet).

4. Run the server locally (development):

   • If using uvicorn directly, you can run: uvicorn main:app --reload
   • The exact app import path may vary; the repository exposes an ASGI app compatible with uvicorn.

5. (Optional) Integrate with Claude Desktop:

   • Ensure you have a Claude Desktop config that points to this server (see the README example).
   • Provide the WARPCAST_API_TOKEN in the env section of Claude's config.

Tips and notes:

• You must provide a Warpcast API token; without it, the server will log a warning and authorized requests may fail with HTTP 500.
• The server exposes an HTTP /mcp endpoint as part of the FastMCP integration; you can also run it behind an ASGI server (e.g., uvicorn) for development.
• When configuring Claude Desktop, including a url (http://localhost:8000/mcp) enables Server-Sent Events communication; omitting url defaults to stdio, which is not compatible with this server.
• If you encounter environment-variable issues, ensure WARPCAST_API_TOKEN is set in the running environment where the server starts.
• Unit tests are provided with pytest and can be run after installing dependencies.