How to integrate AirOps MCP with Atomic Agent

Connect Atomic Agent to AirOps MCP. Summarize brand guidelines changes this week, list knowledge base articles about returns, and more using natural language, with authentication handled for you.

AirOps MCP logoAirOps MCP
Dcr Oauth

AirOps MCP is AirOps' managed content platform exposing brand context, knowledge bases, and workflows. Use it to give agents brand-aware content, automate content workflows, and track Brand Kit edits.

91 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 AirOps.

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

Also integrate AirOps MCP with

How Atomic Agent connects to AirOps

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

The AirOps MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your AirOps account. It provides structured and secure access so your agent can perform AirOps operations on your behalf.

Use AirOps from Atomic Agent

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

Accept opportunity

Accept pending opportunities for a campaign and add them to the campaign action grid.

Add aeo region

Add a region (ISO alpha-2 country code) to a Brand Kit's configured AEO regions.

Add grid column

Add a new column to a grid table.

Analytics chart

Query analytics data and display it as an interactive chart.

Automated feedback report

**AirOps only feedback tool.

Bulk update aeo prompt tags

Apply a single tag operation (add or remove) to a batch of AEO prompts in one Brand Kit, atomically.

Bulk update aeo prompt topics

Reassign a batch of AEO prompts to an existing topic in one Brand Kit.

Commit aeo prompt assignments

Commit the current prompt-assignment draft for a Brand Kit to live.

Create action grid

Create a grid pre-wired with power steps to take action on AEO insights.

Create aeo persona

Create a new AEO persona on a Brand Kit.

Create aeo prompt

Create a new AEO prompt for a Brand Kit.

Create aeo tag

Create a new AEO tag on a Brand Kit.

Create brand kit direct upload

Initiate a direct file upload for use with Brand Kit visual tools.

Create brand kit recap entry

Record a recap entry summarizing the changes you made to a Brand Kit.

Create grid

Create a new empty, general-purpose grid with the given name.

Create grid sheet

Create a new sheet (grid table) within an existing grid.

Create opportunity

Create a pending opportunity for a campaign.

Create page

Add a web page to a Brand Kit's AEO pages.

Create topic

Create a new AEO topic on a Brand Kit.

Delete aeo prompt

Delete an AEO prompt from a Brand Kit.

Delete aeo tag

Delete an AEO tag from a Brand Kit.

Delete brand kit writing rules

Delete one or more writing rules from a Brand Kit.

Delete topic

Delete an AEO topic from a Brand Kit.

Discard aeo prompt assignments

Discard the current prompt-assignment draft for a Brand Kit.

Get aeo citation

Get prompts citing a specific URL.

Get aeo page content update

Get a specific page content update by ID.

Get aeo prompt assignments status

Inspect the current prompt-assignment draft state for a Brand Kit without modifying anything.

Get answer

Get a specific AI answer by ID with full text content.

Get brand kit

Fetch a Brand Kit's brand identity (writing_tone, writing_persona) and associated entities (product lines, audiences, content types, regions, writing rules, custom variables, visual/design assets).

Get campaign

Get a campaign by ID, including action grid IDs needed to inspect or update its grid.

Get insights settings

Get AEO insights configuration for a Brand Kit, this includes the relevant information to use any AEO and analytics tools.

Get page details

Get AEO metrics for a specific web page.

Get page prompts

Get prompts citing a specific web page.

Get prompt answers

Get AI answers for a specific prompt/question.

Get report

Get a specific report by ID with its module configurations.

Get sentiment theme answers

Get individual AI answers with sentiment details for a specific theme.

Knowledge base add file

Step 2 of the two-step file ingestion flow for a Knowledge Base.

Knowledge base add urls

Bulk-ingest one or more web pages into a Knowledge Base.

Knowledge base create direct upload

Initiate a direct file upload for a Knowledge Base.

Knowledge base delete

Permanently delete a Knowledge Base and ALL of its documents.

Knowledge base delete document

Permanently delete a single document from a Knowledge Base.

Knowledge base get document

Read the full reconstructed text content of a Knowledge Base document end-to-end — the loader-extracted text from every chunk concatenated in `position` order.

Knowledge base get status

Get the indexing status of a Knowledge Base and its documents.

Knowledge base manage

Create or update a Knowledge Base.

Knowledge base update document metadata

Replace a document's user-facing metadata in full.

List aeo citations

List citations (URLs) with metrics for a Brand Kit.

List aeo domains

List domains cited in AI answers for a Brand Kit.

List aeo page content updates

List page content updates for a workspace.

List aeo prompts

List AEO prompts for a specific Brand Kit.

List answers

List AI answers for a brand kit with filters for date range, providers, countries, prompt_id, and brand_mentioned.

List brand kits

List all Brand Kits the user has access to.

List campaigns

List campaigns the authenticated user has access to.

List grids

List grids the authenticated user has access to.

List knowledge bases

List all Knowledge Bases the authenticated user has access to.

List opportunities

List opportunities for a campaign.

List pages

List web pages with daily metrics (AEO citations, GSC clicks/impressions, GA4 traffic, and configured GA4 key events) for a brand kit.

List personas

List personas for a specific Brand Kit.

List reports

List saved analytics reports for a specific Brand Kit.

List tags

List tags for a specific Brand Kit.

List topics

List topics for a specific Brand Kit.

List workspaces

List all workspaces the authenticated user has access to.

Manage brand kit audience

Create or update an audience for a Brand Kit draft.

Manage brand kit competitor

Create or update a competitor for a Brand Kit.

Manage brand kit content sample

Create or update a content sample for a Brand Kit.

Manage brand kit content type

Create or update a content type for a Brand Kit.

Manage brand kit custom variable

Before creating a custom variable, you MUST analyze the user's intent and suggest the appropriate Brand Kit dimension instead.

Manage brand kit font

Create or update a font for a Brand Kit.

Manage brand kit logo size

Create or update a logo size for a Brand Kit.

Manage brand kit logo variant

Create or update a logo variant for a Brand Kit.

Manage brand kit palette

Create or update a color palette for a Brand Kit.

Manage brand kit palette color

Create or update a color within a Brand Kit palette.

Manage brand kit product line

Create or update a product line for a Brand Kit.

Manage brand kit region

Create or update a region for a Brand Kit.

Manage brand kit type size

Create or update a type size for a Brand Kit.

Manage brand kit usage rule

Create or update a usage rule for a Brand Kit.

Manage brand kit visual example

Create or update a visual example for a Brand Kit's Data Visualization section.

Manage brand kit visual use case

Create or update a Visual Use Case for a Brand Kit.

Manage brand kit writing rule

Create or update a writing rule for a Brand Kit.

Publish brand kit

Publish a Brand Kit's current draft so changes become active.

Query analytics

Query analytics data for a Brand Kit with flexible metrics, dimensions, and filters.

Read grid

Read rows from a grid table.

Read grid cell

Read the full value of a single grid cell.

Reject opportunity

Reject pending opportunities for a campaign.

Search knowledge base

Search a Knowledge Base for relevant content using semantic similarity.

Suggest brand kit edits

Suggest edits to a Brand Kit's fields without applying them.

Track aeo page content update

Track a page content update (publish/refresh) to correlate future analytics with content changes.

Update aeo prompt assignments

Update the country, persona, and platform assignments of one or more existing AEO prompts on a Brand Kit.

Update aeo tag

Update an existing AEO tag's name and/or color on a Brand Kit.

Update brand kit

Update a Brand Kit's base fields.

Update topic

Update an existing AEO topic's name and/or color on a Brand Kit.

Write grid

Create or update rows in a grid table.

FAQ

Frequently asked questions

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

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

Start with AirOps MCP.It takes 30 seconds.

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

Start building