# Enigma — how to use (mcp.ai)

Connect your Enigma account and use 19 tools for business intelligence straight from your AI agent. Connect with your own API key. Enigma provides comprehensive data on U.S. businesses, offering insights into their identity and financial health to support sales, marketing, risk assessment, and compliance processes.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_enigma?ms=1787293440000`
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. `enigma_create_list`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/enigma`
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/enigma/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/enigma/create/list` — Tool to create a new list to organize and group entities in Enigma. Use when you need to create a list for data generation or enrichment purposes. The list can be populated using search criteria (enti
  - body: { name?: string, list_type?: string, description?: string, file_format?: string, search_input?: object, input_file_uri?: string }
- `POST https://api.mcp.ai/api/enigma/create/suggestion` — Tool to create a suggestion for data correction, enhancement, or analysis feedback in Enigma. Use when you need to submit feedback or suggest improvements to data in the Enigma platform.
  - body: { field?: string, payload: object, suggested_value?: object, suggested_by_email: string, ancestor_identifier?: object[], suggested_by_user_id?: string, suggested_entity_identifier?: object }
- `POST https://api.mcp.ai/api/enigma/delete/list` — Tool to delete an existing list permanently from the system. Use when you need to remove a list by its ID. Returns confirmation with the ID of the deleted list.
  - body: { id: string }
- `POST https://api.mcp.ai/api/enigma/get/account` — Tool to retrieve information about the current API account via GraphQL. Use when you need to check customer ID, billing details, pricing plan, credit availability, or auto-recharge settings.
- `POST https://api.mcp.ai/api/enigma/get/aggregate/counts` — Tool to get aggregate counts of operating locations and their associated brands or legal entities. Use when you need summary counts rather than detailed entity information. Supports filtering by open 
  - body: { count_field: string, entity_type?: string }
- `POST https://api.mcp.ai/api/enigma/get/attribute/groups` — Tool to retrieve attribute groups for Enigma entity types. Returns JSON metadata describing available attributes organized into logical groups (ID, Name, Address, etc.) with their corresponding GraphQ
  - body: { entity_type?: string }
- `POST https://api.mcp.ai/api/enigma/get/background/task` — Tool to get the status and results of a background task by ID. Use when checking async operation progress or retrieving results from previously initiated long-running operations.
  - body: { id: string }
- `POST https://api.mcp.ai/api/enigma/get/business` — Tool to retrieve detailed business information using an Enigma ID. Returns comprehensive business profile including addresses, names, websites, associated people, industries, and more. Use when you ne
  - body: { attrs?: string, enigma_id: string }
- `POST https://api.mcp.ai/api/enigma/get/decision` — Tool to retrieve a screening decision by its request ID. Use when you need to check the status, alert status, assignee, or timestamps of a previously created decision. Requires case management to be e
  - body: { decision_id: string }
- `POST https://api.mcp.ai/api/enigma/get/graph/ql/schema/extended` — Tool to retrieve extended schema information for Enigma's GraphQL API. Returns metadata about available types, fields, projections, and data asset metadata. Use when you need to explore the GraphQL sc
- `POST https://api.mcp.ai/api/enigma/get/list/materialization` — Tool to retrieve a specific list materialization by its unique ID. Returns detailed information about the materialized list including status, progress, and results location. Use when you need to check
  - body: { id: string }
- `POST https://api.mcp.ai/api/enigma/get/sanctioned/entity` — Tool to retrieve detailed information about a specific sanctioned entity by its ID. Returns full entity profile including names, aliases, DOB, nationality, addresses, documents, and program designatio
  - body: { format?: string, provider: string, record_id: string, collection: string }
- `POST https://api.mcp.ai/api/enigma/kyb/verification` — This tool performs a Know Your Business (KYB) check on a U.S. business by querying Enigma's dataset of legal entities based on official state records. It verifies business information and returns comp
  - body: { name: string, attrs?: string, top_n?: integer, address: object, package?: string, match_threshold?: number }
- `POST https://api.mcp.ai/api/enigma/list/decisions` — Tool to retrieve multiple screening decisions with pagination and filtering options. Use when you need to list, search, or review historical screening decisions by alert status, assignee, date range, 
  - body: { amt?: integer, tag?: string, page?: integer, alert?: boolean, status?: string, to_date?: string, from_date?: string, assignee_id?: string }
- `POST https://api.mcp.ai/api/enigma/match/business` — Tool to match business records against Enigma's SMB data asset using fuzzy matching on business name and location. Use when you need to identify a business profile and obtain an Enigma ID for further 
  - body: { name: string, top_n?: integer, person?: object, address?: object, website?: string, prioritization?: string, match_threshold?: number, show_non_matches?: integer, business_entity_type: string }
- `POST https://api.mcp.ai/api/enigma/screening/verification` — A tool to screen customers and transactions against sanctions and other watchlists. This endpoint allows for independent verification without requiring any external resource IDs.
  - body: { tag: string, searches: object[], caller_id?: string, query_type?: string, configuration_overrides?: object }
- `POST https://api.mcp.ai/api/enigma/search/graph/ql` — Tool to search and retrieve entities from Enigma's comprehensive U.S. business database. Returns brands (customer-facing identities), operating locations (physical/virtual spaces), or legal entities (
  - body: { tin?: string, name?: string, phone?: string, address?: object, website?: string, entity_type: string, match_threshold?: number }
- `POST https://api.mcp.ai/api/enigma/search/lists` — Tool to search and retrieve user-created lists via GraphQL. Returns paginated list connections with cursor-based pagination. Use when you need to query, filter, or browse entity lists.
  - body: { input?: object }
- `POST https://api.mcp.ai/api/enigma/verify/business/v2` — Tool to verify business identity using Enigma's KYB v2 endpoint. Performs comprehensive business verification including TIN verification, SSN verification, watchlist screening, and business bankruptcy
  - body: { tin?: string, name?: string, tins?: string[], attrs?: string, names?: string[], top_n?: integer, person?: object, address?: object, package?: string, website?: string, websites?: string[], addresses?: object[], match_confidence?: number, persons_to_screen?: object[] }

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

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