SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Anaplan MCP with Atomic Agent

Connect Atomic Agent to Anaplan MCP. List available anaplan models in workspace, review recent anaplan audit events, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Anaplan logoAnaplan
Oauth2

Anaplan is a connected planning platform for models, data integration, and enterprise planning. It helps teams align plans, data, and decisions across the business.

113 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,700+ apps through Composio, including Anaplan.

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

Also integrate Anaplan with

ChatGPTClaude CoworkHermes

How Atomic Agent connects to Anaplan

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

The Anaplan MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Anaplan account. It provides structured and secure access to Anaplan models, model files, imports, exports, tasks, revisions, and user administration, so your agent can inspect models, move data through imports and exports, monitor or cancel tasks, manage model revisions, and administer users on your behalf.

  • Model and workspace management: Have your agent retrieve model details, inspect model actions, close models, manage model files, and change items in model lists.
  • Data imports and exports: Direct your agent to inspect import and export definitions, monitor data transfer tasks, download complete model files, and retrieve failure dumps when an import fails.
  • Task monitoring and control: Let the agent track action, import, export, and process tasks, review their progress and results, cancel running tasks, and download optimizer logs or failure data.
  • Application lifecycle management: Instruct your agent to create model revisions, retrieve the latest revision, and get structural comparison or summary reports between model revisions.
  • User administration: Have your agent retrieve the connected Anaplan user or create SCIM users with workspace entitlements.

Use Anaplan from Atomic Agent

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

Cancel Action Task

Cancel an action task in an Anaplan model.

Cancel Export Task

Cancel an ongoing Anaplan export task.

Cancel Import Task

Cancel an ongoing Anaplan import task.

Cancel Large List Read

Cancel and delete an Anaplan large-list read request.

Cancel Large View Read

Cancel an asynchronous large-view read request.

Cancel Process Task

Cancel an ongoing Anaplan process task.

Change Model List Items

Add items to an Anaplan model list or irreversibly delete up to 100,000 items by ID or code.

Close Model

Close an Anaplan model and return an empty success result.

Complete File Upload

Mark an Anaplan chunked model-file upload as complete.

Create Model Revision

Create an ALM revision for an Anaplan model.

Create SCIM User

Create an Anaplan SCIM user and assign up to 50 workspace entitlements.

Delete Model File

Delete a file from an Anaplan workspace model.

Delete Models

Permanently delete multiple models from an Anaplan workspace.

Download Complete Import Dump

List every chunk of an Anaplan import failure dump, download them sequentially, and return one bounded CSV file.

Download Complete Large View

Read Anaplan's availablePages count, download every zero-based large-view page in order, and return one bounded CSV file.

Download Complete Model File

List every documented chunk of an Anaplan model file, download them in numeric order, and return one bounded file.

Download Complete Process Dump

List every chunk of an Anaplan process failure dump, download them sequentially, and return one bounded CSV file.

Download File Chunk

Download one binary or CSV chunk from an Anaplan model file.

Download Import Dump Chunk

Download one chunk of an import failure dump using the connected user's Anaplan permissions.

Download Large List Page

Download one available CSV page from a completed large-list read.

Download Large List Preview

Download a CSV preview of a large Anaplan list.

Download Large View Page

Download one available CSV page from a completed large-view read.

Download Optimizer Log

Download the plain-text solution log for an Anaplan Optimizer action task.

Download Process Dump Chunk

Download one CSV or binary chunk of an Anaplan process failure dump.

Get Action Task

Monitor an Anaplan action task and return its state, progress, result, and failure details when available.

Get ALM Comparison Report

Retrieve the structural comparison report between source and target model revisions.

Get ALM Comparison Report Task

Retrieve state, progress, result, and error details for an ALM comparison report task.

Get ALM Summary Report

Retrieve the structural summary report between source and target model revisions.

Get ALM Summary Report Task

Retrieve state, progress, result, and error details for an ALM summary report task.

Get Current User

Retrieve the Anaplan user represented by the connected account.

Get Export

Get the metadata for an Anaplan export definition.

Get Export Task

Monitor an Anaplan export task and return its state, progress, and result.

Get Import

Get the metadata for an Anaplan import definition.

Get Import Failure Dump

Check an import task's dump file for failures using the connected user's Anaplan permissions.

Get Import Task

Monitor an Anaplan import task and return its state, progress, result, and failure details when available.

Get Large List Read

Retrieve the status and available pages of an Anaplan large-list read request.

Get Large View Read

Retrieve the status and available pages of a large-view read request.

Get Latest Model Revision

Retrieve the latest ALM revision for an Anaplan model.

Get Model

Get metadata for one Anaplan model.

Get Model Action

Retrieve metadata for a specific action definition in an Anaplan model.

Get Model Current Period

Retrieve the current period for an Anaplan model.

Get Model Fiscal Year

Get the current fiscal year from an Anaplan model calendar.

Get Model List

Retrieve metadata for one list in an Anaplan model.

Get Model Status

Check an Anaplan model's open or opening status and progress.

Get Model Sync Task

Retrieve state, progress, result, and error details for an ALM model synchronization task.

Get Process

Retrieve metadata for one Anaplan process.

Get Process Task

Monitor one asynchronous Anaplan process task.

Get SCIM Capabilities

Retrieve Anaplan's SCIM service-provider capabilities.

Get SCIM User

Retrieve one Anaplan SCIM user and their workspace details.

Get User

Retrieve a non-SCIM Anaplan user's ID, active state, email preferences, name, and last login date.

Get View

Retrieve metadata for the dimensions and axes of an Anaplan view.

Get View Data

Retrieve view cell data as structured JSON or a downloadable raw file.

Get Workspace

Retrieve metadata for one Anaplan workspace.

List Action Tasks

List execution tasks for an action in an Anaplan model.

List Audit Events

Retrieve one page of Anaplan audit events of a specified type.

List Dimension Items

Retrieve all items in an Anaplan model dimension.

List Exports

List the available export definitions for an Anaplan model.

List Export Tasks

List the asynchronous tasks for an Anaplan export definition.

List File Chunks

List the chunks associated with an Anaplan model file.

List Import Dump Chunks

Query the chunks available in an import failure dump using the connected user's Anaplan permissions.

List Imports

List the import definitions available for an Anaplan model.

List Import Tasks

List the asynchronous tasks for an Anaplan import definition.

List Line Item Dimension Items

Retrieve items for one dimension of a model line item.

List Line Item Dimensions

Retrieve dimension IDs for a model line item.

List Model Actions

List the action definitions available in an Anaplan model.

List Model Files

List the files available in an Anaplan model.

List Model Line Items

Retrieve line items in a model, optionally including full metadata.

List Model List Items

Retrieve the items in an Anaplan model list, optionally including full metadata.

List Model Lists

Retrieve the lists available in an Anaplan model.

List Model Modules

List the IDs and names of modules in an Anaplan model.

List Models

List models available to the connected Anaplan user.

List Model Sync Tasks

Retrieve ALM synchronization tasks for a target Anaplan model.

List Model Versions

Retrieve version metadata for an Anaplan model.

List Model Views

Retrieve the IDs and names of all views in an Anaplan model.

List Module Line Items

Retrieve line items in a module, optionally including full metadata.

List Module Views

Retrieve the IDs and names of views in an Anaplan module.

List Process Dump Chunks

List chunks available for an Anaplan process failure dump file.

List Processes

List process definitions available in an Anaplan model.

List Process Tasks

List asynchronous tasks for an Anaplan process.

List SCIM Resource Types

Retrieve the SCIM resource types supported by Anaplan.

List SCIM Schemas

Retrieve the SCIM resource schemas and attributes supported by Anaplan.

List SCIM Users

Return one page of Anaplan SCIM users, with an optional continuation cursor.

List Syncable Revisions

Retrieve source-model revisions compatible with a target Anaplan model.

List Users

List Anaplan users available to the connected account.

List View Dimension Items

Retrieve the selected items in a dimension of an Anaplan view.

List Workspace Model Files

List import and export files for an Anaplan workspace model.

List Workspace Models

Retrieve model IDs and optional model details from an Anaplan workspace.

List Workspaces

List the workspaces available to the connected Anaplan user.

Lookup Dimension Items

Look up Anaplan dimension items by name or code.

Open Model

Wake an Anaplan model; HTTP 200 means open and 202 means opening.

Patch SCIM User

Apply ordered SCIM add, replace, or remove operations to an Anaplan user.

Replace SCIM User

Replace an Anaplan SCIM user's details and complete workspace entitlement set; an explicitly empty entitlement list irreversibly removes all current workspace access.

Reset Numbered List Index

Irreversibly reset the index of an Anaplan numbered list.

Search Audit Events

Search Anaplan audit events by lookback interval or explicit time range.

Set File Chunk Count

Set the expected chunk count for an Anaplan model file upload.

Start Action Task

Start an Anaplan action task that may irreversibly change model data, depending on the action definition.

Start ALM Comparison Report Task

Start generation of an ALM comparison report for source and target revisions.

Start ALM Summary Report Task

Start generation of an ALM summary report for source and target revisions.

Start Export Task

Start an Anaplan export and return the asynchronous task acknowledgement.

Start Import Task

Start an Anaplan import that can irreversibly change model data and return the asynchronous task acknowledgement.

Start Large List Read

Initiate an Anaplan large-list read request using a caller-supplied request ID.

Start Large View Read

Start an asynchronous large-view read request.

Start Model Sync Task

Start an ALM synchronization that irreversibly overwrites the target model with the selected source revision.

Start Process Task

Start an Anaplan process that may irreversibly change model data and return its asynchronous task envelope.

Update Model Current Period

Set the current period for an Anaplan model.

Update Model Fiscal Year

Update the current fiscal year for an Anaplan model.

Update Model List Items

Update existing items in an Anaplan model list.

Update Model Online Status

Change whether an Anaplan model is online.

Update Module Cells

Write up to 100,000 cell values or 15 MB by coordinate to an Anaplan module.

Update Version Switchover

Set a version switchover date and return the model metadata envelope.

Upload Chunked Model File

Set open-ended chunk state, upload a complete model file of at most 100 MB in ordered chunks of at most 50 MB, then mark it complete; use the endpoint chunk tools for larger files.

Upload File Chunk

Upload one raw binary chunk for an Anaplan model file.

Upload Model File

Upload an Anaplan model file as one raw binary chunk.

FRAMEWORKS

How to build Anaplan MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Anaplan MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use Anaplan MCP with Claude Cowork

Hermes logo

Hermes

Use Anaplan MCP with Hermes

FAQ

Frequently asked questions

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

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

Start with Anaplan.It takes 30 seconds.

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

Start building