Warpcast

A Model Context Protocol (MCP) server for Warpcast integration that allows you to use Claude to interact with your Warpcast account.
The implementation now follows theFastMCPstyle server from the MCP Python SDK.

Warpcast APIhttps://docs.farcaster.xyz/reference/warpcast/api

- "Post a cast about [topic]"
- "Read the latest casts from [username]"
- "Search for casts about [topic]"
- "Show me trending casts on Warpcast"
- "Show me popular channels on Warpcast"
- "Get casts from the [channel] channel"
- "Follow the [channel] channel for me"

This MCP server provides several tools that Claude can use:
- post-cast: Create a new post on Warpcast (max 320 characters)
- get-user-casts: Retrieve recent casts from a specific user
- search-casts: Search for casts by keyword or phrase
- get-trending-casts: Get 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

Claude Desktop normally launches this server for you when the Warpcast tools are configured. The steps below are only needed if you want to run the server manually for development.
-

Create a Python virtual environment (Python 3.11 or newer is recommended):

python3 -m venv venv source venv/bin/activate

Install dependencies (the requirements include the MCP Python SDK):

- Log in toWarpcastand openSettings > Developer.
- ClickCreate API Tokenand copy the value.
- AddWARPCAST_API_TOKENunder theenvsection of your Claude desktop configuration.
- If starting the server manually, you can instead export the token in your shell:

export WARPCAST_API_TOKEN=YOUR_TOKEN

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

Specifying aurltells Claude Desktop to communicate with the server over HTTP using Server-Sent Events instead of standard input and output. If you omiturl, Claude Desktop defaults to communicating via standard input and output (stdio), which will not work with this server.
- Save the file and restart Claude Desktop. You should now see a hammer icon in the chat input that lets you use the Warpcast tools.

Unit tests are written withpytestand use FastAPI'sTestClient(installed viafastapi[testclient]). Create a virtual environment, install dependencies and run the suite:

python3 -m venv venv source venv/bin/activate pip install -r requirements.txt make test # or simply pytest`

This server uses the official MCP Python SDK and is fully compatible with theModel Context Protocol. Clients can connect to the/mcp`endpoint provided by FastMCP and interact with the tools defined here.

This project is licensed under theMIT License.

An MCP server for Bluesky that provides tools to interact with the ATProtocol.