SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Imply Polaris MCP with Atomic Agent

Connect Atomic Agent to Imply Polaris MCP. Query today's event counts by source, compare hourly traffic across data streams, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Imply Polaris logoImply Polaris
Api KeyS2s Oauth2

Imply Polaris is a fully managed real-time analytics platform for event data. It helps teams ingest, query, and visualize live data at scale.

108 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 Imply Polaris.

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

Also integrate Imply Polaris with

ChatGPTClaude CoworkHermes

How Atomic Agent connects to Imply Polaris

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

The Imply Polaris MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Imply Polaris account. It provides structured and secure access to analytics projects, data connections, queries, dashboards, alerts, reports, and data models, so your agent can manage analytics resources, monitor SQL queries, retrieve results, create visualizations, and configure alerts on your behalf.

  • Analytics project management: Have your agent create or delete Imply Polaris projects and retrieve connection metadata for configuring access to data sources.
  • Data ingestion and modeling: Direct your agent to create, inspect, or delete data connections, tables, jobs, lookups, data cubes, dimensions, and measures.
  • SQL query monitoring: Let the agent check asynchronous SQL query status, retrieve query results, or cancel queries that are no longer needed.
  • Dashboards and reporting: Instruct your agent to create, inspect, or delete dashboards and dashboard pages, add or remove visualization tiles, and create or delete reports.
  • Alerts and embedded analytics: Have your agent create, inspect, evaluate, or delete alerts, and manage embedding links and their secret keys for sharing Polaris analytics.

Use Imply Polaris from Atomic Agent

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

Cancel Async Sql Query

Cancel an async query in the project configured on the connected Imply Polaris account.

Cancel Job

Irreversibly cancel a Polaris ingestion job.

Create Alert

Create an alert in the project configured on the connected Imply Polaris account.

Create Connection

Create an Azure, Confluent, Schema Registry, Kafka, Kinesis, push-streaming, or S3 connection in the project configured on the connected Imply Polaris account.

Create Dashboard

Create a dashboard in the project configured on the connected Imply Polaris account.

Create Dashboard Page

Create a dashboard page in the project configured on the connected Imply Polaris account.

Create Dashboard Page Tile

Create a blank, Markdown, or data-cube visualization tile on a dashboard page.

Create Data Cube

Create a data cube in the project configured on the connected Imply Polaris account.

Create Data Cube Dimension

Create a data cube dimension in the project configured on the connected Imply Polaris account.

Create Data Cube Measure

Create a data cube measure in the project configured on the connected Imply Polaris account.

Create Embedding Link

Create an embedding link in the project configured on the connected Imply Polaris account.

Create Embedding Link Secret Key

Create a secret key for an embedding link in the project configured on the connected Imply Polaris account.

Create Job

Create a job in the project configured on the connected Imply Polaris account.

Create Lookup

Create a lookup in the project configured on the connected Imply Polaris account.

Create Project

Create a project through the connected Imply Polaris regional API.

Create Report

Create a report in the project configured on the connected Imply Polaris account.

Create Table

Create a table in the project configured on the connected Imply Polaris account.

Delete Alert

Delete an alert in the project configured on the connected Imply Polaris account.

Delete Connection

Delete a connection in the project configured on the connected Imply Polaris account.

Delete Dashboard

Delete a dashboard in the project configured on the connected Imply Polaris account.

Delete Dashboard Page

Delete a page in the project configured on the connected Imply Polaris account.

Delete Dashboard Page Tile

Delete a tile in the project configured on the connected Imply Polaris account.

Delete Data Cube

Delete a data cube in the project configured on the connected Imply Polaris account.

Delete Data Cube Dimension

Delete a dimension in the project configured on the connected Imply Polaris account.

Delete Data Cube Measure

Delete a measure in the project configured on the connected Imply Polaris account.

Delete Embedding Link

Delete an embedding link in the project configured on the connected Imply Polaris account.

Delete Embedding Link Secret Key

Delete a secret key for an embedding link in the project configured on the connected Imply Polaris account.

Delete File

Delete a file in the project configured on the connected Imply Polaris account.

Delete Lookup

Delete a lookup in the project configured on the connected Imply Polaris account.

Delete Project

Delete a project through the connected Imply Polaris regional API.

Delete Report

Delete a report in the project configured on the connected Imply Polaris account.

Get Alert

Get alert details in the project configured on the connected Imply Polaris account.

Get Alert Evaluation

Get alert evaluation details in the project configured on the connected Imply Polaris account.

Get Async Sql Results

Get one result page for an async query, or omit cursor to return all pages sequentially.

Get Async Sql Status

Get status of an async query in the project configured on the connected Imply Polaris account.

Get Connection

Get connection details in the project configured on the connected Imply Polaris account.

Get Connection Metadata

Get project-level connection metadata: the external ID and Imply AWS IAM role ARN used when granting Polaris access to AWS resources.

Get Dashboard

Get dashboard details in the project configured on the connected Imply Polaris account.

Get Dashboard Page

Get page details in the project configured on the connected Imply Polaris account.

Get Dashboard Page Tile

Get tile details in the project configured on the connected Imply Polaris account.

Get Data Cube

Get data cube details in the project configured on the connected Imply Polaris account.

Get Data Cube Dimension

Get dimension details in the project configured on the connected Imply Polaris account.

Get Data Cube Measure

Get measure details in the project configured on the connected Imply Polaris account.

Get Embedding Link

Get embedding link details in the project configured on the connected Imply Polaris account.

Get File Metadata

Get file details in the project configured on the connected Imply Polaris account.

Get Job

Get job details in the project configured on the connected Imply Polaris account.

Get Job Logs

Get job logs in the project configured on the connected Imply Polaris account.

Get Job Metrics

Get job metrics in the project configured on the connected Imply Polaris account.

Get Job Progress

Get job overall progress in the project configured on the connected Imply Polaris account.

Get Job Status

Get job execution status in the project configured on the connected Imply Polaris account.

Get Lookup

Get lookup details in the project configured on the connected Imply Polaris account.

Get Network Policy

Get whether the project's regional API IP allowlist is enabled and return entries keyed by IPv4 address or CIDR.

Get Project

Get project details through the connected Imply Polaris regional API.

Get Report

Get report details in the project configured on the connected Imply Polaris account.

Get Report Evaluation

Get report evaluation details in the project configured on the connected Imply Polaris account.

Get Table

Get table details in the project configured on the connected Imply Polaris account.

List Alert Evaluations

Get alert evaluations in the project configured on the connected Imply Polaris account.

List Alerts

List all alerts in the project configured on the connected Imply Polaris account.

List Connections

List all connections in the project configured on the connected Imply Polaris account.

List Dashboard Data Cubes

Get dashboard data cubes in the project configured on the connected Imply Polaris account.

List Dashboard Pages

Get dashboard pages in the project configured on the connected Imply Polaris account.

List Dashboard Page Tiles

Get dashboard page tiles in the project configured on the connected Imply Polaris account.

List Dashboards

List all dashboards in the project configured on the connected Imply Polaris account.

List Data Cube Dimensions

Get data cube dimensions in the project configured on the connected Imply Polaris account.

List Data Cube Measures

Get data cube measures in the project configured on the connected Imply Polaris account.

List Data Cubes

List all data cubes in the project configured on the connected Imply Polaris account.

List Embedding Links

Get embedding links in the project configured on the connected Imply Polaris account.

List Files

List one offset-based page of files.

List Jobs

List one page of jobs in the project configured on the connected Imply Polaris account, with a cursor when more results are available.

List Lookup Aliases

List all aliases for a lookup in the project configured on the connected Imply Polaris account.

List Lookups

List all lookups in the project configured on the connected Imply Polaris account.

List Report Evaluations

Get report evaluations in the project configured on the connected Imply Polaris account.

List Reports

List all reports in the project configured on the connected Imply Polaris account.

List Tables

List all tables in a project in the project configured on the connected Imply Polaris account.

List Unused Table Segments

List one page of unused table segments, with a cursor when another page may be available.

Push Connection Events

Push events to a Polaris connection in the project configured on the connected Imply Polaris account.

Replace Alert

Replace the complete alert in the project configured on the connected Imply Polaris account.

Replace Dashboard

Replace the complete dashboard in the project configured on the connected Imply Polaris account.

Replace Dashboard Page

Replace the complete page in the project configured on the connected Imply Polaris account.

Replace Dashboard Page Tile

Replace the complete tile in the project configured on the connected Imply Polaris account.

Replace Data Cube

Replace the complete data cube in the project configured on the connected Imply Polaris account.

Replace Data Cube Dimension

Replace the complete dimension in the project configured on the connected Imply Polaris account.

Replace Data Cube Measure

Replace the complete measure in the project configured on the connected Imply Polaris account.

Replace Embedding Link

Replace the complete embedding link in the project configured on the connected Imply Polaris account.

Replace Report

Replace the complete report in the project configured on the connected Imply Polaris account.

Replace Table

Replace the complete table in the project configured on the connected Imply Polaris account.

Reset Job

Reset job to apply streaming ingestion offset in the project configured on the connected Imply Polaris account.

Run Job

Start or resume a Polaris ingestion job.

Run Sql Query

Query precached data in the project configured on the connected Imply Polaris account.

Start Async SQL Ingestion

Irreversibly insert or replace table data by starting an asynchronous SQL ingestion job.

Start Async Sql Query

Start a read-only SELECT query asynchronously.

Suspend Job

Pause a running Polaris ingestion job so it can be resumed later.

Test Connection

Test a connection in the project configured on the connected Imply Polaris account.

Update Alert

Update specified alert properties in the project configured on the connected Imply Polaris account.

Update Connection

Update a connection in the project configured on the connected Imply Polaris account.

Update Dashboard

Update specified dashboard properties in the project configured on the connected Imply Polaris account.

Update Dashboard Page

Update specified page properties in the project configured on the connected Imply Polaris account.

Update Dashboard Page Tile

Update specified tile properties in the project configured on the connected Imply Polaris account.

Update Data Cube

Update specified data cube properties in the project configured on the connected Imply Polaris account.

Update Data Cube Dimension

Update specified dimension properties in the project configured on the connected Imply Polaris account.

Update Data Cube Measure

Update specified measure properties in the project configured on the connected Imply Polaris account.

Update Embedding Link

Update specified embedding link properties in the project configured on the connected Imply Polaris account.

Update Lookup

Update a lookup in the project configured on the connected Imply Polaris account.

Update Network Policy

Enable or disable the project's regional API IP allowlist and set entries keyed by IPv4 address or CIDR.

Update Project

Update a project through the connected Imply Polaris regional API.

Update Report

Update specified report properties in the project configured on the connected Imply Polaris account.

Upload File

Upload a file in the project configured on the connected Imply Polaris account.

Upsert Lookup Aliases

Create or update aliases for a lookup in the project configured on the connected Imply Polaris account.

FRAMEWORKS

How to build Imply Polaris MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Imply Polaris MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use Imply Polaris MCP with Claude Cowork

Hermes logo

Hermes

Use Imply Polaris MCP with Hermes

FAQ

Frequently asked questions

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

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

Start with Imply Polaris.It takes 30 seconds.

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

Start building