Warpcast

You run an MCP server that lets a Claude-powered client interact with your Warpcast account. This server exposes tools to post and read casts, search, browse channels, follow channels, and view trends, all through a standard MCP interface.

How to use

Connect to the Warpcast MCP server from your MCP client by configuring the Warpcast server entry and then issuing commands through Claude. You can post casts, read recent casts from a user, search casts by keywords or hashtags, explore channels, follow channels, unfollow channels, and fetch trending casts. Use natural language prompts like “Post a cast about topic” or “Show me trending casts on Warpcast” to trigger the corresponding tools.

How to install

Prerequisites: you need Python 3.11 or newer and an active Warpcast API token. You will also install project dependencies from a requirements file.

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Additional notes

Obtain your Warpcast API token by logging in to Warpcast, navigating to Settings > Developer, and creating an API Token. Save the token in your environment or in the MCP client configuration as WARPCAST_API_TOKEN. The server will validate this variable at startup and will return HTTP 500 for unauthorized requests if it is missing.

To run the server locally for development, start the HTTP server provided by FastMCP and mcp-warpcast-server using an ASGI server. The standard approach is to launch the application with an HTTP URL endpoint that Claude can reach.

Configuring Claude Desktop to talk to Warpcast MCP

Add an MCP server entry for Warpcast in your Claude Desktop configuration. You can run the server with a local HTTP endpoint or via stdio. The HTTP method lets Claude communicate over an event-based channel, while stdio uses direct input/output streams.

{
  "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"
      }
    }
  }
}

Additional startup example with stdio (alternative to HTTP)

If you prefer to use stdio communication, you can start the server with a direct command that Claude can invoke. The complete command is shown here as an explicit example.

uvicorn main:app --reload

Available tools

post-cast

Create a new post on Warpcast (maximum length 320 characters)

get-user-casts

Retrieve recent casts from a specific user

search-casts

Search for casts by keyword or phrase

get-trending-casts

Fetch the currently trending casts on Warpcast

get-all-channels

List available channels on Warpcast

get-channel

Get information about a specific channel

get-channel-casts

Get casts from a specific channel

follow-channel

Follow a channel

unfollow-channel

Unfollow a channel