https://api.enigma.com/graphql. Things to know before you query:
- Read-only. All four operations are GraphQL queries; none of them writes or deletes anything at Enigma.
- Matching, not search listings.
brands.matchandlocations.matchsend the terms to Enigma’s resolver and return the single best match, ornullwhen nothing clears the confidence bar. Narrow withaddressand raisematchThreshold(0.0 to 1.0) to reject weak matches. prompt.brands.matchaccepts a natural-language business description instead of name, website or phone, but it cannot be combined with any of them or withaddress.- Paging.
brands.getpages the brand’s operating locations withlocationsFirstand theendCursorfrom the previous page’spageInfo.legalEntitiesFirstsizes the legal entities list, which is not paged. InsidelegalEntities.get, theregisteredEntities,addressesandbrandslists return their first page of up to three entries, each with apageInfo.hasNextPageflag when more exist. - Card revenue costs credits.
cardRevenue12mis the projected 12-month card revenue Enigma reports for the brand or location, in dollars. Enigma bills it per value returned (25 credits each on its price list as of November 2026), sobrands.getwith the default 10 locations can use about 275 credits in one call. SetlocationsFirstlower when you only need the brand’s details.brands.matchreturns one value. - Rate limits. Limits are per plan, daily and monthly. Over the limit the API answers 429 with a
Retry-Afterheader; the plugin retries up to three times, honoring that header. A 402 means the account is out of credits and is not retried. - Webhooks. Enigma does not send webhooks to this plugin.
- 4 typed API operations
Setup
1
Install
2
Add the plugin
corsair.ts
multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.3
Choose authentication
- API Key (Recommended)
Store the Enigma API key before the first call: More: API Key
pnpm corsair setup --plugin=enigma --tenant=acme api_key=<your-key> (leave out --tenant without multiTenancy), or pass it as key in the plugin options. With Hub, each tenant enters their own key on the connect page. See API key auth.4
Connect a tenant
Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.
Example API calls
Match a brand by name and stateWhat’s next
API reference
Every
enigma.api.* operation with input and output types.Connect / OAuth
createLink, Hub delivery, and tenant connect flows.
Use with agents
Expose this plugin’s operations as MCP tools.