# Farcaster MCP > Farcaster MCP lets you manage your entire decentralized social presence directly through your AI agent. Use this connector to list channels, moderate casts, block users, and explore the full social graph of Farcaster accounts without jumping between apps. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** farcaster, decentralized-social, web3, channel-management, moderation ## Description Manage your Farcaster account from your favorite AI client. This MCP gives your agent the power to act as a dedicated community manager or protocol explorer for your decentralized network. You don't have to switch tabs to moderate content or track social changes. Need to ban someone? Or perhaps you just want to see who follows a specific channel? Your AI handles it, using natural conversation. When paired with Vinkius, all these capabilities are available across Claude, Cursor, and any other MCP-compatible client. You can list all Farcaster channels or fetch details on user verifications, keeping your entire social workflow contained in one place. ## Tools ### ban_channel_user Removes a user's ability to participate in a specified channel. ### block_user Prevents the current account from seeing content or interacting with a target user. ### create_signed_key_request Initiates the process to create a cryptographically signed key request for security purposes. ### follow_channel Subscribes the current account to receive updates from an Farcaster channel. ### get_channel Retrieves all specific data points for a single, named Farcaster channel. ### get_current_fname_by_fid Looks up the current display name associated with a given Farcaster ID (FID). ### get_current_fname_owner Determines which user currently owns a specific display name. ### get_primary_address Retrieves the main wallet address linked to the current Farcaster account. ### get_signed_key_request Checks the status of a previously created signed key request. ### list_account_verifications Fetches all known account verification records for the connected user. ### list_all_channels Retrieves a comprehensive list of every available Farcaster channel. ### list_blocked_users Shows all users that the current account has blocked from interacting with it. ### list_channel_followers Provides a list of all accounts that follow a specific Farcaster channel. ### list_creator_rewards Displays the weekly top-earning creator rewards for the protocol. ### list_developer_rewards Shows the weekly top-earning developer rewards for the protocol. ### list_fname_transfers Retrieves a history of display name (FNAME) transfers, allowing filters by date or user ID. ### list_moderated_casts Lists specific moderation actions taken within a particular channel's history. ### list_user_following_channels Retrieves the list of channels that the current user account follows. ### moderate_cast Allows a moderator to hide or unhide specific content within a channel, requiring proper permissions. ### pin_cast Marks important content by pinning it to the top of a designated Farcaster channel. ### register_or_transfer_fname Registers or moves ownership of a display name (FNAME) using an EIP-712 signature from the user's wallet. ### unfollow_channel Removes the current account's subscription to notifications from a specific Farcaster channel. ## Prompt Examples **Prompt:** ``` List all available Farcaster channels. ``` **Response:** ``` I've retrieved the list of channels. Popular ones include 'warpcast', 'mcp', and 'base'. Would you like to see details for a specific one or see more channels? ``` **Prompt:** ``` Hide the cast with hash 0x123456... in the 'mcp' channel. ``` **Response:** ``` Executing moderation action... The cast 0x123456... has been successfully hidden in the 'mcp' channel. I've updated the moderation state. ``` **Prompt:** ``` Who are the followers of the 'farcaster' channel? ``` **Response:** ``` I'm fetching the followers for 'farcaster'... I found the most recent followers including FID 123, FID 456, and FID 789. Would you like to see the next page of followers? ``` ## Capabilities ### Moderate Content Hide or unhide specific casts, pin announcements to a channel, and ban users who violate community standards. ### Analyze Social Graph List all followers of any channel or check which channels an account is currently following. ### Manage Relationships Block other users, unfollow specific channels, or inspect a user's current social connections. ### Handle Identity Security Access primary wallet addresses and list account verification records associated with the Farcaster ID. ## Use Cases ### A moderator needs to clean up spam content quickly. The agent detects multiple inappropriate posts and is prompted: 'Hide the latest three casts in the #general channel.' The MCP uses `moderate_cast` on those specific hashes, keeping the community standard high without manual review. ### A developer needs to check user eligibility for a dApp. The agent queries the API using `list_account_verifications` and then checks the primary wallet address via `get_primary_address`. This confirms if the FID is properly set up before granting access. ### A power user wants to track a rival's network growth. The agent runs 'Who follows the official channel?' The MCP uses `list_channel_followers` and provides a list of FIDs, letting the user analyze their current reach. ## Benefits - You maintain community standards without logging into a dashboard. Need to ban spam accounts or hide disruptive content? Use the `moderate_cast` tool, and your agent handles the action instantly. - Stop guessing who's talking about you. The MCP lets you list followers of any channel using `list_channel_followers`, giving you a clean report on your audience size. - Managing user connections is simple. You can block users via `block_user` or unfollow channels with `unfollow_channel`, all through chat prompts, not UI clicks. - When security matters, the MCP provides `create_signed_key_request`. This allows you to manage and verify your account's primary addresses directly from your AI client. - You get a full view of network activity. Use `list_moderated_casts` to review moderation history in any channel, ensuring accountability across your community. ## How It Works The bottom line is that you talk to your AI client, and it handles the complex Farcaster API calls in the background. 1. Subscribe to this MCP on Vinkius, then provide your Farcaster Auth Token from Warpcast or your developer portal. 2. Connect this MCP to your preferred AI client (like Cursor or Claude). 3. Ask your agent to perform an action—for example, 'List all channels' or 'Ban FID 123 for spamming.' — and it executes the command. ## Frequently Asked Questions **How do I use the `list_all_channels` tool with Farcaster MCP?** You simply tell your agent to 'List all available Farcaster channels.' The MCP runs the function and returns a full list of every channel ID you can manage. **Does `moderate_cast` require moderator privileges?** Yes, it requires authentication and moderator privileges. You must ensure your connected account has the necessary permissions to hide or unhide content in a given channel. **What is the difference between `block_user` and `ban_channel_user`?** `Block_user` prevents you from seeing that user's content entirely. `Ban_channel_user` restricts their ability to participate only within a specific channel. **Can I check if an account has changed its name using Farcaster MCP?** Yes, you can compare names by running both `get_current_fname_by_fid` and then checking the transfer history via `list_fname_transfers` to track changes. **What information does `get_primary_address` provide?** It returns a user's primary wallet address. This data point is essential for verifying ownership of an account and linking it to other decentralized services. **How do I use the `list_channel_followers` tool?** This tool fetches the list of unique IDs (FIDs) that currently follow a channel. It lets you audit your community's reach and track growth patterns directly. **Can the `list_fname_transfers` tool show me name history?** Yes, it provides a full transfer history for an FNAME. You can filter by FID or timestamp to see exactly who moved which name and when they did it. **What is the function of `pin_cast` in moderation?** It pins a specific cast directly to the channel feed. This action keeps crucial announcements visible to everyone, even as new content gets posted. **Can I follow or unfollow Farcaster channels using this agent?** Yes! You can use the `follow_channel` and `unfollow_channel` tools. Simply provide the Channel ID, and the agent will update your social graph on the protocol immediately. **How do I moderate content within a channel I manage?** You can use the `moderate_cast` tool to hide or unhide specific casts by their hash. Additionally, you can use `pin_cast` to highlight content or `ban_channel_user` to restrict access for specific FIDs. **Is it possible to see who is following a specific channel?** Absolutely. Use the `list_channel_followers` tool with the target Channel ID. The agent will return a paginated list of users currently following that channel.