How to integrate Faraday MCP with Hermes

Connect Hermes 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

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Faraday account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Faraday with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Faraday with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Faraday

Ask your agent to connect to Faraday, or simply request any Faraday-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Faraday connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Faraday or request any Faraday-related task. It will prompt you to authenticate and authorize access.

5. Done!

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.

Way Forward

With Faraday connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

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

With a standalone Faraday MCP server, the agents and LLMs can only access a fixed set of Faraday tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Faraday and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes 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 Faraday tools.

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

Start with Faraday.It takes 30 seconds.

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

Start building