Farcaster MCP Server

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
• Get User Profile: Get detailed profile information (bio, display name, pfp, etc.)
• Get Cast Reactions: Get likes and recasts for a specific cast
• List Channels: Browse and search Farcaster channels
• Get User Following: See who a user follows
• Get User Followers: See who follows a user

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

1. Install Claude for Desktop

2. Open your Claude for Desktop App configuration at:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Add the following configuration:

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

4. 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."

get-user-profile

Gets detailed profile information for a Farcaster user.

Parameters:

• fid (optional): Farcaster user ID (number)
• username (optional): Farcaster username (string)

Example query: "Get the profile for username 'dwr.eth'."

get-cast-reactions

Gets likes and recasts for a specific cast.

Parameters:

• fid: FID of the cast author (number)
• hash: Hash of the cast (string)
• type (optional): Type of reactions - "likes", "recasts", or "all" (default: "all")

Example query: "How many likes does cast 0x1cb62ca3... by FID 6846 have?"

list-channels

Lists Farcaster channels with optional search filtering.

Parameters:

• limit (optional): Maximum number of channels to return (default: 20)
• search (optional): Search term to filter channels by name or ID

Example query: "List the top 10 channels about AI."

get-user-following

Gets the list of users that a Farcaster user follows.

Parameters:

• fid: Farcaster user ID (number)
• limit (optional): Maximum number of results (default: 25)

Example query: "Who does FID 3 follow?"

get-user-followers

Gets the list of users who follow a Farcaster user.

Parameters:

• fid: Farcaster user ID (number)
• limit (optional): Maximum number of results (default: 25)

Example query: "Who follows FID 3?"

API Details

This implementation uses the Farcaster Hubble API to fetch data.

Development

# Run in development mode
npm run dev

License

MIT