• MEDIA
  • POSTS
  • HUMAN
  • FEED

How to post photos and captions with your AI

Connect your agent to Pixelfed to handle your media uploads and status updates. Once linked, your AI manages the publishing process.

Ask AI about this page

Short answer

How can I use my AI to post to Pixelfed?

You give your agent an image and a caption, and it handles the upload and the post creation. You'll see your new status updates appear on your Pixelfed profile immediately. Here is how the process works.

Content outcomes

What you get

These are the results of your requests.

MEDIA

Images are uploaded

The agent moves your files to Pixelfed. Your images are ready for the feed.

POSTS

Statuses are live

The agent turns your text and images into a new update. Your followers see it right away.

HUMAN

You control content

The AI handles the technical execution, but you decide which photos and words are worth sharing.

FEED

Profile stays updated

Your Pixelfed timeline stays current without you needing to manually use the web interface.

The workflow

What your AI does when the request arrives.

The agent follows a specific sequence to move your media from your local environment to the web.

  1. Receive media

    Your agent takes the image file you provide in the chat.

    upload_media
  2. Transfer files

    The agent pushes the image data to your Pixelfed instance.

    upload_media
  3. Draft status

    The agent prepares the text and links the uploaded media to a new post.

    create_status
  4. Publish update

    The agent finalizes the post so it appears on your public feed.

    create_status

Try it

Copy these to start.

Use these prompts to trigger the Pixelfed tools.

Starting points

These are basic commands. You should swap out the descriptions for your specific photo details.

Pixelfed Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_ZE4VjpuN7GTs6xshDMTjhRjc2eurZs8CmLd8Od2k/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Pixelfed capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "pixelfed-instagram-alternative-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_ZE4VjpuN7GTs6xshDMTjhRjc2eurZs8CmLd8Od2k/mcp"
    }
  }
}
Copy into chat04
  • Upload this photo and post it to Pixelfed with the caption 'Sunset in the mountains'.

  • Take this image and create a new Pixelfed status saying 'New gear setup!'

  • Post this photo to my Pixelfed feed with a short caption about coffee.

  • Use the attached file to create a Pixelfed update about my weekend trip.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Pixelfed once, then ask.

Just link your account once. Your credentials stay encrypted and secure on our side. You can find the full list of what the agent can do on the Pixelfed Connector page.

Connect Pixelfed to your AI

FAQ

How this task behaves

  • 01

    Can the AI delete my old Pixelfed posts?

    No. The agent only has tools to upload media and create new statuses.

  • 02

    Does the AI choose the captions for me?

    It can if you ask it to, but it won't post anything without your instruction.

  • 03

    Can I post videos through this MCP?

    No. The current tools only support uploading media and creating text statuses.

  • 04

    Will my Pixelfed password be shared with the AI?

    No. Your login stays encrypted and is only used to maintain the connection.

  • 05

    Can the AI reply to comments on my posts?

    No. The agent is limited to uploading media and creating new status updates.

  • More questions about Pixelfed? See everything the Pixelfed Connector can do

Connect Pixelfed to Claude, Cursor, ChatGPT & more