How to integrate Ritekit MCP with Atomic Agent

Connect Atomic Agent to Ritekit MCP. Suggest hashtags for your blog post draft, check if these instagram hashtags are banned, and more using natural language, with authentication handled for you.

Ritekit logoRitekit
Api Key

Ritekit is a social media enhancement platform offering APIs for hashtags, link shortening, and content analysis. Instantly boost engagement and streamline your social media workflow.

14 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 Ritekit.

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

Also integrate Ritekit with

How Atomic Agent connects to Ritekit

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

The Ritekit MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Ritekit account. It provides structured and secure access to Ritekit’s social media optimization tools, so your agent can generate hashtags, analyze links, validate email addresses, and boost content engagement automatically on your behalf.

  • Smart hashtag generation and suggestions: Instantly get relevant and trending hashtags for any post or campaign to maximize visibility and reach.
  • Banned hashtag detection for Instagram: Automatically filter out banned or unsafe hashtags before publishing to keep your posts compliant and effective.
  • Comprehensive hashtag analytics: Retrieve real-time engagement stats on up to 100 hashtags, including metrics like tweets, retweets, exposure, and popularity grades.
  • Email address validation: Have your agent detect disposable or free email addresses to improve lead quality and reduce spam signups.
  • Link ad management: Enable deletion of link ads directly through your agent to keep your promotional content up to date and relevant.

Use Ritekit from Atomic Agent

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

Auto Hashtag

Tool to automatically add relevant hashtags to a given post.

Check Banned Instagram Hashtags

Tool to identify which hashtags are banned on Instagram.

Detect Disposable Email

Tool to detect if an email address is disposable.

Detect Email Typo

Tool to detect common typos in email addresses and suggest corrections.

Free Email Detection

Tool to detect whether an email address belongs to a free email provider.

Get Access Token

Tool to obtain a RiteKit access token.

RiteKit Get Client ID

Tool to retrieve stored RiteKit client_id.

RiteKit Get Client Secret

Tool to retrieve stored RiteKit client_secret.

Get Full Email Insights

Tool to retrieve comprehensive email address insights including full name, free mail detection, business email detection, and typo suggestions.

RiteKit Hashtag Suggestions

Tool to get hashtag suggestions for a given text.

Delete Link Ad

Tool to delete a link ad.

List Link Ads

Tool to retrieve a list of link ads.

Shorten Link

Tool to shorten a URL with a specified CTA.

Convert Text to Image

Tool to convert a quote into a styled image.

FAQ

Frequently asked questions

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

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

Start with Ritekit.It takes 30 seconds.

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

Start building