███████╗███╗   ██╗██╗ ██████╗ ███╗   ███╗ █████╗      █████╗ ██╗
██╔════╝████╗  ██║██║██╔════╝ ████╗ ████║██╔══██╗    ██╔══██╗██║
█████╗  ██╔██╗ ██║██║██║  ███╗██╔████╔██║███████║    ███████║██║
██╔══╝  ██║╚██╗██║██║██║   ██║██║╚██╔╝██║██╔══██║    ██╔══██║██║
███████╗██║ ╚████║██║╚██████╔╝██║ ╚═╝ ██║██║  ██║    ██║  ██║██║
╚══════╝╚═╝  ╚═══╝╚═╝ ╚═════╝ ╚═╝     ╚═╝╚═╝  ╚═╝    ╚═╝  ╚═╝╚═╝
        

Give your AI the knowledge of the Enigma graph and powerful business intelligence tools. Use our AI extensions to search and analyze U.S. businesses, investigate corporate structures, discover competitors by location or industry, and find signals in financial performance data across millions of businesses.

Available on Enigma Max Plan

Enigma MCP Supported On:
Claude Cursor Gemini VS Code Agentic Use

Installation

Claude

Claude Setup

For Claude organization accounts, setup is required only once by an Owner. All organization users can then access Enigma.

Prerequisites: Ensure you're logged in to the Enigma Console. If you don't have an account, register here.

Installation Steps:

  1. Open Claude app → User menu (bottom left) → Settings
  2. Navigate to Connectors → scroll down → Add Custom Connector
  3. Enter these values:
    Name: Enigma Remote MCP Server URL: https://mcp.enigma.com/http
  4. Click Add then Connect
  5. Authenticate in browser using your Enigma Console credentials
  6. Close authentication window when complete
Cursor

Cursor Setup

Manual configuration in settings.json, or use the one-click button after the OAuth method.

Prerequisites: Ensure you're logged in to the Enigma Console. If you don't have an account, register here.

Optional: For better LLM context management, add our Cursor rules file to your project.

Method 1 - API Key (Recommended): More reliable for Cursor using direct API key authentication.

Installation Steps:

  1. Open Cursor → SettingsTools and Integrations
  2. Click Add Custom MCP
  3. Enter the configuration below
  4. Replace <your-api-key> with your actual API key from Enigma Console
{
  "mcpServers": {
    "enigma": {
      "command": "npx",
      "args": [
        "-y", "-p",
        "@enigma-com/enigma-mcp-remote@latest",
        "enigma-mcp-remote",
        "https://mcp.enigma.com/http-key",
        "--header",
        "x-api-key:<your-api-key>"
      ]
    }
  }
}

Method 2 - OAuth: Uses browser-based OAuth authentication flow.

{
  "mcpServers": {
    "enigma": {
      "url": "https://mcp.enigma.com/http"
    }
  }
}
Add Enigma MCP to Cursor
Google Gemini

Google Gemini Setup

Connect Enigma's business intelligence tools to Google Gemini AI using MCP integration.

Installation Steps:

  1. Step 1: Configure MCP Server

    Locate the Gemini CLI settings file (usually ~/.gemini/settings.json) and add:

    {
      "mcpServers": {
        "enigma": {
          "url": "https://mcp.enigma.com/http"
        }
      }
    }
  2. Step 2: Authenticate

    With gemini-cli running, authenticate with Enigma:

    /mcp auth enigma

    A browser window opens for Enigma Console authentication. Complete login and close the auth window.

VS Code

VS Code Setup

Connect Enigma's business intelligence tools to Visual Studio Code using MCP integration.

Prerequisites: Ensure you're logged in to the Enigma Console. If you don't have an account, register here.

Installation Steps:

  1. Step 1: Create MCP Configuration

    In your workspace, create .vscode/mcp.json:

    {
      "servers": {
        "enigma": {
          "url": "https://mcp.enigma.com/http"
        }
      }
    }
  2. Step 2: Verify Setup
    • Restart VS Code to load the MCP configuration
    • Open GitHub Copilot Chat
    • Look for Enigma tools in the available capabilities
</>

Agentic / Programmatic Setup

Build custom AI agents with direct MCP integration. Works with any framework (OpenAI Agents, LangChain, CrewAI, AutoGen, etc.).

Get Started: Clone our examples repository for complete implementations.

Quick Setup (OpenAI Agents):

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    async with MCPServerStreamableHttp(
        params={
            "url": "https://mcp.enigma.com/http-key",
            "headers": {"x-api-key": "your_api_key"}
        }
    ) as server:
        await server.connect()
        
        agent = Agent(
            name="Business Intelligence Agent",
            mcp_servers=[server]
        )
        
        result = Runner.run_streamed(
            starting_agent=agent,
            input="Analyze Starbucks locations in NYC"
        )

asyncio.run(main())

Usage Examples

Business Overview

Show me a real-world business profile for Tacombi.
Tacombi Overview:
- 24+ locations (NY, MD, IL, CT, TX, DC, etc.)
- $36.4M annual card revenue (last 12 months)
- -12.4% YoY revenue growth (decline)
- 692,423 card transactions/year
- Average transaction: $53 (premium fast-casual)
- Operates via multiple LLCs (e.g., Tacombi Holding NA LLC, La Cornelia LLC)
- Modern payment stack: Stripe
- Expansion focus: high-traffic urban markets (NYC, Chicago, Bethesda)
            

Location & Compliance Deep Dive

What are Tacombi's biggest operational risks and compliance issues?
Compliance & Risk Highlights:
- Health code violations at multiple locations: evidence of rodents (mice), flies, and pest harborage (e.g., Bleecker St, Metropolitan Ave, Austin St), food temperature control issues (hot/cold holding), and food contact surface sanitation lapses.
- Fire code: Open violation orders at 25 Lafayette Ave, 255 Bleecker St (e.g., reinspection required, system alterations).
- Consumer complaints: e.g., "Calorie Signs Not Posted" (June 2024).
- Most issues resolved on re-inspection; all locations maintain active liquor licenses.
            

Financial & Customer Trends

How is Tacombi performing financially and what are their customer patterns?
Financial & Customer Data:
- Revenue peaks: Summer (June: $3.93M, July: $3.52M, August: $3.27M)
- Revenue dips: Winter (January: $2.09M, February: $2.0M)
- Daily customer volume: ~1,850
- Refund rate: 0.1% (very low)
- Most months show negative YoY growth (-6.5% to -25.8%)
- Transaction volume: 692,423/year
            

Government Records & Legal Structure

Show me Tacombi's legal entities and government filings.
Legal & Regulatory Data:
- Operates via multiple LLCs (Tacombi Holding NA LLC, La Cornelia LLC, Fonda Nolita LLC, etc.)
- Active liquor licenses in NY, CT, IL, TX (all locations checked)
- Proper registrations in NY, CT, IL, TX, DE
- Workers' compensation coverage: Technology Insurance Co
- Non-profit: Tacombi Foundation, Inc. (NY)
- ADA lawsuit (2019) for website accessibility (resolved)
- $1M NYS Excelsior Jobs Program tax credit (active)
            

Documentation

Enigma MCP Guide: https://documentation.enigma.com/guides/ai-mcp

MCP is a new protocol and we're actively working to keep up with the latest updates (often client dependent). If you encounter any issues, please reach out to us at support@enigma.com.

Note: The Model Context Protocol (MCP) will support many additional MCP clients beyond those listed above.