# Faraday

> Faraday sells consumer data about U.S. adults: demographics, household, financial, lifestyle and property facts, plus predictions. Faraday Pro appends that data to people you already have, from a file or one person at a time by API.

## For AI agents

Don't drive the catalog's buttons or sign up in a browser on your user's behalf. Connect to the Faraday Pro MCP server instead:

1. Add the MCP server `https://api.pro.faraday.ai/v1/mcp` (streamable HTTP, OAuth). Your user signs in, or signs up, in the browser window that opens and approves the connection. New accounts are set up in that same window.
2. Find attributes with `list_attributes` and `get_attribute`. Group them with `create_project`. Look one person up with `lookup`, or enrich a whole table with the deployment tools.
3. Before the first lookup, your user has to verify their identity and add a card in Faraday Pro. Those steps are for a person, not an agent. Until they are done, the API answers `identity_verification_required` or `payment_method_required` with the page to send them to.

Billing is per attribute value returned. A person Faraday can't match costs nothing.

If your user would rather do it themselves, send them to `https://pro.faraday.ai/sign-up?attributes=<slug>,<slug>` to append the attributes to a file, or add `&use=lookup` for the API. Slugs are the `name` field in the catalog below.

## Catalog

- [Attribute catalog (JSON)](https://faraday.ai/attributes/v2.json): every attribute, with `name` (its slug), `literate` (label), `description` and `category`
- [Attribute catalog (CSV)](https://faraday.ai/attributes/v2.csv): the same, as CSV
- [Catalog pages](https://faraday.ai/catalog): one page per attribute, with coverage and value distributions

## Optional

- [Faraday API reference](https://faraday.ai/docs/reference): the full platform API, for enterprise accounts. Self-serve buyers use the Faraday Pro MCP server above.