Pixelfed MCP. Manage your entire decentralized feed 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.
Pixelfed manages your decentralized photo-sharing feed—your alternative to centralized platforms. Use any AI agent to post text and media, like posts using `favourite_status`, track notifications via `get_notifications`, or browse public timelines without logging into a browser.
What your AI agents can do
Create status
Creates a new status post, accepting text content, media IDs, and visibility settings.
Delete status
Removes an existing status (post) from your profile.
Favourite status
Likes a specific status post by calling this tool.
Write and publish new text posts or photos to your Pixelfed profile using create_status.
Interact with content by liking an existing status (favourite_status) or removing a like via unfavourite_status.
View your personalized home feed, public trends, or specific hashtag results using tools like get_home_timeline or get_tag_timeline.
Follow new users with follow_account, unfollow accounts using unfollow_account, and track your network with get_following.
Fetch profile details for any account or check your list of followers using get_account and get_followers.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Pixelfed (Instagram Alternative) MCP Server: 17 Tools for Social Management
These 17 tools let you programmatically manage every aspect of a Pixelfed account, from uploading media to checking your latest notifications.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Pixelfed (Instagram Alternative) on Vinkius019e38d7create status
Creates a new status post, accepting text content, media IDs, and visibility settings.
019e38d7delete status
Removes an existing status (post) from your profile.
019e38d7favourite status
Likes a specific status post by calling this tool.
019e38d7follow account
Starts following a specified user account on Pixelfed.
019e38d7get account
Retrieves detailed information for any specific Pixelfed account.
019e38d7get followers
Fetches a list of users who follow the specified account.
019e38d7get following
Retrieves the list of accounts that the current user is following.
019e38d7get home timeline
Gets the most recent posts visible on your personalized home feed.
019e38d7get notifications
Retrieves a list of real-time notifications related to your account activity.
019e38d7get public timeline
Displays the general, public feed of content from various users.
019e38d7get status
Retrieves the full content and details for a single specific status (post).
019e38d7get tag timeline
Gets posts associated with a particular hashtag or topic tag.
019e38d7reblog status
Shares an existing status post to your own profile, making it visible to your followers.
019e38d7unfavourite status
Removes a like you previously gave to a specific status.
019e38d7unfollow account
Stops following a specified user account on Pixelfed.
019e38d7upload media
Uploads media (like images) and returns a unique ID needed when creating a status post.
019e38d7verify credentials
Checks if the user's access token is valid and authenticated with Pixelfed.
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 Pixelfed (Instagram Alternative), then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ 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
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Pixelfed. 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 17 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Checking a decentralized feed used to mean opening 5 tabs.
Today, checking your activity means jumping through hoops: open the browser, log in, navigate to the notifications tab, then check your home timeline, and finally manually scroll down to see if anyone liked your post. It's a context-switching nightmare that breaks focus.
With this MCP server, you just tell your agent what you need. For example, 'What are my latest updates?' The agent runs `get_home_timeline` and pulls the data straight into your chat window. You get immediate answers without touching a web browser.
Pixelfed MCP Server: Manage media uploads and status creation
Posting content used to involve saving a file locally, finding the correct upload endpoint, getting an ID, and then manually using that ID in the main posting form. It was a multi-step process prone to copy/paste errors.
Now, you just tell your agent, 'Post this photo with this text.' The agent runs `upload_media` behind the scenes, grabs the resulting media ID, and sends everything through `create_status`. You get the post live in one shot.
What you can do with this MCP connector
Pixelfed (Instagram Alternative) MCP Server for Status & Media
Forget relying on centralized platforms. This server gives your AI agent full control over your decentralized photo-sharing feed, letting you manage it all right where you are working. You don't have to open a browser just to post or check what your friends are up to.
Posting and Editing Content
You can write new statuses using create_status, giving the AI agent text content, specific media IDs, and even setting who can see it. If you upload pictures first with upload_media, that tool returns a unique ID you must pass back into create_status so your post has the right visuals. You'll also need to know how to clean up: call delete_status when you want to remove an old status from your profile.
Social Interaction and Engagement
Want to interact with content? Your agent can easily like a specific post using favourite_status. If you change your mind, just run unfavourite_status to take the like off. You can share someone else's cool status by reblogging it; use reblog_status for that. To keep tabs on who follows you or who you follow, you can check those lists using get_followers and get_following, respectively.
Browsing Feeds and Finding Content
You've got three ways to view content depending on what you want to see. For the general vibe, run get_public_timeline to see posts from various people across Pixelfed. If you just wanna catch up on your personal stream, use get_home_timeline. Need something specific? Use get_tag_timeline to pull up all the content linked to a certain hashtag or topic tag.
To get full details on one post—say, checking out what someone posted hours ago—you call get_status, which pulls the full content for that single status.
Managing Your Connections and Profile
Want to expand your network? Use follow_account to start following a specific user. If you lose interest in an account, just run unfollow_account. To see what a user's profile looks like or check out their bio, call get_account with the username. You can also pull up real-time activity using get_notifications, which gives you a list of things happening related to your account.
Core Functionality Summary
To recap: Your agent handles everything from publishing new content and deleting old stuff, to liking posts and sharing them across your feed. You can track down specific user data with tools like get_account, get lists of followers via get_followers, or simply see what's going on right now using the timeline functions.
All you gotta do is tell it which tool to run.
(Note: The server also includes verify_credentials so you can always check if your access token is valid and authenticated with Pixelfed.)
019e38d7-96a1-71ea-a1f0-37854783f87a 
How Pixelfed MCP Works
- 1 Subscribe to the Pixelfed MCP Server and provide your Instance URL and Personal Access Token.
- 2 Your AI client authenticates against the server, validating your access with
verify_credentials. - 3 You ask the agent a question (e.g., 'What are my notifications?'), and it uses tools like
get_notificationsto get and report the data.
The bottom line is that you talk naturally to your AI client, and it executes the necessary Pixelfed API calls for you.
Who Is Pixelfed MCP For?
This is for people who spend time managing public-facing profiles but hate constantly switching tabs. It's the social media manager who needs to track engagement across multiple feeds without leaving their main workflow, or the content creator tired of logging into a separate browser window just to post an update.
Tracks multiple decentralized feeds and interacts with communities by calling get_home_timeline and reblog_status directly from their main application.
Automates posting schedules, uploading media via upload_media, and monitoring engagement metrics without leaving their coding or writing environment.
Stays connected to the decentralized web by querying account details (get_account) and checking notifications (get_notifications) through a unified AI interface.
What Changes When You Connect
- Post content without context switching. Use
upload_mediaand thencreate_statusto publish a photo with text in one conversation turn. - Track your network activity instantly. Call
get_notificationsinstead of checking an email or logging into the site just for updates. - Understand who's talking to you. Check your connections using
get_followersand see what accounts you follow viaget_following—all from your agent. - Engage with content directly. Use
favourite_statusorunfavourite_statusto manage likes without navigating away from your development environment. - Monitor the trends. Get a broad view of public activity by querying
get_public_timelineor specific topics usingget_tag_timeline.
Real-World Use Cases
Curating a weekly digest
A social media manager needs to see what's happening across 3 different client feeds. Instead of opening three browser tabs, they ask their agent to run get_home_timeline, then get_public_timeline, and finally check trending tags with get_tag_timeline to compile a report.
Responding to an update
A user sees an interesting post from a colleague. They ask their agent to first grab the status details (get_status), then share it using reblog_status, and finally add a comment by creating a new status with text.
Auditing connections
A user wants to know if they've been blocked or who is paying attention. They run get_followers on their profile, check the list of people they follow using get_following, and review any recent alerts with get_notifications.
Posting a media update
A content creator has new photos ready. They first call upload_media to get the unique ID, then immediately use that ID in their prompt when calling create_status, making the post live without manual copy-pasting.
The Tradeoffs
Manual credential checks
The user tries to manually check if their token works by guessing endpoints and receiving 401 errors.
→
Always start by running verify_credentials through the agent. This confirms your access is valid before attempting any actions like create_status or fetching data.
Assuming media IDs
The user tries to call create_status with a photo ID they found in documentation, but it fails because the ID isn't fresh.
→
You must always run upload_media first. The tool returns a live media_id, which is the only correct input for your status post.
Overlooking timeline scope
The user asks 'show me posts' but doesn't specify if they mean their personal feed or public content, leading to ambiguous results.
→
Be specific. Use get_home_timeline for your personalized stream, and use get_public_timeline when you need general, non-curated content.
When It Fits, When It Doesn't
Use this server if your workflow involves frequent, low-friction interaction with a decentralized social feed. If you constantly find yourself logging into Pixelfed in a browser to post an update or check who liked your photos, this is for you. You need tools like create_status, favourite_status, and get_notifications working together inside your AI agent.
Don't use this if you only need to read static account data (use a simple API client) or if your content management happens on an entirely different platform (like email). This is specifically for managing the activity of the Pixelfed account itself. If you are just writing text and don't care about media or follower counts, other plain messaging tools might be simpler.
Common Questions About Pixelfed MCP
How do I check my followers with get_followers? +
You just ask your agent to run get_followers and specify which account you want details for. The tool returns a list of user accounts that follow the target profile.
Can I reblog content using reblog_status? +
Yes, calling reblog_status shares an existing status post to your feed. You just need to provide the ID of the status you want to share.
What's the difference between get_home_timeline and get_public_timeline? +
The home timeline shows posts specifically relevant to you (your feed), while get_public_timeline shows general, non-curated content that anyone can see.
Do I need to use upload_media before create_status? +
Yep. You must run upload_media first. The tool returns a temporary media ID; you use that specific ID in your prompt when calling create_status.
How do I use `verify_credentials` to check if my access token is valid? +
It confirms that your Personal Access Token and Instance URL are correctly set up. Running this tool verifies your authenticated status, allowing you to execute other actions like posting or reading timelines.
If I use `delete_status`, does it only remove the post from my feed? +
Yes, delete_status immediately removes the specified post from your profile and the Pixelfed network. It's a direct action that deletes content history.
What information does `get_account` return about my user profile? +
It provides comprehensive details about your account, including your unique handle, display name, and creation date. This helps you confirm which account the agent is acting on behalf of.
How does `favourite_status` work when I like a post? +
Using favourite_status registers your like activity on that specific post. It increments the public engagement count, tracking your interaction with content instantly.
Can I upload images and post them to my feed using the AI? +
Yes! First, use the upload_media tool to upload your file and get a media ID. Then, use the create_status tool and include that ID in the media_ids array to publish your post.
How do I see what's trending on my Pixelfed instance? +
You can use the get_tag_timeline tool with a specific hashtag to see related posts, or use get_public_timeline to see the most recent public posts across the instance.
Is it possible to manage my followers through this integration? +
Absolutely. You can use get_followers and get_following to list accounts, and use follow_account or unfollow_account to manage your connections.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.