# How to integrate AppFollow MCP with Atomic Agent

```json
{
  "title": "How to integrate AppFollow MCP with Atomic Agent",
  "toolkit": "AppFollow",
  "toolkit_slug": "appfollow",
  "framework": "Atomic Agent",
  "framework_slug": "atomic-agent",
  "url": "https://composio.dev/toolkits/appfollow/framework/atomic-agent",
  "markdown_url": "https://composio.dev/toolkits/appfollow/framework/atomic-agent.md",
  "updated_at": "2026-11-18T05:32:10.756Z"
}
```

## 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,700+ apps through Composio, including AppFollow.
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 AppFollow account. See the [Atomic Agent documentation](https://atomicagent.io/docs/?cta_placement=atomic-agent-docs) for installation instructions.
For exact tool slugs and parameter tables, see the [tool catalog in the Composio docs](https://docs.composio.dev/toolkits/appfollow).

## Also integrate AppFollow with

- [ChatGPT](https://composio.dev/toolkits/appfollow/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/appfollow/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/appfollow/framework/hermes-agent)

## TL;DR

### How Atomic Agent connects to AppFollow
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 AppFollow to Atomic Agent

### Connect AppFollow to Atomic Agent
- Sign up or sign in to the [Composio dashboard](https://dashboard.composio.dev/?cta_placement=atomic-agent-api-key). Copy your API key.
- 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.
- Ask Atomic Agent to do something in AppFollow. It searches Composio for the right tool.
- On first use, open the sign-in link returned in the chat. Connect your AppFollow 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 AppFollow MCP server, and what's possible with it?

The AppFollow MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your AppFollow account. It provides structured and secure access to app-store performance data, ratings, reviews, ASO insights, and review workflows, so your agent can monitor rankings, analyze customer feedback, research keywords, manage reviews, and track app performance on your behalf.
- App performance monitoring: Have your agent review app rankings, featuring history, versions, release notes, ratings history, and public top charts by store, country, device, genre, or date.
- Review analysis and reporting: Let the agent list reviews, summarize feedback with AI, analyze sentiment and semantic tags, compare review performance by version, and report on ratings, replies, and response speed.
- ASO and search research: Direct your agent to find app-store keyword suggestions, review tracked keyword rankings, research Search Ads recommendations, and retrieve ASO or Search Ads reports.
- Review workflow management: Instruct your agent to reply to store reviews, update internal notes, change review statuses, apply tags, manage bug-tracker tags, or report review concerns.
- Collection and team administration: Have your agent list collections and their apps, add apps to collections, create or remove collections, and manage AppFollow users and access.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `APPFOLLOW_ADD_APP` | Add App | Add an existing store app to an AppFollow collection. This changes collection membership and requires an Enterprise plan. |
| `APPFOLLOW_ADD_COLLECTION` | Add Collection | Create an AppFollow app collection with required country codes and optional default-country and report-schedule settings. Requires an Enterprise plan. |
| `APPFOLLOW_ADD_USER` | Add User | Create an AppFollow account user with a role and optional collection access. This grants account access and requires an Enterprise plan. |
| `APPFOLLOW_GET_APP_FEATURED_HISTORY` | Get App Featured History | Get App Store featuring history for an app, optionally filtered by country, feature type, and date range. Costs 12 credits per request, plus 12 credits per additional 14 days beyond the first 14 days. |
| `APPFOLLOW_GET_APP_RANKINGS` | Get App Rankings | Get store ranking records for an app, optionally filtered by country, device, genre, and date. |
| `APPFOLLOW_GET_ASO_KEYWORD_SUGGESTIONS` | Get ASO Keyword Suggestions | Return App Store Optimization keyword suggestions for a search term, optionally localized by country and device. |
| `APPFOLLOW_GET_ASO_REPORT` | Get ASO Report | Get app download ASO metrics by channel or as a time series, optionally filtered by country, date range, and period. Requires the Team plan and costs 12 credits per request. |
| `APPFOLLOW_GET_FEATURED_REVIEWS` | Get Featured Reviews | Get featured-review history for an app, optionally filtered by country, language, custom statuses, and date range. Requires an Enterprise plan and costs 12 credits per request. |
| `APPFOLLOW_GET_GOOGLE_DEVELOPER_CONSOLE_ACQUISITION_REPORT` | Get Google Developer Console Acquisition Report | Get a Google Developer Console acquisition report by channel for one Android app and date range. Requires the Team plan and a configured integration. |
| `APPFOLLOW_GET_GOOGLE_PLAY_CONSOLE_METRIC_HISTORY` | Get Google Play Console Metric History | Get Google Play Console ratings or user-count history for an app in a collection. Requires an Enterprise feature or integration and may return access denied when it is not enabled. |
| `APPFOLLOW_GET_PUBLIC_TOP_CHARTS` | Get Public Top Charts | Get a public app-store top chart for a country, device, genre, and date. Costs 12 credits per request. |
| `APPFOLLOW_GET_RATINGS_HISTORY` | Get Ratings History | Get one page of app rating history with store, collection, country, period, version, and calculation filters. Requires a Team feature, costs 12 credits per request, and may return access denied when not enabled. |
| `APPFOLLOW_GET_REPLY_COUNTS` | Get Reply Counts | Get review reply-count statistics for an app, optionally filtered by API user login and date range. Requires an Enterprise plan and costs 12 credits per request, plus 12 credits per additional 14 days beyond the first 14 days. |
| `APPFOLLOW_GET_REPLY_SPEED_STATS` | Get Reply Speed Statistics | Get review reply-time distribution statistics for an app, optionally filtered by replying user and date. Requires an Enterprise plan and costs 12 credits per request. |
| `APPFOLLOW_GET_REVIEW_RATING_STATS` | Get Review Rating Statistics | Get review rating statistics for an app, optionally filtered by review date and replying user. Requires the Team plan and costs 12 credits per request. |
| `APPFOLLOW_GET_REVIEW_REPLY_STATS` | Get Review Reply Statistics | Get review reply, note, and tag activity statistics for an app, optionally filtered by replying user, date, or date range. Requires an Enterprise plan and costs 12 credits per request, plus 12 credits per additional 14 days beyond the first 14 days. |
| `APPFOLLOW_GET_REVIEWS_AI_SUMMARY` | Get Reviews AI Summary | Generate an AI summary of reviews for an app, collection, store, date range, and optional countries. Costs 48 credits per request and may require the Team plan feature to be enabled. |
| `APPFOLLOW_GET_REVIEW_SEMANTIC_TAGS` | Get Review Semantic Tags | Get semantic review tags and analysis for an app, optionally filtered by language, rating, sentiment, tag, version, and date range. Costs 48 credits per request and requires the Enterprise Semantic Tags feature. |
| `APPFOLLOW_GET_REVIEWS_SUMMARY` | Get Reviews Summary | Get aggregate review and rating counts and averages for an app, optionally filtered by country, language, version, and date range. Costs 12 credits per request, plus 12 credits per additional 14 days beyond the first 14 days. |
| `APPFOLLOW_GET_REVIEW_STATS` | Get Review Statistics | Get aggregate review and reply statistics for an app and optional date range. Requires the Team plan and costs 12 credits per request, plus 12 credits per additional 14 days beyond the first 14 days. |
| `APPFOLLOW_GET_REVIEW_STATS_BY_VERSION` | Get Review Statistics by Version | Get review statistics grouped by app version, with optional country, language, and date filters. Providing version narrows the result to that version. Requires the Team plan and costs 12 credits per request. |
| `APPFOLLOW_GET_SEARCH_ADS_KEYWORD_RECOMMENDATIONS` | Get Search Ads Keyword Recommendations | Return Apple Search Ads keyword recommendations for an app name, optionally localized by country or constrained by a phrase. Requires the Team plan and costs 12 credits per request. |
| `APPFOLLOW_GET_SEARCH_ADS_REPORT` | Get Search Ads Report | Get an App Store Search Ads ASO report for one app and date range. Requires the Team plan and a configured integration, and costs 12 credits per request. |
| `APPFOLLOW_LIST_APP_COLLECTIONS` | List App Collections | List AppFollow app collections available to the connected API token, including collection IDs needed by other actions. |
| `APPFOLLOW_LIST_APP_VERSIONS` | List App Versions | List one page of app versions and metadata changes for an app and country, optionally filtered by language and uniqueness. Costs 12 credits per request. |
| `APPFOLLOW_LIST_APP_WHATS_NEW` | List App What's New Entries | List one page of app release-note changes, optionally filtered by country, language, and last-modified time. Costs 12 credits per request. |
| `APPFOLLOW_LIST_COLLECTION_APPS` | List Collection Apps | List apps in one AppFollow collection and return app identifiers needed by analytics and review actions. |
| `APPFOLLOW_LIST_KEYWORDS` | List Tracked Keywords | List one page of tracked ASO keywords and ranking data for an app. Requires the Team plan and costs 12 credits per request. |
| `APPFOLLOW_LIST_REVIEWS` | List Reviews | List one page of reviews for either a store app ID or a collection name over a required date range, with optional review filters. Costs 12 credits per request; free plans are limited to the latest 50 reviews. |
| `APPFOLLOW_LIST_USERS` | List Users | List AppFollow account users, optionally filtering by user ID or email. Requires an Enterprise plan. |
| `APPFOLLOW_REMOVE_APP` | Remove App | WARNING: Permanently remove an app from an AppFollow collection. This destructive operation may remove associated collection tracking and requires an Enterprise full-access token. |
| `APPFOLLOW_REMOVE_COLLECTION` | Remove Collection | Permanently remove an AppFollow collection and its tracked configuration. This destructive operation requires an Enterprise plan. |
| `APPFOLLOW_REMOVE_USER` | Remove User | Permanently remove an AppFollow account user by ID, optionally matching their email. This destructive action revokes the user's account access, cannot be undone, and requires an Enterprise full-access token. |
| `APPFOLLOW_REPLY_TO_REVIEW` | Reply to Review | Publish an externally visible reply to a store review, optionally attributed to an API user login. This mutation may be irreversible and requires the Team plan and a reply integration. |
| `APPFOLLOW_REPORT_REVIEW_CONCERN` | Report Review Concern | Submit a concern about a store review. This sends an external moderation report that is irreversible and cannot be recalled; it requires an Enterprise plan. |
| `APPFOLLOW_SEARCH_APPS` | Search Apps | Search app stores for apps matching a keyword, optionally filtered by country and device. |
| `APPFOLLOW_UPDATE_REVIEW_BUG_TRACKER_TAGS` | Update Review Bug Tracker Tags | Replace bug-tracker tag names on a review, optionally within a collection. This changes review metadata and requires the corresponding integration. |
| `APPFOLLOW_UPDATE_REVIEW_NOTE` | Update Review Note | Set the internal note content on a review. This changes review metadata and requires an Enterprise plan. |
| `APPFOLLOW_UPDATE_REVIEW_STATUS` | Update Review Status | Set a review's private-beta custom status to reopened or closed. This changes review workflow state and requires the Enterprise Review Status feature. |
| `APPFOLLOW_UPDATE_REVIEW_TAGS` | Update Review Tags | Replace tag names on a review, optionally within a collection. This changes review metadata and requires an Enterprise plan. |
| `APPFOLLOW_UPDATE_TRACKED_KEYWORDS` | Update Tracked Keywords | Set the tracked keyword list for a country and device, optionally choosing a collection. This changes keyword tracking and requires the Team plan. |
| `APPFOLLOW_UPDATE_USER` | Update User | Replace an AppFollow user's name, role, email, and optional collection access. This changes account permissions and requires an Enterprise plan. |
| `APPFOLLOW_UPLOAD_REVIEWS_BULK` | Upload Reviews in Bulk | Upload a batch of custom-source reviews using a client idempotency key. Items are processed independently, so partial success is possible. Depending on on_conflict, each review can be created, updated, skipped, or fail; inspect every per-review outcome. |

## Supported Triggers

None listed.

## 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](/pricing/platform) for the current limits that apply to your connection.

## Complete Code

None listed.

## Conclusion

### Use AppFollow from Atomic Agent
With your account connected, ask Atomic Agent to work with AppFollow in natural language. You can connect more apps through the same Composio integration as you need them.
Visit the [Atomic Agent website](https://atomicagent.io/?cta_placement=atomic-agent-site) or inspect the [Atomic Agent source code](https://github.com/AtomicBot-ai/atomic-agent?cta_placement=atomic-agent-repo).

## How to build AppFollow MCP Agent with another framework

- [ChatGPT](https://composio.dev/toolkits/appfollow/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/appfollow/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/appfollow/framework/hermes-agent)

## Related Toolkits

- [Reddit](https://composio.dev/toolkits/reddit) - Reddit is a social news platform with thriving user-driven communities (subreddits). It's the go-to place for discussion, content sharing, and viral marketing.
- [Facebook](https://composio.dev/toolkits/facebook) - Facebook is a social media and advertising platform for businesses and creators. It helps you connect, share, and manage content across your public Facebook Pages.
- [Linkedin](https://composio.dev/toolkits/linkedin) - LinkedIn is a professional networking platform for connecting, sharing content, and engaging with business opportunities. It's the go-to place for building your professional brand and unlocking new career connections.
- [Active campaign](https://composio.dev/toolkits/active_campaign) - ActiveCampaign is a marketing automation and CRM platform for managing email campaigns, sales pipelines, and customer segmentation. It helps businesses engage customers and drive growth through smart automation and targeted outreach.
- [ActiveTrail](https://composio.dev/toolkits/active_trail) - ActiveTrail is a user-friendly email marketing and automation platform. It helps you reach subscribers and automate campaigns with ease.
- [Adobe Marketing Agent MCP](https://composio.dev/toolkits/adobe_marketing_agent_mcp) - Adobe Marketing Agent MCP is Adobe's hosted MCP service that exposes marketing context, preferences, and agent capabilities. Use it to provide agents with campaign, audience, and analytics context via a managed integration.
- [Ahrefs](https://composio.dev/toolkits/ahrefs) - Ahrefs is an SEO and marketing platform for site audits, keyword research, and competitor insights. It helps you improve search rankings and drive organic traffic.
- [AimTell](https://composio.dev/toolkits/aimtell) - AimTell is a web push notification platform for managing websites, subscribers, campaigns, segments, and delivery analytics. Use it to send targeted browser notifications and measure engagement across your web push campaigns.
- [Amcards](https://composio.dev/toolkits/amcards) - AMCards lets you create and mail personalized greeting cards online. Build stronger customer relationships with easy, automated card campaigns.
- [AWeber](https://composio.dev/toolkits/aweber) - AWeber is an email marketing platform for creating campaigns, lists, and landing pages. It helps businesses automate email outreach and measure subscriber engagement.
- [Beamer](https://composio.dev/toolkits/beamer) - Beamer is a news and changelog platform for in-app announcements and feature updates. It helps companies boost user engagement by sharing news where users are most active.
- [Beehiiv](https://composio.dev/toolkits/beehiiv) - Beehiiv is a newsletter platform for creating and managing publications and subscribers. It helps grow audience engagement and monetize your mailing list.
- [Benchmark email](https://composio.dev/toolkits/benchmark_email) - Benchmark Email is a platform for creating, sending, and tracking email campaigns. It's built to help you engage audiences and analyze results—all in one place.
- [Bigmailer](https://composio.dev/toolkits/bigmailer) - BigMailer is an email marketing platform for managing multiple brands with white-labeling and automation. It helps teams streamline campaigns and simplify integration with Amazon SES.
- [Bitly](https://composio.dev/toolkits/bitly) - Bitly is a link management platform for shortening, customizing, sharing, and tracking links and QR codes. It helps teams create branded links and measure engagement across campaigns.
- [BlueFox Email](https://composio.dev/toolkits/bluefox_email) - BlueFox Email is an email API for managing contacts, subscriber lists, and sending transactional and triggered messages. Use it to reliably send transactional and triggered emails and manage subscribers at scale.
- [Brandfetch](https://composio.dev/toolkits/brandfetch) - Brandfetch is an API that delivers company logos, colors, and visual branding assets. It helps marketers and developers keep brand visuals consistent everywhere.
- [Braze](https://composio.dev/toolkits/braze) - Braze is a customer engagement platform for managing user data, messaging, campaigns, and analytics. Use it to deliver targeted, multi-channel messaging and analyze campaign performance.
- [Brevo](https://composio.dev/toolkits/brevo) - Brevo is an all-in-one email and SMS marketing platform for transactional messaging, automation, and CRM. It helps businesses engage customers and streamline communications through powerful campaign tools.
- [Buffer](https://composio.dev/toolkits/buffer) - Buffer is a social media management platform for planning, creating, scheduling, and publishing posts across connected channels. It helps teams keep content organized and publish consistently without jumping between social apps.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and AppFollow MCP?

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

### Can I use Tool Router MCP with Atomic Agent?

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 AppFollow tools.

### Can I manage the permissions and scopes for AppFollow while using Tool Router?

Yes, absolutely. You can configure which AppFollow 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.

### How safe is my data with Composio Tool Router?

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 AppFollow data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)
