# Farcaster MCP Server
An MCP server that provides tools to interact with the Farcaster network ([farcaster.xyz](https://www.farcaster.xyz)), allowing AI models to fetch casts, search channels, and analyze content.
<a href="https://glama.ai/mcp/servers/koo5epnlc7">
<img width="380" height="200" src="https://glama.ai/mcp/servers/koo5epnlc7/badge" alt="Farcaster Server MCP server" />
</a>
## 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
```bash
# 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
```bash
npm start
```
### Using with MCP Inspector
```bash
npx @modelcontextprotocol/inspector node ./build/index.js
```
### Using with Claude for Desktop
1. Install [Claude for Desktop](https://claude.ai/download)
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:
```json
{
"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:
```bash
# 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
```bash
# Run in development mode
npm run dev
```
## License
MIT
