# Farcaster MCP for AI Agents AI Agent Connect > Farcaster (Decentralized Social Protocol) lets you manage your social presence on the Farcaster network through your AI agent. You can moderate channels, manage follows, and explore social graphs without switching apps. It handles everything from pinning content and banning users to tracking creator rewards and fname transfers. ## Overview - **Category:** communication-messaging - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_JsKrQhuw7BkQrzWQnKI36nfQK5jrGpwwtJfFWf7x/ai-agent-connect - **Tags:** farcaster, decentralized-social, web3, channel-management, moderation ## Description Managing a community on a decentralized protocol like Farcaster usually feels like a full-time job. You're constantly jumping between tabs, searching for spam, and manually pinning announcements while trying to keep up with a fast-moving feed. This Connector changes that by letting your AI agent do the heavy lifting for you. Instead of manually hunting down problematic content or trying to figure out who's following which channel, you just tell your agent what needs to happen. You can have it moderate your channel in real-time, pin important announcements, or pull data on your social graph to see how your reach is growing. It handles the nitty-gritty stuff like checking account verifications and managing blocked users so you can stay focused on building your community. Because Vinkius hosts this tool, you get a direct line into the Farcaster ecosystem from your favorite AI client. It turns your agent into a dedicated community manager that understands the nuances of decentralized social interactions. ## Tools ### ban_channel_user Ban a specific user from a channel to maintain community standards. This helps keep your channel safe from trolls. ### block_user Block a user from interacting with you across the protocol. Use this to stop unwanted interactions. ### get_current_fname_owner Identify the owner of a specific fname. Use this to see who holds a specific name on the protocol. ### get_primary_address Get the primary wallet address for a user. This is useful for verifying on-chain identities. ### get_signed_key_request Check the status of a signed key request. Use this to monitor pending protocol actions. ### list_account_verifications See all account verifications for a specific user. This helps you identify trusted accounts quickly. ### list_all_channels Get a full list of all available Farcaster channels. Use this to explore the broader social landscape. ### list_blocked_users See a list of all users you have blocked. This helps you manage your personal safety on the protocol. ### list_channel_followers See who is following a specific Farcaster channel. This is great for analyzing your audience reach. ### list_creator_rewards View the weekly top rewards for creators on the network. Use this to track trending content. ### list_developer_rewards View the weekly top rewards for developers on the network. This helps you see what devs are getting paid for. ### list_fname_transfers See the history of fname transfers filtered by name or FID. Use this to track name ownership changes. ### list_moderated_casts View all moderation actions taken within a specific channel. This lets you audit your channel's history. ### list_user_following_channels List channels a user follows ### moderate_cast Hide or unhide a cast in a channel using moderator privileges. Use this to clean up your feed instantly. ### pin_cast Pin a specific cast to the top of a channel for better visibility. Use this for important announcements. ### register_or_transfer_fname Register or transfer an fname using an EIP-712 signature. This allows for formal name management on the protocol. ### unfollow_channel Unfollow a Farcaster channel to remove it from your feed. Use this to clean up your social subscriptions. ### create_signed_key_request Create a signed key request for protocol interactions. This is a core step for certain account actions. ### follow_channel Follow a Farcaster channel to see its content in your feed. Use this to curate your social experience. ### get_channel Retrieve all details for a specific Farcaster channel. This gives you a full overview of any channel's metadata. ### get_current_fname_by_fid Find the current fname associated with a specific Farcaster ID. This helps map users to their display names. ## Prompt Examples **Prompt:** ``` Who are the followers of the 'farcaster' channel? ``` **Response:** ``` I've fetched the follower list for the **farcaster** channel. Here are the most recent additions: | FID | Status | | :--- | :--- | | 123 | Active | | 456 | Active | | 789 | Active | Would you like me to pull the next page of followers or check if a specific user is following this channel? ``` **Prompt:** ``` Hide the cast with hash 0x123456... in the 'mcp' channel. ``` **Response:** ``` I've updated the moderation status for you. The cast with hash **0x123456...** is now hidden in the **mcp** channel. I've also logged this action in the moderation history. ``` **Prompt:** ``` What are the top creator rewards this week? ``` **Response:** ``` Here are the top creator rewards for this week: * **Creator A**: 45.2 ETH * **Creator B**: 38.1 ETH * **Creator C**: 32.5 ETH Let me know if you'd like to see the developer rewards instead. ``` ## Capabilities ### Moderate channel content Hide or unhide specific casts to keep your community clean. ### Manage channel follows Add or remove channels from your feed with simple commands. ### Explore social graphs See who follows specific channels or what users are following. ### Handle user restrictions Ban users from channels or manage your blocked list. ### Track protocol identity Get account verifications and primary wallet addresses for Farcaster IDs. ### Monitor rewards Check weekly top creator and developer rewards on the network. ## Use Cases ### Quickly hiding spam in a high-traffic channel A moderator sees a spam link in the 'mcp' channel and asks their agent to use moderate_cast to hide the specific hash immediately. ### Verifying a user's on-chain identity A Web3 developer needs to check a user's primary wallet address and asks the agent to use get_primary_address for a specific FID. ### Auditing community moderation history A community manager wants to see all recent moderation actions and asks the agent to list_moderated_casts for their channel. ### Tracking fname ownership transfers A power user wants to see who previously owned a specific name and asks the agent to list_fname_transfers for that name. ## Benefits - Instant moderation with moderate_cast lets you hide spam or toxic content in seconds without leaving your chat. - Stay organized by using pin_cast to keep your most important announcements at the top of the feed. - Automate your social growth by using follow_channel and unfollow_channel to curate your feed quickly. - Get deep insights into your reach by using list_channel_followers to see who's engaging with your content. - Simplify community safety by using ban_channel_user and block_user to keep your space clean. - Monitor network trends using list_creator_rewards and list_developer_rewards to see what's trending. ## How It Works The bottom line is you get a hands-off way to manage your decentralized social presence through natural conversation. 1. Connect your Farcaster Auth Token from Warpcast or your developer portal to the Connector. 2. Authorize your AI client to access the Farcaster protocol via Vinkius. 3. Start asking your agent to perform tasks like pin this cast or list my followers. ## Frequently Asked Questions **Can I use the Farcaster MCP to moderate my channel?** Yes, you can use it to hide specific casts, pin important content, and ban users who violate your community standards directly through your AI agent. **How does the Farcaster MCP help with community management?** It acts as a dedicated assistant that handles repetitive tasks like managing follows, checking user verifications, and monitoring channel followers so you can focus on strategy. **Can I check user verifications with the Farcaster MCP?** You can easily pull account verifications for any user to verify their identity or status on the protocol without manual searching. **Is the Farcaster MCP good for tracking social growth?** It's great for this because you can query follower lists and social graph data to see how your reach is expanding over time. **Can I manage my follows using the Farcaster MCP?** Yes, you can tell your agent to follow or unfollow specific channels using natural language commands, making it easier to curate your feed. **How do I see fname transfers with the Farcaster MCP?** The Connector can retrieve the history of fname transfers, allowing you to track ownership changes and name movements on the network. **Can the Farcaster MCP ban users from my channel?** Yes, it includes a tool to ban specific users from your channel, helping you maintain a safe and moderated environment for your community. **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.