Farcaster MCP Server

An MCP server that provides tools to interact with the Farcaster network (farcaster.xyz), allowing AI models to fetch casts, search channels, and analyze content.

Features

Get User Casts: Retrieve casts from a specific Farcaster user by FID
Get Username Casts: Retrieve casts from a specific Farcaster user by username
Get Channel Casts: Retrieve casts from a specific Farcaster channel

Installation

# Clone the repository
git clone https://github.com/manimohans/farcaster-mcp.git
cd farcaster-mcp

# Install dependencies
npm install

# Build the project
npm run build

Usage

Running the server

npm start

Using with MCP Inspector

npx @modelcontextprotocol/inspector node ./build/index.js

Using with Claude for Desktop

Install Claude for Desktop
Open your Claude for Desktop App configuration at:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the following configuration:

{
  "mcpServers": {
    "farcaster": {
      "command": "node",
      "args": ["/absolute/path/to/farcaster-mcp/build/index.js"]
    }
  }
}

Restart Claude for Desktop

Using with Smithery

This project includes Smithery configuration files for easy deployment:

# Install Smithery CLI
npm install -g @smithery/cli

# Deploy to Smithery (specify the client, e.g., claude, cline, windsurf, etc.)
npx @smithery/cli install @manimohans/farcaster-mcp --client claude

Available client options: claude, cline, windsurf, roo-cline, witsy, enconvo

Available Tools

get-user-casts

Retrieves casts from a specific Farcaster user by their FID (Farcaster ID).

Parameters:

fid: Farcaster user ID (number)
limit (optional): Maximum number of casts to return (default: 10)

Example query: "Show me the latest casts from FID 6846."

get-username-casts

Retrieves casts from a specific Farcaster user by their username.

Parameters:

username: Farcaster username (string)
limit (optional): Maximum number of casts to return (default: 10)

Example query: "Show me the latest casts from username 'mani'."

get-channel-casts

Retrieves casts from a specific Farcaster channel.

Parameters:

channel: Channel name or URL (string)
limit (optional): Maximum number of casts to return (default: 10)

Example query: "Show me the latest casts from the 'aichannel' channel."

Smithery Configuration

This repository includes the necessary configuration files for Smithery:

smithery.yaml: YAML configuration for Smithery deployment
smithery.json: JSON configuration for Smithery capabilities
Dockerfile: Container configuration for Smithery deployment

API Details

This implementation uses the Farcaster Hubble API to fetch data.

Development

# Run in development mode
npm run dev

License

MIT

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Provides tools to interact with the Farcaster network, allowing AI models to fetch casts, search channels, and analyze content.

Related Resources

Reddit Discussion about this server

Related MCP Servers

OpenRouter MCP Server
heltonteixeira
A
security
A
license
A
quality
Provides integration with OpenRouter.ai, allowing access to various AI models through a unified interface.
Last updated -
4
154
28
TypeScript
Apache 2.0
Tavily MCP Serverofficial
tavily-ai
A
security
A
license
A
quality
This server enables AI systems to integrate with Tavily's search and data extraction tools, providing real-time web information access and domain-specific searches.
Last updated -
2
6,005
403
JavaScript
MIT License
DeepClaude MCP Server
Way-To-AGI
-
security
F
license
-
quality
This server integrates DeepSeek and Claude AI models to provide enhanced AI responses, featuring a RESTful API, configurable parameters, and robust error handling.
Last updated -
13
TypeScript
Reddit MCP
GridfireAI
A
security
A
license
A
quality
A plug-and-play MCP server that enables AI assistants to browse, search, and read Reddit content through the PRAW library.
Last updated -
6
6
Python
MIT License

View all related MCP servers

Farcaster MCP Server