How to integrate Faraday MCP with Atomic Agent

Connect Atomic Agent to Faraday MCP. Enrich salesforce leads with predictive insights, automate email categorization using faraday ai, and more using natural language, with authentication handled for you.

Faraday logoFaraday
Api Key

Faraday lets you embed AI in workflows across your stack for smarter automation. It boosts your favorite tools with actionable intelligence and seamless integration.

117 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 Faraday.

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 Faraday 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 Faraday with

How Atomic Agent connects to Faraday

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

The Faraday MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Faraday account. It provides structured and secure access to your cohorts, datasets, outcomes, persona sets, scopes, targets, connections, and account details, so your agent can create resources, review configurations, update settings, trigger reruns, and remove resources on your behalf.

  • Cohort management: Have your agent create cohorts, review and update their configurations, trigger reruns, or delete cohorts you no longer need.
  • Dataset and connection access: Let the agent create and retrieve datasets, list configured connections, and check your current account or billing information.
  • Outcome planning: Direct your agent to create outcomes, inspect or revise their configurations, trigger reruns, and remove outdated outcomes.
  • Persona and scope organization: Instruct your agent to create and review persona sets, then create, inspect, update, rerun, or delete scopes.
  • Target management: Have your agent create targets, list or inspect existing targets, update their configurations, and trigger reruns when needed.

Use Faraday from Atomic Agent

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

Archive Cohort

Archive a Faraday cohort, optionally cascading the archive to downstream resources.

Archive Connection

Archive a Faraday connection, optionally cascading the archive to downstream resources.

Archive Dataset

Tool to archive a dataset in Faraday.

Archive Outcome

Archive a Faraday outcome, optionally cascading the archive to downstream resources.

Archive Persona Set

Archive a Faraday persona set, optionally cascading the archive to downstream resources.

Archive Place

Archive a Faraday place, optionally cascading the archive to downstream resources.

Archive Scope

Archive a Faraday scope, optionally cascading the archive to downstream resources.

Archive Stream

Tool to archive a stream in Faraday.

Archive Target

Tool to archive a target in Faraday.

Archive Trait

Archive a Faraday trait to stop its updates while keeping it visible.

Create Account

Tool to create a new Faraday account with specified name and branding.

Create Cohorts

Tool to create a new cohort in Faraday.

Create Dataset

Create a Faraday dataset with identity mappings and limited source options, including hosted CSV upload directory and delimiter.

Create Outcome

Tool to create a new outcome.

Create Persona Set

Tool to create a new persona set.

Create Place

Create a place from addresses or GeoJSON for use as a spatial filter.

Create Scope

Tool to create a new scope in Faraday.

Create Stream

Tool to create a new stream or find an existing stream by name.

Create Target Preview

Tool to start a preview delivery for a target.

Create Target

Tool to create a target in Faraday.

Create Trait

Tool to create a new trait in Faraday.

Create Webhook Endpoint

Tool to create a new webhook endpoint.

Delete Account

Tool to delete an account by its UUID.

Delete All Orphaned Traits

Tool to delete all orphaned traits from Faraday.

Delete Cohort

Tool to permanently delete a cohort from Faraday.

Delete Connection

Tool to delete a Faraday connection by its UUID.

Delete Dataset

Tool to delete a dataset from Faraday.

Delete Outcome

Tool to delete an outcome by its UUID.

Delete Persona Set

Tool to delete a persona set.

Delete Place

Tool to delete a place by its UUID.

Delete Scope

Tool to delete a scope by its UUID.

Delete Stream

Delete a stream by its UUID or name.

Delete Target

Tool to delete a target by its UUID.

Delete Upload

Permanently deletes a file from a Faraday dataset directory.

Delete Webhook Endpoint

Delete a Faraday webhook endpoint by its UUID.

Force Update Cohort

Tool to trigger a rerun for a cohort.

Force Update Connection

Tool to trigger a rerun for a Faraday connection.

Force Update Dataset

Trigger a rerun for a dataset rather than waiting for its normal update schedule.

Force Update Outcome

Tool to trigger a rerun for an outcome resource.

Force Update Persona Set

Tool to trigger a rerun for a persona set resource.

Force Update Place

Tool to trigger a rerun for a place.

Force Update Scope

Tool to trigger a rerun for a scope resource.

Force Update Stream

Tool to trigger a rerun for a stream.

Force Update Target

Tool to trigger a rerun for a target.

Force Update Trait

Tool to trigger a rerun for a trait.

Get Account

Tool to retrieve detailed information about a Faraday account by its UUID.

List Accounts

Tool to list all Faraday accounts accessible by the current user.

Get Accounts Billing

Tool to get billing information about your account.

Get Cohort

Tool to retrieve a specific cohort by ID.

Get Cohort Membership Analysis

Tool to get cohort membership counts over time for a specific cohort.

List Cohorts

Tool to list all cohorts in your Faraday account.

Get Connection Datasets

Tool to retrieve all datasets that use a specific connection.

Get Connection Targets

Tool to retrieve all targets that use a specific connection.

Get Current Account

Tool to retrieve the current account information.

Get Current Account Billing

Tool to retrieve billing information about the current account.

Get Dataset

Tool to retrieve a dataset by its UUID.

Get Dataset Ingress Logs

Tool to retrieve dataset ingress metrics over time.

List Feature Stores

Tool to list all feature stores.

Get Dependency Graph

Tool to retrieve the complete dependency graph for all resources on an account.

Get Market Opportunity Analyses

Tool to retrieve all market opportunity analyses from Faraday.

Get Outcome

Tool to retrieve an outcome by its ID.

List Outcomes

Tool to list all outcomes for the account.

Get Persona Set

Tool to retrieve a persona set by its UUID.

Get Persona Set Analysis Flow

Retrieve persona membership counts over time for a persona set.

List Persona Sets

Tool to list all persona sets.

Get Persona Set Analysis Dimensions

Retrieve analysis dimensions for the personas in a persona set to examine their characteristics and distributions.

Get Place

Tool to retrieve a specific place by its UUID.

List Places

List Faraday places used as geospatial filters, with their status and configuration.

List Recommenders

Tool to list all recommenders.

Get Scope

Tool to retrieve detailed information about a Faraday scope by its UUID.

Get Scope Analysis

Tool to get analysis for a scope including outcomes and recommenders with probability distributions.

Get Scope Datasets

Tool to retrieve all datasets associated with a Faraday scope.

Get Scope Efficacy

Retrieve outcome efficacy metrics for a scope, including monthly attainment and performance comparisons.

Get Scope Payload Cohorts

Tool to get payload cohorts for a specific scope.

Get Scope Payload Outcomes

Retrieve outcome resources configured in a specific scope's payload, including their model configuration and available summary metrics.

Get Scope Payload Persona Sets

Tool to get payload persona sets for a specific scope.

Get Scope Payload Recommenders

Tool to retrieve payload recommenders for a specific scope.

Get Scope Population Exclusion Cohorts

Tool to get population exclusion cohorts for a scope.

Get Scope Population Cohorts

Tool to get population cohorts for a specific scope.

Get Scope Targets

Tool to get all targets for a specific scope.

Get Stream

Tool to retrieve a stream by its UUID or name.

List Streams

Tool to list all streams in your Faraday account.

Get Streams Analysis

Tool to get the count of stream events emitted over a time period.

Get Target

Tool to retrieve a specific target by its UUID from Faraday.

Get Target Analysis

Tool to retrieve a target's analysis including geographic distributions and trait breakdowns.

Get Trait

Tool to retrieve a specific trait by ID.

Get Trait Analysis Dimensions

Tool to retrieve the percentage of the US population that falls into each category of a trait.

Get Traits CSV

Tool to retrieve all user-defined and Faraday-provided traits in CSV format.

Get Upload

Tool to download a previously uploaded file from a Faraday dataset directory.

List Uploaded Files

Tool to retrieve the list of previously uploaded files in Faraday.

Get Usages

Tool to retrieve usage statistics for your Faraday account.

Get Webhook Endpoint

Retrieve a webhook endpoint by its UUID, including its URL, status and enabled events.

List Webhook Endpoints

Tool to list all webhook endpoints configured for the account.

List Attributes

Tool to list all attributes in the feature store.

List Connections

Tool to list all connections configured in Faraday.

List Scopes

Tool to list all scopes.

List Targets

Tool to list all targets in your Faraday account.

Unarchive Cohort

Tool to unarchive a previously archived cohort.

Unarchive Dataset

Tool to unarchive a dataset in Faraday.

Unarchive Outcome

Unarchive an outcome in Faraday to restore updates, optionally cascading to upstream resources.

Unarchive Persona Set

Tool to unarchive a previously archived persona set.

Unarchive Place

Tool to unarchive a previously archived place.

Unarchive Scope

Tool to unarchive a previously archived scope.

Unarchive Stream

Tool to unarchive a stream in Faraday.

Unarchive Trait

Tool to unarchive a trait.

Update Account

Tool to update an account's name or branding settings.

Update Cohort

Tool to update a cohort's configuration using JSON Merge Patch semantics.

Update Connection

Tool to update a Faraday connection's name or options.

Update Dataset

Tool to update a dataset configuration using JSON Merge Patch semantics.

Update Outcome

Update an outcome's configuration by ID, including its name, cohorts, bias mitigation, feature blocklist, prediction mode, predictors, or preview status.

Update Persona Set

Update a persona set's name, cluster count, or preview mode; the deprecated explore setting can also be submitted but has no effect.

Update Place

Update a place's name, addresses, or GeoJSON geometry.

Update Scope

Update a Faraday scope's name, payload settings, population cohorts, or preview status.

Update Stream

Update a stream's metadata or properties by UUID or name using JSON Merge Patch.

Update Target

Tool to update a target's configuration in Faraday.

Update Trait

Tool to update a trait's properties using JSON Merge Patch semantics.

Update Webhook Endpoint

Tool to update a webhook endpoint's configuration.

FAQ

Frequently asked questions

Start with Faraday.It takes 30 seconds.

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

Start building