FCMCP Client

Access Farcaster directly from Claude Code using the Model Context Protocol (MCP).

Setup

Save this config as fcmcp.json:

{
  "mcpServers": {
    "fcmcp": {
      "command": "npx",
      "args": ["fcmcp-client"],
      "env": {
        "FCMCP_API_URL": "http://157.180.36.234",
        "FCMCP_API_KEY": "[DM @timdaub.eth on Farcaster for API key]"
      }
    }
  }
}

Run Claude:

claude --mcp-config fcmcp.json

Get API Access

To get your API key: DM @timdaub.eth on Farcaster

Examples

• "Look up vitalik.eth on Farcaster"
• "Search for casts about ethereum"
• "Check wallet balance for FID 5650"
• "Show me trending casts in the last 6 hours"
• "Find casts by dwr.eth from today"
• "What's trending in the /ethereum channel?"

Available Tools

• fetch-trending-casts - Get trending/viral content with time windows
• lookup-user-by-username - Find users and get their FID
• download-user-casts - Get all casts from a user
• search-casts-by-keyword - Search for specific content
• lookup-cast-by-hash - Get details of a specific cast
• fetch-user-wallets - Get verified wallet addresses
• fetch-user-balance - Check wallet balances
• fetch-user-followers - Get follower lists
• fetch-user-following - Get following lists
• generate-profile-link - Create Farcaster profile links
• generate-cast-link - Create direct cast links

Pro Tips

• Use min_score: 0.8 to filter for quality users (avoid spam)
• Trending casts support time windows: 1h, 6h, 12h, 24h, 7d, 30d
• Search supports literal, semantic, or hybrid modes
• All tools return direct farcaster.xyz links for easy sharing

Built by @timdaub.eth