What is Farcaster Mcp

Farcaster MCP is a server that provides tools for interacting with the Farcaster network, enabling AI models to fetch casts, search channels, and analyze content.

Use cases

Use cases include analyzing user-generated content on Farcaster, monitoring specific channels for trends, and integrating with AI models for enhanced data processing.

How to use

To use Farcaster MCP, clone the repository, install dependencies, build the project, and run the server. You can also integrate it with MCP Inspector or Claude for Desktop by configuring the respective applications.

Key features

Key features include retrieving casts from specific Farcaster users by FID or username, and fetching casts from specific channels.

Where to use

Farcaster MCP can be used in various fields such as AI research, content analysis, social media monitoring, and any application that requires interaction with the Farcaster network.

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

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.”

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