Warpcast

This Model Context Protocol (MCP) server enables Claude to interact with your Warpcast account by posting, reading, and managing casts and channels through Warpcast. It follows the FastMCP style server and exposes HTTP endpoints that Claude can access to perform common Warpcast actions from your conversations.

How to use

You connect an MCP client to this Warpcast MCP server to perform Warpcast actions directly from Claude. Once the server is running and configured, you can tell Claude to post casts, read recent casts, search by keywords or hashtags, browse and interact with channels, follow or unfollow channels, and view trending casts. Use natural language prompts like “Post a cast about tech” or “Show me trending casts on Warpcast.” The server handles authentication with Warpcast using an API token you provide and exposes a standard MCP interface for the client to call the available tools.

How to install

Prerequisites: you need Python 3.11 or newer and a runtime environment to run a small ASGI server.

1. Create a Python virtual environment.

python3 -m venv venv
source venv/bin/activate

2. Install dependencies, including the MCP Python SDK.

pip install -r requirements.txt

3. Provide Warpcast API token. You can either set it in your shell or provide it in your MCP client configuration.

export WARPCAST_API_TOKEN=YOUR_TOKEN

4. Start the server manually if you want to run it outside Claude. The app is created with an ASGI server so you can run it with uvicorn.

uvicorn main:app --reload

Configuration and notes

The server expects a Warpcast API token and exposes an MCP interface at a URL that Claude can reach. If you start the server manually, ensure the token is available as WARPCAST_API_TOKEN or via the environment you configure for Claude.

Example usage from Claude Desktop after configuring the server: use the Warpcast hammer icon to access Warpcast tools in chat, and issue prompts such as posting a cast, reading casts from a user, or following a channel.

Example configuration for Claude Desktop (HTTP MCP server)

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

Available tools

post-cast

Create a new Warpcast cast (post) with a maximum length of 320 characters.

get-user-casts

Retrieve recent casts from a specific Warpcast user.

search-casts

Search Warpcast casts by keyword or phrase.

get-trending-casts

Fetch currently trending Warpcast casts.

get-all-channels

List available Warpcast channels.

get-channel

Get information about a specific Warpcast channel.

get-channel-casts

Retrieve casts from a specific Warpcast channel.

follow-channel

Follow a Warpcast channel.

unfollow-channel

Unfollow a Warpcast channel.