How to integrate Typefully MCP with Atomic Agent

Connect Atomic Agent to Typefully MCP. Draft a new ai-generated tweet thread, list your recently published typefully posts, and more using natural language, with authentication handled for you.

Typefully logoTypefully
Api Key

Typefully is a platform for creating and managing AI-powered content. It helps individuals and teams craft, schedule, and analyze posts effortlessly.

16 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 Typefully.

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 Typefully account. See the Atomic Agent documentation for installation instructions.

Also integrate Typefully with

How Atomic Agent connects to Typefully

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 Typefully 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 Typefully. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Typefully 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 Typefully MCP server, and what's possible with it?

The Typefully MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Typefully account. It provides structured and secure access to your Typefully workspace, so your agent can create content drafts, manage notifications, and stay on top of publishing activity on your behalf.

  • Automated content drafting: Let your agent generate and save new draft posts directly to your Typefully account for later review or editing.
  • Real-time notification retrieval: Ask your agent to fetch your latest Typefully notifications, filtered by inbox or activity, so you never miss important updates.
  • Review recently published content: Quickly get a list of your most recent published drafts, making it easy to track your publishing history and monitor engagement.
  • Manage scheduled drafts: Have your agent pull up all your recently scheduled drafts, helping you keep tabs on your content calendar and upcoming posts.
  • Effortless notification management: Direct your agent to mark notifications as read, keeping your workspace tidy and ensuring you stay focused on what matters.

Use Typefully from Atomic Agent

With your account connected, ask Atomic Agent to work with Typefully 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 Typefully action and event your agent gets out of the box.

Create Draft (v2)

Create a new draft with platform-specific content for multi-platform publishing.

Create Tag

Creates a new tag for organizing drafts within a social set in Typefully.

Delete Draft

Permanently deletes a draft from Typefully.

Get Current User

Get the current authenticated user's information.

Get Draft

Retrieves a single draft by its ID with full details including platform-specific content, tags, status, and scheduling information.

Get Media Status

Check the processing status of an uploaded media file.

Get Queue

Get the scheduled content queue for a social set within a date range.

Get Queue Schedule

Get the queue schedule configuration for a social set, including posting slots and timezone settings.

Get Social Set

Get detailed information about a specific social set, including all connected platforms (X, LinkedIn, Mastodon, Threads, Bluesky) with account details and profile information.

Initialize Media Upload

Initializes a media upload by returning a presigned URL.

List Drafts

List drafts for a social set with filtering and sorting options.

List Social Sets

List all social sets (groups of connected platform accounts) accessible to the authenticated user.

List Tags

List all tags for a social set.

Resolve LinkedIn Organization

Resolve a LinkedIn organization from its public URL.

Update Draft

Update an existing draft with partial update semantics.

Update Queue Schedule

Replace the queue schedule configuration for a social set.

FAQ

Frequently asked questions

With a standalone Typefully MCP server, the agents and LLMs can only access a fixed set of Typefully tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Typefully 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 Typefully tools.

Yes, absolutely. You can configure which Typefully 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 Typefully data and credentials are handled as safely as possible.

Start with Typefully.It takes 30 seconds.

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

Start building