# Faraday — how to use (mcp.ai)

Connect your Faraday account and use 117 tools for artificial intelligence straight from your AI agent. Connect with your own API key. Faraday lets you embed AI in workflows throughout your stack-to make your favorite tools perform even better.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_faraday?ms=1787295780000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `faraday_archive_cohort`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/faraday`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/faraday/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/faraday/archive/cohort` — Tool to archive a cohort in Faraday. Use when you need to stop updates to a cohort while keeping it visible.
  - body: { cohort_id: string, cascade_to?: string[], cascade_to_all?: boolean }
- `POST https://api.mcp.ai/api/faraday/archive/connection` — Tool to archive a connection in Faraday. Use when you need to stop updates to a connection while keeping it visible.
  - body: { cascade_to?: string[], connection_id: string, cascade_to_all?: boolean }
- `POST https://api.mcp.ai/api/faraday/archive/dataset` — Tool to archive a dataset in Faraday. Use when you need to archive a dataset and optionally its downstream resources. Archiving stops updates to the resource but keeps it visible.
  - body: { cascade_to?: string[], dataset_id: string, cascade_to_all?: boolean }
- `POST https://api.mcp.ai/api/faraday/archive/outcome` — Tool to archive an outcome in Faraday. Use when you need to stop updates to an outcome while keeping it visible.
  - body: { cascade_to?: string[], outcome_id: string, cascade_to_all?: boolean }
- `POST https://api.mcp.ai/api/faraday/archive/persona/set` — Tool to archive a persona set in Faraday. Use when you need to stop updates to a persona set while keeping it visible.
  - body: { cascade_to?: string[], cascade_to_all?: boolean, persona_set_id: string }
- `POST https://api.mcp.ai/api/faraday/archive/place` — Tool to archive a place in Faraday. Use when you need to stop updates to a geospatial area or address set while keeping it visible.
  - body: { place_id: string, cascade_to?: string[], cascade_to_all?: boolean }
- `POST https://api.mcp.ai/api/faraday/archive/scope` — Tool to archive a scope in Faraday. Use when you need to stop updates to a scope while keeping it visible.
  - body: { scope_id: string, cascade_to?: string[], cascade_to_all?: boolean }
- `POST https://api.mcp.ai/api/faraday/archive/stream` — Tool to archive a stream in Faraday. Use when you need to archive a stream and optionally its downstream resources. Archiving stops updates to the resource but keeps it visible.
  - body: { cascade_to?: string[], cascade_to_all?: boolean, stream_id_or_name: string }
- `POST https://api.mcp.ai/api/faraday/archive/target` — Tool to archive a target in Faraday. Use when you need to archive a target and optionally its downstream resources. Archiving stops updates to the resource but keeps it visible.
  - body: { target_id: string, cascade_to?: string[], cascade_to_all?: boolean }
- `POST https://api.mcp.ai/api/faraday/archive/trait` — Tool to archive a trait in Faraday. Use when you need to stop updates to a trait while keeping it visible.
  - body: { trait_id: string, cascade_to?: string[], cascade_to_all?: boolean }
- `POST https://api.mcp.ai/api/faraday/create/accounts` — Tool to create a new Faraday account with specified name and branding. Use when you need to provision a new account in Faraday.
  - body: { name: string, branding?: object }
- `POST https://api.mcp.ai/api/faraday/create/cohorts` — Tool to create a new cohort in Faraday. Cohorts are groups of people that share certain traits or behaviors. Use when you need to define a new cohort from your datasets or from Faraday's US Consumer G
  - body: { name: string, traits?: object[], explore?: boolean, recency?: object, max_count?: number, max_value?: number, min_count?: number, min_value?: number, stream_name?: string, place_conditions?: object[], stream_conditions?: object[] }
- `POST https://api.mcp.ai/api/faraday/create/dataset` — Tool to create a new dataset in Faraday. Use when you need to define a new data source for analysis and predictions.
  - body: { name: string, options: object, preview?: boolean, connection_id?: string, identity_sets: object, upsert_columns?: string[], identity_providers?: object[], incremental_column?: string, reference_key_columns?: string[] }
- `POST https://api.mcp.ai/api/faraday/create/outcome` — Tool to create a new outcome. Outcomes are predictions about customer behavior such as likelihood to convert, churn, or purchase specific products. Use when you need to create a new predictive model.
  - body: { name: string, preview?: boolean, predictors?: object, bias_mitigation?: object, prediction_mode?: string, feature_blocklist?: string[], eligible_cohort_id?: string, attrition_cohort_id?: string, attainment_cohort_id: string }
- `POST https://api.mcp.ai/api/faraday/create/persona/set` — Tool to create a new persona set. Persona sets segment cohorts into distinct customer personas based on shared characteristics and behaviors. Use when you need to generate customer personas for a coho
  - body: { name: string, explore?: boolean, preview?: boolean, cohort_id: string, modeling_fields?: string[], number_of_clusters?: integer }
- `POST https://api.mcp.ai/api/faraday/create/place` — Tool to create a new place in Faraday. Places are geospatial areas or sets of addresses that can be used as spatial filters when defining other resources. Use when you need to define a new geographic 
  - body: { name: string, geojson?: object, addresses?: object[] }
- `POST https://api.mcp.ai/api/faraday/create/scopes` — Tool to create a new scope in Faraday. Scopes define the population and payload for predictions, specifying which cohorts to target and what outcomes to include. Use when you need to define output dat
  - body: { name: string, payload: object, preview: boolean, population: object }
- `POST https://api.mcp.ai/api/faraday/create/streams` — Tool to create a new stream or find an existing stream by name. Use when you need to initialize a stream for event data collection.
  - body: { stream_name: string }
- `POST https://api.mcp.ai/api/faraday/create/target/preview` — Tool to start a preview delivery for a target. Use when you need to initiate a preview of target data before full deployment.
  - body: { target_id: string }
- `POST https://api.mcp.ai/api/faraday/create/targets` — Tool to create a target in Faraday. Use when you need to set up a deployment that exports predictions and cohort data to external destinations like CRMs, ad platforms, or data warehouses.
  - body: { name: string, limit?: object, filter?: object, options: object, scope_id: string, connection_id?: string, human_readable?: boolean, representation: object, analysis_config?: object, custom_structure?: object[] }
- `POST https://api.mcp.ai/api/faraday/create/trait` — Tool to create a new trait in Faraday. Use when you need to define a new fact about a person or geographic entity that can be used in modeling, analysis, and reporting.
  - body: { name: string, unit?: string, literate?: string, description?: string, lookup_table?: object, statistical_type?: string }
- `POST https://api.mcp.ai/api/faraday/create/webhook/endpoints` — Tool to create a new webhook endpoint. Use when you need to register a webhook URL to receive notifications when resources are ready or encounter errors.
  - body: { url: string, enabled_events: string[] }
- `POST https://api.mcp.ai/api/faraday/delete/account` — Tool to delete an account by its UUID. Use when you need to permanently remove an account from Faraday. The deletion is scheduled asynchronously and returns a 202 status on success.
  - body: { account_id: string }
- `POST https://api.mcp.ai/api/faraday/delete/all/orphaned/traits` — Tool to delete all orphaned traits from Faraday. Use when you need to clean up traits that are not associated with any source dataset.
- `POST https://api.mcp.ai/api/faraday/delete/cohort` — Tool to permanently delete a cohort from Faraday. Use when you need to remove a cohort that is no longer needed.
  - body: { cohort_id: string }
- `POST https://api.mcp.ai/api/faraday/delete/connection` — Tool to delete a Faraday connection by its UUID. Use when you need to permanently remove a connection.
  - body: { connection_id: string }
- `POST https://api.mcp.ai/api/faraday/delete/dataset` — Tool to delete a dataset from Faraday. Use when you need to remove a dataset permanently. The operation returns success when the dataset is successfully deleted.
  - body: { dataset_id: string }
- `POST https://api.mcp.ai/api/faraday/delete/outcome` — Tool to delete an outcome by its UUID. Use when you need to remove an outcome from Faraday.
  - body: { outcome_id: string }
- `POST https://api.mcp.ai/api/faraday/delete/persona/set` — Tool to delete a persona set. Use when you need to permanently remove a persona set from Faraday. Returns success status and HTTP code 204 on successful deletion.
  - body: { persona_set_id: string }
- `POST https://api.mcp.ai/api/faraday/delete/place` — Tool to delete a place by its UUID. Use when you need to remove a place from the system.
  - body: { place_id: string }
- `POST https://api.mcp.ai/api/faraday/delete/scope` — Tool to delete a scope by its UUID. Use when you need to permanently remove a scope from the system. Returns 204 status code on successful deletion.
  - body: { scope_id: string }
- `POST https://api.mcp.ai/api/faraday/delete/stream` — Tool to delete a stream by its UUID or name. Use when you need to remove a stream that is no longer needed.
  - body: { stream_id_or_name: string }
- `POST https://api.mcp.ai/api/faraday/delete/target` — Tool to delete a target by its UUID. Use when you need to remove a target from Faraday.
  - body: { target_id: string }
- `POST https://api.mcp.ai/api/faraday/delete/upload` — Permanently deletes a file from a Faraday dataset directory. Use this when you need to remove an uploaded file from a specific directory. This is a destructive operation that cannot be undone - the fi
  - body: { filename: string, directory: string }
- `POST https://api.mcp.ai/api/faraday/delete/webhook/endpoint` — Tool to delete a webhook endpoint by its UUID. Use when you need to remove a webhook endpoint from Faraday. The operation returns 204 No Content on success.
  - body: { webhook_endpoint_id: string }
- `POST https://api.mcp.ai/api/faraday/force/update/cohort` — Tool to trigger a rerun for a cohort. Use when you need to force rebuild a cohort's data.
  - body: { cohort_id: string }
- `POST https://api.mcp.ai/api/faraday/force/update/connection` — Tool to trigger a rerun for a Faraday connection. Use when you need to force refresh connection data.
  - body: { connection_id: string }
- `POST https://api.mcp.ai/api/faraday/force/update/dataset` — Tool to trigger a rerun for a dataset. Use when you need to force a dataset to update immediately rather than waiting for its normal schedule.
  - body: { dataset_id: string }
- `POST https://api.mcp.ai/api/faraday/force/update/outcome` — Tool to trigger a rerun for an outcome resource. Use when you need to force rebuild an outcome, causing it to reprocess and update its predictions.
  - body: { outcome_id: string }
- `POST https://api.mcp.ai/api/faraday/force/update/persona/set` — Tool to trigger a rerun for a persona set resource. Use when you need to force rebuild a persona set, causing it to reprocess and update its personas.
  - body: { persona_set_id: string }
- `POST https://api.mcp.ai/api/faraday/force/update/place` — Tool to trigger a rerun for a place. Use when you need to force rebuild a place's data.
  - body: { place_id: string }
- `POST https://api.mcp.ai/api/faraday/force/update/scope` — Tool to trigger a rerun for a scope resource. Use when you need to force rebuild a scope, causing it to reprocess and update its data.
  - body: { scope_id: string }
- `POST https://api.mcp.ai/api/faraday/force/update/stream` — Tool to trigger a rerun for a stream. Use when you need to force rebuild a stream's data.
  - body: { stream_id_or_name: string }
- `POST https://api.mcp.ai/api/faraday/force/update/target` — Tool to trigger a rerun for a target. Use when you need to force rebuild a target's data.
  - body: { target_id: string }
- `POST https://api.mcp.ai/api/faraday/force/update/trait` — Tool to trigger a rerun for a trait. Use when you need to force rebuild a trait's data.
  - body: { trait_id: string }
- `POST https://api.mcp.ai/api/faraday/get/account` — Tool to retrieve detailed information about a Faraday account by its UUID. Use when you need to fetch account details, status, branding, or billing information.
  - body: { account_id: string }
- `POST https://api.mcp.ai/api/faraday/get/accounts` — Tool to list all Faraday accounts accessible by the current user. Use when you need to retrieve account information, check account status, or get account IDs for other operations.
- `POST https://api.mcp.ai/api/faraday/get/accounts/billing` — Tool to get billing information about your account. Use when you need to retrieve invoices, payments, or usage information for a specific account.
  - body: { account_id: string }
- `POST https://api.mcp.ai/api/faraday/get/cohort` — Tool to retrieve a specific cohort by ID. Use when you need to fetch details about a specific cohort.
  - body: { cohort_id: string }
- `POST https://api.mcp.ai/api/faraday/get/cohort/analysis/membership` — Tool to get cohort membership counts over time for a specific cohort. Use when you need to analyze how cohort membership has changed over days, weeks, and months.
  - body: { cohort_id: string }
- `POST https://api.mcp.ai/api/faraday/get/cohorts` — Tool to list all cohorts in your Faraday account. Use when you need to retrieve the list of customer groups or segments.
- `POST https://api.mcp.ai/api/faraday/get/connection/datasets` — Tool to retrieve all datasets that use a specific connection. Use when you need to list datasets associated with a connection ID.
  - body: { connection_id: string }
- `POST https://api.mcp.ai/api/faraday/get/connections/targets` — Tool to retrieve all targets that use a specific connection. Use when you need to get a list of all targets associated with a connection ID.
  - body: { connection_id: string }
- `POST https://api.mcp.ai/api/faraday/get/current/account` — Tool to retrieve the current account information. Use when you need to get details about the authenticated account, including account ID, name, status, and billing information.
- `POST https://api.mcp.ai/api/faraday/get/current/account/billing` — Tool to retrieve billing information about the current account. Use when you need to check invoices, payments, or usage limits for the authenticated Faraday account.
- `POST https://api.mcp.ai/api/faraday/get/dataset` — Tool to retrieve a dataset by its UUID. Use when you need to get details about a specific dataset including its configuration, columns, status, and metadata.
  - body: { dataset_id: string }
- `POST https://api.mcp.ai/api/faraday/get/datasets/logs/ingress` — Tool to retrieve dataset ingress metrics over time. Use when you need to monitor or analyze data ingestion history, track row counts, or review ingress operation status for a specific dataset.
  - body: { limit?: integer, offset?: integer, dataset_id: string }
- `POST https://api.mcp.ai/api/faraday/get/feature/stores` — Tool to list all feature stores. Use when you need to retrieve feature stores from your Faraday account.
- `POST https://api.mcp.ai/api/faraday/get/graph` — Tool to retrieve the complete dependency graph for all resources on an account. Shows relationships between datasets, cohorts, outcomes, targets, connections, and other resources.
- `POST https://api.mcp.ai/api/faraday/get/market/opportunity/analyses` — Tool to retrieve all market opportunity analyses from Faraday. Use when you need to view penetration and opportunity metrics in your market.
- `POST https://api.mcp.ai/api/faraday/get/outcome` — Tool to retrieve an outcome by its ID. Use when you need to get details about a specific outcome including its configuration, cohorts, status, and performance metrics.
  - body: { outcome_id: string }
- `POST https://api.mcp.ai/api/faraday/get/outcomes` — Tool to list all outcomes for the account. Use when you need to retrieve configured business objectives and their modeling status. Returns complete list without pagination.
- `POST https://api.mcp.ai/api/faraday/get/persona/set` — Tool to retrieve a persona set by its UUID. Use when you need to access details about a specific customer persona set including its status, configuration, and constituent personas.
  - body: { persona_set_id: string }
- `POST https://api.mcp.ai/api/faraday/get/persona/set/analysis/flow` — Tool to retrieve the flow of persona sets over time, showing how individuals move between different personas. Use when you need to analyze trends in persona membership or understand how your audience 
  - body: { persona_set_id: string }
- `POST https://api.mcp.ai/api/faraday/get/persona/sets` — Tool to list all persona sets. Use when you need to retrieve customer persona sets for analysis or selection.
- `POST https://api.mcp.ai/api/faraday/get/persona/sets/analysis/dimensions` — Tool to get various trait breakdown information about a persona set. Use when you need to analyze the characteristics and distributions of personas within a set.
  - body: { persona_set_id: string }
- `POST https://api.mcp.ai/api/faraday/get/place` — Tool to retrieve a specific place by its UUID. Use when you need to get details about a geospatial area or address set that can be used as a spatial filter.
  - body: { place_id: string }
- `POST https://api.mcp.ai/api/faraday/get/places` — Tool to list all places in Faraday. Use when you need to retrieve geospatial areas or address sets that can be used as spatial filters. Returns all place resources with their status and configuration.
- `POST https://api.mcp.ai/api/faraday/get/recommenders` — Tool to list all recommenders. Use when you need to retrieve recommender resources that predict future associations based on event streams.
- `POST https://api.mcp.ai/api/faraday/get/scope` — Tool to retrieve detailed information about a Faraday scope by its UUID. Use when you need to fetch scope configuration, population settings, payload details, or status information.
  - body: { scope_id: string }
- `POST https://api.mcp.ai/api/faraday/get/scope/analysis` — Tool to get analysis for a scope including outcomes and recommenders with probability distributions. Use when you need to analyze scope performance and understand prediction distributions.
  - body: { scope_id: string }
- `POST https://api.mcp.ai/api/faraday/get/scope/datasets` — Tool to retrieve all datasets associated with a Faraday scope. Use when you need to list or view all datasets that are connected to a specific scope.
  - body: { scope_id: string }
- `POST https://api.mcp.ai/api/faraday/get/scope/efficacy` — Tool to retrieve efficacy metrics for a scope. Returns model performance metrics and accuracy measurements showing how well predictions performed over time.
  - body: { scope_id: string }
- `POST https://api.mcp.ai/api/faraday/get/scope/payload/cohorts` — Tool to get payload cohorts for a specific scope. Use when you need to retrieve the list of cohorts included in a scope's payload configuration.
  - body: { scope_id: string }
- `POST https://api.mcp.ai/api/faraday/get/scope/payload/outcomes` — Tool to retrieve payload outcomes for a specific scope. Use when you need to fetch the outcome predictions included in a scope's data payload.
  - body: { scope_id: string }
- `POST https://api.mcp.ai/api/faraday/get/scope/payload/persona/sets` — Tool to get payload persona sets for a specific scope. Use when you need to retrieve the list of persona sets included in a scope's payload configuration.
  - body: { scope_id: string }
- `POST https://api.mcp.ai/api/faraday/get/scope/payload/recommenders` — Tool to retrieve payload recommenders for a specific scope. Use when you need to fetch recommender resources associated with a scope's payload configuration.
  - body: { scope_id: string }
- `POST https://api.mcp.ai/api/faraday/get/scope/population/exclusion/cohorts` — Tool to get population exclusion cohorts for a scope. Use when you need to retrieve the cohorts that are excluded from a specific scope's population.
  - body: { scope_id: string }
- `POST https://api.mcp.ai/api/faraday/get/scope/targets` — Tool to get all targets for a specific scope. Use when you need to retrieve export configurations and target details for a scope.
  - body: { scope_id: string }
- `POST https://api.mcp.ai/api/faraday/get/scopes/population/cohorts` — Tool to get population cohorts for a specific scope. Use when you need to retrieve the list of cohorts associated with a scope's population.
  - body: { scope_id: string }
- `POST https://api.mcp.ai/api/faraday/get/stream` — Tool to retrieve a stream by its UUID or name. Use when you need to fetch stream details including properties, event counts, and metadata.
  - body: { stream_id_or_name: string }
- `POST https://api.mcp.ai/api/faraday/get/streams` — Tool to list all streams in your Faraday account. Use when you need to retrieve event streams associated with the account.
- `POST https://api.mcp.ai/api/faraday/get/streams/analysis` — Tool to get the count of stream events emitted over a time period. Use when you need to analyze stream activity patterns and event volume trends.
  - body: { stream_id_or_name: string }
- `POST https://api.mcp.ai/api/faraday/get/target` — Tool to retrieve a specific target by its UUID from Faraday. Use when you need to fetch details about a target including its configuration, status, and export settings.
  - body: { target_id: string }
- `POST https://api.mcp.ai/api/faraday/get/targets/analysis` — Tool to retrieve a target's analysis including geographic distributions and trait breakdowns. Use when you need to understand the composition and characteristics of individuals within a specific targe
  - body: { target_id: string }
- `POST https://api.mcp.ai/api/faraday/get/trait` — Tool to retrieve a specific trait by ID. Use when you need to get detailed information about a trait including its type, category, statistical properties, and configuration.
  - body: { trait_id: string }
- `POST https://api.mcp.ai/api/faraday/get/traits/analysis/dimensions` — Tool to retrieve the percentage of the US population that falls into each category of a trait. Use when you need to analyze the distribution of a specific trait across the population.
  - body: { trait_id: string }
- `POST https://api.mcp.ai/api/faraday/get/traits/csv` — Tool to retrieve all user-defined and Faraday-provided traits in CSV format. Use when you need to export or analyze trait data in a spreadsheet-compatible format.
- `POST https://api.mcp.ai/api/faraday/get/upload` — Tool to download a previously uploaded file from a Faraday dataset directory. Use when you need to retrieve the contents of a specific file.
  - body: { filename: string, directory: string }
- `POST https://api.mcp.ai/api/faraday/get/uploads` — Tool to retrieve the list of previously uploaded files in Faraday. Use when you need to see uploaded datasets or verify file uploads.
- `POST https://api.mcp.ai/api/faraday/get/usages` — Tool to retrieve usage statistics for your Faraday account. Use when you need to check current usage and limits for various account features.
- `POST https://api.mcp.ai/api/faraday/get/webhook/endpoint` — Tool to retrieve a webhook endpoint by its UUID. Use when you need to access details about a specific webhook endpoint including its URL, status, enabled events, and signing secret.
  - body: { webhook_endpoint_id: string }
- `POST https://api.mcp.ai/api/faraday/get/webhook/endpoints` — Tool to list all webhook endpoints configured for the account. Use when you need to retrieve webhook endpoint information including URLs, status, and enabled events.
- `POST https://api.mcp.ai/api/faraday/list/attributes` — Tool to list all attributes in the feature store. Use when you need to retrieve the catalog of available attributes for data analysis or feature engineering.
- `POST https://api.mcp.ai/api/faraday/list/connections` — Tool to list all connections configured in Faraday. Use when you need to view available data connections between Faraday and external locations.
- `POST https://api.mcp.ai/api/faraday/list/scopes` — Tool to list all scopes. Use when you need to retrieve scope configurations for viewing output data instructions.
- `POST https://api.mcp.ai/api/faraday/list/targets` — Tool to list all targets in your Faraday account. Use when you need to view export configurations for predictions.
- `POST https://api.mcp.ai/api/faraday/unarchive/cohort` — Tool to unarchive a previously archived cohort. Use when you need to restore an archived cohort and optionally its upstream resources.
  - body: { cohort_id: string, cascade_to?: string[], cascade_to_all?: boolean }
- `POST https://api.mcp.ai/api/faraday/unarchive/datasets` — Tool to unarchive a dataset in Faraday. Use when you need to restore an archived dataset for active use. Optionally cascades to upstream resources.
  - body: { cascade_to?: string[], dataset_id: string, cascade_to_all?: boolean }
- `POST https://api.mcp.ai/api/faraday/unarchive/outcome` — Tool to unarchive an outcome in Faraday. Use when you need to restore updates to a previously archived outcome.
  - body: { cascade_to?: string[], outcome_id: string, cascade_to_all?: boolean }
- `POST https://api.mcp.ai/api/faraday/unarchive/persona/sets` — Tool to unarchive a previously archived persona set. Use when you need to restore an archived persona set and optionally its upstream resources.
  - body: { cascade_to?: string[], cascade_to_all?: boolean, persona_set_id: string }
- `POST https://api.mcp.ai/api/faraday/unarchive/places` — Tool to unarchive a previously archived place. Use when you need to restore an archived place and optionally its upstream resources.
  - body: { place_id: string, cascade_to?: string[], cascade_to_all?: boolean }
- `POST https://api.mcp.ai/api/faraday/unarchive/scope` — Tool to unarchive a previously archived scope. Use when you need to restore an archived scope and optionally its upstream resources.
  - body: { scope_id: string, cascade_to?: string[], cascade_to_all?: boolean }
- `POST https://api.mcp.ai/api/faraday/unarchive/stream` — Tool to unarchive a stream in Faraday. Use when you need to restore an archived stream for active use. Optionally cascades to upstream resources.
  - body: { cascade_to?: string[], cascade_to_all?: boolean, stream_id_or_name: string }
- `POST https://api.mcp.ai/api/faraday/unarchive/trait` — Tool to unarchive a trait. Use when you need to restore an archived trait and optionally its upstream resources.
  - body: { trait_id: string, cascade_to?: string[], cascade_to_all?: boolean }
- `POST https://api.mcp.ai/api/faraday/update/account` — Tool to update an account's name or branding settings. Use when you need to modify account properties using JSON Merge Patch semantics.
  - body: { name?: string, branding?: object, account_id: string }
- `POST https://api.mcp.ai/api/faraday/update/cohort` — Tool to update a cohort's configuration using JSON Merge Patch semantics. Use when you need to modify cohort properties like name, filters, or conditions.
  - body: { name?: string, traits?: object[], explore?: boolean, recency?: object, cohort_id: string, max_count?: number, max_value?: number, min_count?: number, min_value?: number, stream_name?: string, place_conditions?: object[], stream_conditions?: object[] }
- `POST https://api.mcp.ai/api/faraday/update/connection` — Tool to update a Faraday connection's name or options. Use when you need to modify connection properties using JSON Merge Patch semantics.
  - body: { name?: string, options?: object, connection_id: string }
- `POST https://api.mcp.ai/api/faraday/update/dataset` — Tool to update a dataset configuration using JSON Merge Patch semantics. Use when you need to modify dataset properties like name, identity sets, output configurations, or privacy settings.
  - body: { name?: string, options?: object, preview?: boolean, privacy?: string, dataset_id: string, identity_sets?: object, upsert_columns?: string[], output_to_traits?: object, output_to_streams?: object, identity_providers?: object[], incremental_column?: string, reference_key_column?: string, reference_key_columns?: string[], output_to_streams_array?: object[], output_all_columns_as_traits?: object }
- `POST https://api.mcp.ai/api/faraday/update/outcome` — Tool to update an outcome's configuration using JSON Merge Patch semantics. Use when you need to modify outcome properties such as name, cohorts, bias mitigation, feature blocklist, prediction mode, p
  - body: { name?: string, preview?: boolean, outcome_id: string, predictors?: object, bias_mitigation?: object, prediction_mode?: string, feature_blocklist?: string[], eligible_cohort_id?: string, attrition_cohort_id?: string, attainment_cohort_id?: string }
- `POST https://api.mcp.ai/api/faraday/update/persona/set` — Tool to edit a persona set's configuration using JSON Merge Patch. Use when you need to update persona set properties like name, explore visibility, number of clusters, or preview mode.
  - body: { name?: string, explore?: boolean, preview?: boolean, persona_set_id: string, number_of_clusters?: integer }
- `POST https://api.mcp.ai/api/faraday/update/place` — Tool to update a place's name, addresses, or geojson geometry. Use when you need to modify place properties using JSON Merge Patch semantics.
  - body: { name?: string, geojson?: object, place_id: string, addresses?: object[] }
- `POST https://api.mcp.ai/api/faraday/update/scope` — Tool to update a Faraday scope's configuration using JSON Merge Patch semantics. Use when you need to modify scope properties such as name, payload settings, population cohorts, or preview status.
  - body: { name?: string, payload?: object, preview?: boolean, scope_id: string, population?: object }
- `POST https://api.mcp.ai/api/faraday/update/stream` — Tool to update a stream's properties using JSON Merge Patch semantics. Use when you need to modify stream metadata like description, category, or deprecation status.
  - body: { tier?: string, category?: string, literate?: string, deprecated?: boolean, properties?: object, description?: string, deprecation_notes?: string, stream_id_or_name: string }
- `POST https://api.mcp.ai/api/faraday/update/target` — Tool to update a target's configuration in Faraday. Use when you need to modify target properties using JSON Merge Patch semantics.
  - body: { name?: string, limit?: object, filter?: object, options?: object, target_id: string, payload_map?: object, connection_id?: string, human_readable?: boolean, representation?: object, analysis_config?: object, custom_structure?: object[] }
- `POST https://api.mcp.ai/api/faraday/update/trait` — Tool to update a trait's properties using JSON Merge Patch semantics. Use when you need to modify trait metadata like description, literate name, lookup table, statistical type, or unit.
  - body: { unit?: string, literate?: string, trait_id: string, description?: string, lookup_table?: object, statistical_type?: string }
- `POST https://api.mcp.ai/api/faraday/update/webhook/endpoints` — Tool to update a webhook endpoint's configuration. Use when you need to modify the status, URL, or enabled events for an existing webhook endpoint.
  - body: { url?: string, status?: string, enabled_events?: string[], webhook_endpoint_id: string }

## Example prompts
- "What can I do in Faraday?"
- "Show me a summary of my Faraday account"

## More
- Page: https://mcp.ai/faraday
- Agent spec (llms.txt): https://mcp.ai/faraday/llms.txt
- Postman collection: https://mcp.ai/faraday/postman.json