Enables interaction with Warpcast (a Farcaster client), allowing for posting casts, reading casts from users, searching by keyword or hashtag, browsing and interacting with channels, following/unfollowing channels, and viewing trending content.
Warpcast MCP Server
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 the FastMCP style server from the MCP Python SDK.
Features
Post casts to your Warpcast account
Read casts from Warpcast
Search casts by keyword or hashtag
Browse and interact with channels
Follow/unfollow channels
Get trending casts
Warpcast API https://docs.farcaster.xyz/reference/warpcast/api
Usage
mcp-warpcast-server
is usually launched automatically by Claude Desktop's MCP client when the Warpcast tools are configured.
After the server starts you can ask Claude to:
"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"
Available Tools
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
Setup
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/activateInstall dependencies (the requirements include the MCP Python SDK):
pip install -r requirements.txtProvide a Warpcast API token:
Log in to Warpcast and open Settings > Developer.
Click Create API Token and copy the value.
Add
WARPCAST_API_TOKEN
under theenv
section 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
The server validates this variable on startup. If it is missing, a warning is logged and authorized requests will respond with HTTP 500 errors.
(Optional) Start the server manually: The
app
variable exported frommain.py
is created usingmcp.streamable_http_app()
so it can be served by any ASGI server.uvicorn main:app --reload
The server exposes HTTP endpoints matching the tools listed above and a standard /mcp
endpoint provided by FastMCP.
Using with Claude Desktop
Follow these steps to access the Warpcast tools from Claude's desktop application:
Start the server (or let Claude launch it) using the setup instructions above.
Open your Claude configuration file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Windows:
%APPDATA%\Claude\claude_desktop_config.json
Add the Warpcast server under the
mcpServers
key. Replace the path with the location of this repository:
Specifying a url
tells Claude Desktop to communicate with the server over HTTP using Server-Sent Events instead of standard input and output.
If you omit url
, 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.
Running Tests
Unit tests are written with pytest
and use FastAPI's TestClient
(installed via fastapi[testclient]
).
Create a virtual environment, install dependencies and run the suite:
The tests mock the Warpcast API layer so no network connection is required.
MCP Compatibility
This server uses the official MCP Python SDK and is fully compatible with the Model Context Protocol. Clients can connect to the /mcp
endpoint provided by FastMCP and interact with the tools defined here.
License
This project is licensed under the MIT License.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A Model Context Protocol server that allows Claude to interact with Warpcast accounts, enabling actions like posting casts, reading content, searching by keywords, and managing channel interactions through natural language.
Related Resources
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that enables Claude to interact with the ConnectWise Manage API to perform operations like retrieving, creating, updating, and deleting tickets, companies, contacts, and other entities.
- -securityFlicense-qualityA Model Context Protocol server that allows Claude to make API requests on your behalf, providing tools for testing various APIs including HTTP requests and OpenAI integrations without sharing your API keys in the chat.Last updated -
- -securityAlicense-qualityA Model Context Protocol server that enables Claude to interact directly with Contentful CMS, allowing the AI to fetch content types and entries from a Contentful space.Last updated -2MIT License
- -securityAlicense-qualityA Model Context Protocol server that enables Claude to interact with Mattermost instances, supporting post management, channel operations, user management, and reaction management.Last updated -21MIT License