Farcaster MCP Server

by manimohans

Integrations

  • Allows to fetch casts (posts) from users and channels on the Farcaster network, search channels, and analyze content.

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"] } } }
  1. 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.

A
security – no known vulnerabilities
A
license - permissive license
A
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.

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

  1. Features
    1. Installation
      1. Usage
        1. Running the server
        2. Using with MCP Inspector
        3. Using with Claude for Desktop
        4. Using with Smithery
        5. Available Tools
      2. Smithery Configuration
        1. API Details
          1. Development
            1. License

              Related MCP Servers

              • 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
              • 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
                5,133
                334
                JavaScript
                MIT License
                • Apple
                • Linux
              • -
                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
              • 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
                • Apple

              View all related MCP servers

              ID: koo5epnlc7