How to integrate Northflank MCP with Atomic Agent

Connect Atomic Agent to Northflank MCP. Deploy a new service to production, list all running deployments in staging, and more using natural language, with authentication handled for you.

Northflank logoNorthflank
Api Key

Northflank is a developer platform that automates and unifies application deployment across clouds. It lets teams deploy, scale, and manage workloads at any scale with minimal setup.

33 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 Northflank.

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

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Northflank with

How Atomic Agent connects to Northflank

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

The Northflank MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Northflank account. It provides structured and secure access to your projects, services, and secrets, so your agent can create projects, review services, manage secrets, and update project settings on your behalf.

  • Project creation and updates: Have your agent create new Northflank projects or update existing projects based on your current deployment needs.
  • Project discovery: Instruct your agent to list your Northflank projects and retrieve detailed information about a specific project.
  • Service visibility: Let the agent list the services within a project so you can quickly review what is running there.
  • Secret management: Direct your agent to create or update secret groups within a Northflank project.
  • Secret review: Have your agent list a project's secrets or retrieve the contents of a specific secret when needed.

Use Northflank from Atomic Agent

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

Create or Update Project

Tool to create a new project or update an existing project in Northflank (upsert operation).

Create or Update Secret

Tool to create or update a secret group in a Northflank project.

Create Secret

Tool to create a secret group in a Northflank project.

Delete Project

Tool to permanently delete a Northflank project and all associated resources.

Get DNS ID

Tool to retrieve the DNS identifier for the authenticated account.

Get Job Logs

Read and filter Northflank job logs, optionally for one run.

Get Job Run

Retrieve status and execution details for one selected job run.

Get Preview Environment Schema

Return Northflank's current JSON Schema for preview environments.

Get Project

Tool to retrieve detailed information about a specific Northflank project.

Get Secret

Tool to retrieve a secret from a Northflank project including its contents.

Get Secret Details

Tool to view a secret with details about its linked addons from a Northflank project.

Get Service

Retrieve one Northflank service's full configuration and current state.

Get Service Logs

Read a Northflank service's logs with range and content filters.

Get Service Metrics

Read selected Northflank service metric time series.

Get Workflow

Retrieve a workflow's metadata, arguments, and complete specification.

Get Workflow Run

Get execution details and node results for one Northflank workflow run.

List Addon Types

Tool to retrieve information about available addon types in Northflank.

List Cloud Provider Node Types

Tool to retrieve supported cloud provider node types available on Northflank.

List Cloud Provider Regions

Tool to retrieve supported cloud provider regions available on Northflank.

List Job Containers

List containers for a Northflank job, optionally restricted to one run.

List Job Runs

List execution history for one Northflank job.

List Pipelines

List pipelines for a Northflank project, with page, cursor, and page-size pagination support.

List Plans

Tool to retrieve available billing/resource plans in Northflank.

List Projects

Tool to list all projects in your Northflank team with pagination support.

List Regions

Tool to retrieve available project regions in Northflank.

List Secrets

Tool to list all secrets belonging to a Northflank project.

List Service Containers

List runtime containers for one Northflank service.

List Services

Tool to list all services belonging to a Northflank project.

List Workflow Runs

List execution history for one workflow in a Northflank project.

Patch Secret

Tool to partially update a secret group in a Northflank project.

Run and Inspect Job

Start a job and return its latest state and logs by the polling timeout.

Update Project

Tool to update a project in Northflank.

Update Secret

Tool to update a secret in a Northflank project.

FAQ

Frequently asked questions

Start with Northflank.It takes 30 seconds.

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

Start building