> ## Documentation Index
> Fetch the complete documentation index at: https://docs.databar.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Connect AI assistants like Claude to Databar's enrichment API

The Databar MCP Server implements the [Model Context Protocol](https://modelcontextprotocol.io) (MCP), allowing AI assistants like Claude, Cursor, Codex, Gemini CLI, and others to interact with Databar's API using natural language.

Instead of writing API calls manually, you can say *"find the email for John Smith at Google"* and your AI assistant will automatically discover the right enrichment, run it, and return the results.

<Info>
  Databar runs the MCP server for you at `https://mcp.databar.ai/mcp`, so your client always talks to the current implementation without installing or upgrading anything locally.
</Info>

## Quick start

The MCP server URL for all clients:

```
https://mcp.databar.ai/mcp
```

<Tabs>
  <Tab title="Claude (recommended)">
    The recommended way to connect Claude is through the built-in Connectors UI. This uses OAuth so you never need to copy an API key.

    <Steps>
      <Step title="Open Connectors">
        Open Claude (web or desktop) and go to **Settings > Connectors**. Scroll to the bottom and click **Add custom connector**.
      </Step>

      <Step title="Enter the server details">
        * **Name:** `Databar`
        * **Remote MCP Server URL:** `https://mcp.databar.ai/mcp`
        * Leave **Advanced settings** blank.
        * Click **Add**.

        <Frame>
          <img src="https://mintcdn.com/databar/KfMhg9ScwXZuERVk/images/claude-add-connector.png?fit=max&auto=format&n=KfMhg9ScwXZuERVk&q=85&s=9d252f3517b6de9978262221cb3312a1" alt="Add custom connector dialog in Claude" width="1024" height="801" data-path="images/claude-add-connector.png" />
        </Frame>
      </Step>

      <Step title="Authorize">
        Claude will redirect you to Databar to authenticate. Click **Authorize** to grant access to your workspace, then you will be redirected back to Claude.

        <Frame>
          <img src="https://mintcdn.com/databar/afAbuwY9hArOmllg/images/claude-authorize.png?fit=max&auto=format&n=afAbuwY9hArOmllg&q=85&s=edd421d2c57fc4614348544d3e2a0829" alt="Databar authorization screen for Claude" width="1024" height="560" data-path="images/claude-authorize.png" />
        </Frame>
      </Step>

      <Step title="Try it">
        Ask Claude: *"What can the Databar MCP do?"*
      </Step>
    </Steps>

    <Accordion title="Alternative: JSON config with API key">
      If you prefer to authenticate with an API key instead of OAuth, add this to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):

      ```json theme={null}
      {
        "mcpServers": {
          "databar": {
            "type": "http",
            "url": "https://mcp.databar.ai/mcp",
            "headers": {
              "Authorization": "Bearer your-api-key-here"
            }
          }
        }
      }
      ```

      Restart Claude after saving.
    </Accordion>
  </Tab>

  <Tab title="Cursor">
    Open `.cursor/mcp.json` in your project (or `~/.cursor/mcp.json` globally) and add:

    ```json theme={null}
    {
      "mcpServers": {
        "databar": {
          "url": "https://mcp.databar.ai/mcp",
          "headers": {
            "Authorization": "Bearer your-api-key-here"
          }
        }
      }
    }
    ```

    To find your API key, log in to your [Databar workspace](https://databar.ai) and navigate to **Integrations**.

    Restart Cursor, then try: *"What can the Databar MCP do?"*

    The hosted server supports both **Streamable HTTP** (`POST/GET/DELETE /mcp`) for modern clients and **Legacy SSE** (`GET /sse`) for older clients.
  </Tab>

  <Tab title="stdio-only clients">
    Some clients can only spawn a local process. Bridge them to the hosted server with [`mcp-remote`](https://www.npmjs.com/package/mcp-remote):

    ```json theme={null}
    {
      "mcpServers": {
        "databar": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://mcp.databar.ai/mcp"]
        }
      }
    }
    ```

    The first start opens a browser window to authorize your workspace. To use an API key instead, pass it as a header:

    ```json theme={null}
    {
      "mcpServers": {
        "databar": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://mcp.databar.ai/mcp", "--header", "Authorization:${AUTH_HEADER}"],
          "env": {
            "AUTH_HEADER": "Bearer your-api-key-here"
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

## What you can do

The hosted server exposes a large set of tools aligned with the public Databar REST API. The list below reflects the current surface area (tool names and behavior may expand as we deploy updates to the hosted endpoint):

<CardGroup cols={2}>
  <Card title="Enrichments" icon="magnifying-glass">
    Search, inspect, run enrichments — single or bulk. Remote param choices and pagination-aware runs.
  </Card>

  <Card title="Waterfalls" icon="bolt">
    Search and run headless waterfalls; add table waterfalls and run them with enrichments.
  </Card>

  <Card title="Tables & columns" icon="table">
    Create, rename, or delete tables; add, rename, or delete columns; configure enrichments and exporters on a table.
  </Card>

  <Card title="Rows & folders" icon="rows">
    Insert, patch, upsert, delete, and filter rows; create and manage folders; move tables between folders.
  </Card>

  <Card title="Exporters" icon="share">
    Search exporters, inspect details, attach to tables, list configured exporters, and trigger runs.
  </Card>

  <Card title="Account" icon="coins">
    Check credit balance. Paid runs check the balance first and ask for confirmation at 50 credits or more.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Available tools" icon="wrench" href="/mcp-tools">
    Full list of all MCP tools with descriptions.
  </Card>

  <Card title="Configuration" icon="gear" href="/mcp-configuration">
    Authentication, spending guardrails, and task expiry.
  </Card>
</CardGroup>

## Example prompts

Here are some things you can ask your AI assistant once the MCP server is connected:

* *"Get me David Abaev's LinkedIn profile"*
* *"Verify the email [david@databar.ai](mailto:david@databar.ai)"*
* *"Find the email for John Smith at Google using a waterfall"*
* *"Enrich these 10 domains with company data"*
* *"List my tables and show the columns for the first one"*
* *"Create a table called Leads with columns name, email, company and add 5 empty rows"*
* *"Get rows from my Leads table where company contains 'tech'"*
* *"How many credits do I have left?"*

## Links

<CardGroup cols={2}>
  <Card title="Hosted MCP" icon="server" href="https://mcp.databar.ai/mcp">
    Always up to date
  </Card>

  <Card title="Agent Skills" icon="graduation-cap" href="/mcp-skills">
    Workflow skills for your agent
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.