Farcaster MCP. Manage your decentralized social graph from chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Farcaster MCP Server connects your AI agent directly to the Farcaster protocol. Use it to manage your decentralized social presence—list all channels, follow/unfollow accounts, and moderate content.
Check user verifications, query social graphs, or ban users without leaving your chat client. It puts community management and protocol exploration right where you work.
What your AI agents can do
Ban channel user
Removes a user from a specific channel.
Block user
Prevents a user from interacting with your account.
Create signed key request
Generates a request that requires a cryptographic signature.
Pin specific posts to a channel, hide flagged content, or remove users from a channel.
List all channels a user follows, check who follows a specific channel, or get a user's primary wallet address.
Block users, unfollow channels, or ban users within a channel.
List account verifications or check the current name associated with any Farcaster ID.
Get a history of name transfers, filtering by name, FID, or timestamp.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Farcaster MCP Server: 22 Tools for Social Graph Management
Use these 22 tools to manage channel memberships, moderate content, and analyze user connections across the Farcaster protocol.
019e5d18ban channel user
Removes a user from a specific channel.
019e5d18block user
Prevents a user from interacting with your account.
019e5d18create signed key request
Generates a request that requires a cryptographic signature.
019e5d18follow channel
Directly follows a designated Farcaster channel.
019e5d18get channel
Retrieves all data for a single Farcaster channel.
019e5d18get current fname by fid
Finds the current display name associated with a specific Farcaster ID.
019e5d18get current fname owner
Checks which user currently owns a specific display name.
019e5d18get primary address
Gets the main wallet address for a user.
019e5d18get signed key request
Checks the status of a key signing request.
019e5d18list account verifications
Lists all account verification records for a user.
019e5d18list all channels
Retrieves a list of every Farcaster channel.
019e5d18list blocked users
Gets a list of users you have blocked.
019e5d18list channel followers
Lists every user who follows a specific Farcaster channel.
019e5d18list creator rewards
Retrieves the weekly top creator reward list.
019e5d18list developer rewards
Gets the weekly top developer reward list.
019e5d18list fname transfers
Retrieves the history of Farcaster name transfers, with filtering options.
019e5d18list moderated casts
Shows a log of moderation actions taken in a specific channel.
019e5d18list user following channels
Lists all channels that a specified user is following.
019e5d18moderate cast
Hides or unhides a specific post in a channel, requiring moderator rights.
019e5d18pin cast
Marks a post in a channel as important and visible to everyone.
019e5d18register or transfer fname
Registers a new display name or transfers an existing one.
019e5d18unfollow channel
Stops following a designated Farcaster channel.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Farcaster (Decentralized Social Protocol), then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Yo, this Farcaster MCP Server hooks your AI agent right into the Farcaster protocol. It lets you manage your decentralized social presence and mess around with the Farcaster graph, all without leaving your chat client. You can list all channels, follow or unfollow accounts, and moderate content right where you work.
It puts full-on community management and protocol deep-dives right where your AI client needs 'em.
Managing Content and Users
moderate_cast lets you hide or unhide a specific post in a channel; you gotta have mod rights for that. You can pin_cast to mark a post as important and visible to everyone. You also control users by ban_channel_user to remove a user from a specific channel, and block_user to prevent a user from interacting with your account.
Tracking Connections and Identity
You can list_all_channels to get a list of every Farcaster channel. You can get_channel to retrieve all data for a single channel. To see who follows a specific channel, use list_channel_followers. You can also list_user_following_channels to see all channels a specified user is tracking. For user identity, get_current_fname_by_fid finds the current display name tied to a specific Farcaster ID, and get_current_fname_owner checks which user owns a specific display name.
You can get_primary_address to grab a user's main wallet address. If you need to know about account verifications, list_account_verifications lists all records for a user. register_or_transfer_fname lets you register a new display name or transfer an existing one.
Monitoring Activity and Rewards
list_moderated_casts shows a log of moderation actions taken in a specific channel. You can list_fname_transfers to get the history of Farcaster name transfers, and you can filter that list by name, FID, or timestamp. You also get weekly top creator rewards using list_creator_rewards, and you can check the top developer rewards list with list_developer_rewards.
Managing Following Status
follow_channel lets you directly follow a designated Farcaster channel, and unfollow_channel stops following a designated channel. You can also list_blocked_users to get a list of users you've blocked.
Handling Key Requests
create_signed_key_request generates a request that needs a cryptographic signature, and get_signed_key_request checks the status of a key signing request.
How Farcaster MCP Works
- 1 Subscribe to the server and provide your Farcaster Auth Token (from Warpcast or your developer portal).
- 2 Your AI client accesses the tool suite via natural conversation, invoking tools like
list_all_channelsorget_channel. - 3 The server executes the commands, returning structured data (e.g., follower lists, moderation logs) directly to your client.
The bottom line is: your AI agent handles all your Farcaster interactions from one place, eliminating the need to switch between different apps.
Who Is Farcaster MCP For?
This is for the Community Manager who gets tired of juggling moderation tools and growth dashboards. It's for the Web3 Developer who needs to query on-chain data directly from their code editor. It's for the Social Power User who needs to automate complex social graph analysis. If your job involves managing a public-facing decentralized profile, this is for you.
Runs moderation checks—pinning announcements, hiding spam, and managing channel membership—without leaving their workflow.
Queries channel data, user verifications, and social graph information directly from their IDE or code editor.
Tracks social growth, monitors who follows a channel, and checks user connection histories across the Farcaster ecosystem.
What Changes When You Connect
- Manage moderation with
moderate_castandpin_cast. Don't manually check spam or forget to highlight an announcement; your agent handles the actions instantly. - Track your social network with
list_channel_followersandlist_user_following_channels. See who's paying attention to your content and who your audience follows. - Control your presence with
follow_channelandunfollow_channel. Change your network graph or track new topics without leaving your chat interface. - Secure your identity by checking account verifications using
list_account_verificationsor getting a user'sget_primary_address. Essential for compliance or auditing. - Maintain clean channels by using
ban_channel_userandblock_user. Enforce community standards programmatically, reducing manual effort. - Audit name changes or identity moves using
list_fname_transfersandget_current_fname_by_fid. Keep a clear record of your digital assets.
Real-World Use Cases
A channel needs immediate moderation.
A community manager sees a wave of spam. Instead of opening the web UI, they tell their agent: 'Hide the spam and ban the user.' The agent runs moderate_cast and ban_channel_user sequentially, keeping the flow moving and keeping the community clean.
Tracking a new collaborator's visibility.
You need to know who is following a key channel before inviting them. You ask your agent to run list_channel_followers for the channel's FID. The agent returns the list, and you can proceed with your outreach, all from your chat window.
Auditing a user's full connection history.
You suspect an account is acting suspiciously. You ask your agent to check the user's primary wallet (get_primary_address) and then run list_user_following_channels to map their entire activity pattern.
Preparing for a major announcement.
Before launching a product, you want to ensure everyone sees the announcement. You ask the agent to run get_channel to verify the channel status, then use pin_cast on the key announcement, and finally send a message confirming the pin.
The Tradeoffs
Trying to check everything manually.
Opening the Farcaster website, checking the member list, then opening a separate tab to see the user's profile, and finally checking the history log. This takes 15 minutes and requires constant context switching.
→
Tell your agent: 'Give me the full status of this channel.' The agent uses get_channel to fetch the data, and then uses list_channel_followers and list_moderated_casts to provide a single, consolidated view in your chat.
Forgetting moderation rights.
Attempting to moderate_cast or ban_channel_user without the correct authentication token or moderator privilege, leading to a generic 'Permission Denied' error.
→
First, run list_account_verifications to confirm your account status. Then, explicitly call the moderation tool. The agent handles the required authentication steps, giving you a clear pass/fail status.
Assuming a name transfer is permanent.
Relying on a user's displayed name without checking the protocol record, assuming the name is still theirs after a potential transfer or change.
→
Always check the name ownership first. Use get_current_fname_by_fid or get_current_fname_owner before trusting any name you see.
When It Fits, When It Doesn't
Use this server if your core job involves managing or analyzing a decentralized social graph. You need to perform complex, multi-step actions (like moderating content or auditing a user) that require chaining together multiple API calls. The key is: if you find yourself needing to switch between the Farcaster website, a dashboard, and a terminal to get a full picture, you need this. Don't use this if you only need to view simple, static data (like checking one single channel's name). For that, simple read-only APIs might suffice. If you only need to check the current name of an FID, get_current_fname_by_fid is enough. But if you need to ban the user and check their followers, you need the whole package.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Farcaster. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 22 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Juggling moderation and social analysis is a full-time job.
Today, managing a channel means bouncing between the Farcaster UI, a separate moderation dashboard, and a database explorer. You have to copy the channel ID here, paste it there, then jump to the user list to check followers. If you need to ban someone, you leave the chat, open the web app, find the user, and manually hit the ban button.
With the Farcaster MCP Server, you just talk to your agent. You say, 'Ban this user and list their followers.' The agent runs `ban_channel_user` and then `list_channel_followers` in sequence. You get the results—the ban status and the full list—right in the chat. It's all one flow.
Farcaster MCP Server: Manage content and users directly.
You no longer need to manually check if an announcement was pinned or if a spam cast was hidden. You can ask your agent to check the moderation logs using `list_moderated_casts` and then run `pin_cast` on the correct thread. This saves time and prevents human error.
It’s not just about running a command; it’s about coordinating a full community action. You tell the AI the goal, and it executes the sequence of tools to achieve it. Period.
Common Questions About Farcaster MCP
How do I use the `list_all_channels` tool? +
You ask your agent to list all available Farcaster channels. It returns a comprehensive list of channels you can then query for details or manage.
Is `moderate_cast` the right tool for removing spam? +
Yes, moderate_cast hides or unhides a specific cast in a channel. It's the tool you use when you need to hide spam or mark content as important.
Can I use `list_channel_followers` to see who follows a channel? +
Yes, list_channel_followers pulls the current list of followers for any given Farcaster channel, which is key for growth tracking.
What is the difference between `block_user` and `ban_channel_user`? +
block_user prevents interaction with your account globally. ban_channel_user removes a user's access specifically from one channel.
Does `get_primary_address` show the user's wallet address? +
Yes, get_primary_address retrieves the main wallet address associated with a user's Farcaster ID. This is essential for financial or identity checks.
How does the `list_account_verifications` tool work, and what kind of data does it return? +
It returns a list of all verifications tied to your account. This data helps you audit your identity status and see if you've completed primary account setup.
Do I need to use `get_signed_key_request` before I can register an FName? +
Yes, you must generate a signed key request first. The get_signed_key_request tool gives you the status, ensuring you have the necessary signature before attempting registration.
What is the scope of the `list_user_following_channels` tool? +
This tool shows the channels a specific user follows. It's useful for mapping out a user's entire social graph within the Farcaster ecosystem.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Dixa
Route customer conversations to the right agent across phone, email, chat, and messaging with intelligent prioritization.
Plivo
Build voice and SMS applications with a cloud communications API that scales globally and offers competitive per-message pricing.
Front
Manage shared inboxes across email, SMS, and social with team collaboration tools that keep customer conversations organized.
You might also like
SigNoz (Datadog Alternative)
Monitor infrastructure and manage alert rules via SigNoz — list, create, and update observability alerts directly from your AI agent.
Hotmart
Manage sales, products, and subscriptions via Hotmart API.
Ghostfolio (Investment Tracker)
Track your wealth and manage investment portfolios via Ghostfolio — monitor holdings, record activities, and analyze performance through AI.