How to integrate Threads MCP with Atomic Agent

Connect Atomic Agent to Threads MCP. Publish today's product update on threads, find public threads posts about product launches, and more using natural language, with authentication handled for you.

Threads logoThreads
Oauth2

Threads is Meta's social network for publishing posts, managing replies, discovering content, and tracking performance. It helps creators and brands engage audiences and measure what resonates.

24 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Threads.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Threads account. See the Atomic Agent documentation for installation instructions.

Also integrate Threads with

How Atomic Agent connects to Threads

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Threads to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Threads. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Threads account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Threads MCP server, and what's possible with it?

The Threads MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Threads account. It provides structured and secure access to publishing, replies, public content, profile details, and performance insights, so your agent can publish posts, manage conversations, discover content, and analyze engagement on your behalf.

  • Post publishing and sharing: Have your agent publish text, image, video, carousel, quote, poll, ghost, GIF, or text-attachment posts, and optionally share them as Instagram Stories.
  • Conversation management: Let the agent reply to posts, list replies and mentions, review pending replies, and hide or unhide replies on posts you manage.
  • Public content discovery: Direct your agent to search posts by keyword or topic tag, look up public profiles, browse their posts, and find locations for post tagging.
  • Profile and post analytics: Instruct your agent to retrieve profile insights, post engagement metrics, publishing limits, and your profile details.
  • Content maintenance: Have your agent list your posts, replies, ghost posts, and reposts, then delete posts or repost content when needed.

Use Threads from Atomic Agent

With your account connected, ask Atomic Agent to work with Threads in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Threads action and event your agent gets out of the box.

Create and Share Post

Create and publish a top-level Threads post and cross-share it to the linked Instagram account as a Story.

Create Post

Create and publish a top-level Threads text, image, video, carousel, quote, poll, ghost, GIF, or text-attachment post, optionally with a location tag.

Create Reply

Create and publish a reply to a Threads post, including a text, image, video, carousel, quote, poll, GIF, or text-attachment reply.

Delete Post

Permanently delete a Threads post owned by the connected profile.

Get Location

Retrieve one Threads location by ID for inspection or post tagging.

Get My Profile

Return the connected or app-scoped Threads user's profile and identity fields.

Get Post

Retrieve one Threads post by ID.

Get Post Embed

Return embeddable HTML and oEmbed metadata for a public Threads post.

Get Post Insights

Return selected lifetime engagement metrics for one post owned by the connected Threads profile.

Get Profile Insights

Return one time-window page of selected profile time-series, totals, link clicks, follower counts, or follower demographics for a Threads profile.

Get Publishing Limits

Return current usage and configured quota for Threads posts, replies, deletes, location searches, or all publishing categories.

List Ghost Posts

List active and archived ghost posts created by the connected Threads profile, one cursor page at a time.

List My Mentions

List public Threads posts that mention the connected profile, one cursor page at a time.

List My Posts

List posts created by the connected Threads profile, one cursor page at a time.

List My Replies

List replies created by the connected Threads profile, one cursor page at a time.

List Pending Replies

List one page of pending or ignored replies for an owned Threads post.

List Post Replies

Return either immediate replies or the flattened full conversation for a Threads post, one cursor page at a time.

List Public Profile Posts

List one cursor page of posts from a qualifying public Threads profile by exact username.

Lookup Public Profile

Look up a qualifying public Threads profile by exact username.

Repost Post

Repost an existing Threads post to the connected profile; this creates a visible post.

Review Pending Reply

Approve or ignore one pending reply; an ignored reply can later be approved.

Search Locations

Search Threads locations by text, coordinates, or both.

Search Posts

Search one page of Threads posts by keyword or topic tag.

Set Reply Visibility

Hide or unhide a top-level reply and its nested replies on a post managed by the connected profile.

FAQ

Frequently asked questions

With a standalone Threads MCP server, the agents and LLMs can only access a fixed set of Threads tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Threads and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Threads tools.

Yes, absolutely. You can configure which Threads scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Threads data and credentials are handled as safely as possible.

Start with Threads.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Threads tool your agent needs.Free to start.

Start building