Databar MCP Server

A Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with Databar.ai's data enrichment API. Discover, configure, and run data enrichments across hundreds of data providers using natural language.

Features

• Smart Enrichment Discovery — Search and filter enrichments by keyword or category
• Natural Language Interface — Ask "get David's LinkedIn profile" and the right enrichment runs automatically
• Bulk Operations — Enrich many records in a single call with bulk enrichment and bulk waterfall support
• Table Management — Create tables, manage columns, insert/update/upsert rows
• Waterfall Support — Try multiple data providers sequentially until one succeeds
• Async Handling — Automatic polling for results with no manual intervention
• Intelligent Caching — 24-hour result cache reduces API calls and costs
• Error Handling — Retries with exponential backoff and clear error messages

Quick Start

Prerequisites

• Node.js 18+
• A Databar.ai API key (get one here)

Install & Build

git clone https://github.com/databar-ai/databar-mcp-server.git
cd databar-mcp-server
npm install
npm run build

Configure Claude Desktop

Edit your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "databar": {
      "command": "node",
      "args": ["/absolute/path/to/databar-mcp-server/dist/index.js"],
      "env": {
        "DATABAR_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Claude Desktop. Verify by asking: "What Databar tools do you have access to?"

Usage Examples

Find someone's LinkedIn profile

"Get me David Abaev's LinkedIn profile"

Claude searches for LinkedIn enrichments, picks the right one, runs it, and returns the profile data.

Verify an email address

"Verify the email [email protected]"

Find an email using waterfall

"Find the email for John Smith at Google"

Runs a waterfall that tries multiple providers until one returns a result.

Bulk enrich a list

"Enrich these 10 emails with company data: [list]"

Uses bulk enrichment to process all records in a single API call.

Manage table data

"List my tables"
"Create 5 rows in table abc-123 with columns name and email"
"Get the columns for table abc-123"

Available Tools

Enrichments

| Tool | Description | |------|-------------| | search_enrichments | Search enrichments by keyword or category | | get_enrichment_details | Get parameters, pricing, and response fields for an enrichment | | run_enrichment | Run a single enrichment (with auto-polling and caching) | | run_bulk_enrichment | Run an enrichment on multiple inputs at once |

Waterfalls

| Tool | Description | |------|-------------| | search_waterfalls | Search available waterfall enrichments | | run_waterfall | Run a waterfall (tries providers sequentially) | | run_bulk_waterfall | Run a waterfall on multiple inputs at once |

Tables

| Tool | Description | |------|-------------| | create_table | Create a new empty table | | list_tables | List all tables in your workspace | | get_table_columns | Get column schema for a table | | get_table_rows | Get rows with pagination | | get_table_enrichments | List enrichments configured on a table | | add_table_enrichment | Add an enrichment to a table with column mapping | | run_table_enrichment | Trigger an enrichment on all rows in a table |

Row Operations

| Tool | Description | |------|-------------| | create_rows | Insert up to 50 rows with deduplication options | | patch_rows | Update fields on existing rows by ID | | upsert_rows | Insert or update rows based on a matching key |

Account

| Tool | Description | |------|-------------| | get_user_balance | Get credit balance and account info |

Configuration

All settings are configurable via environment variables:

| Variable | Default | Description | |----------|---------|-------------| | DATABAR_API_KEY | (required) | Your Databar API key | | DATABAR_BASE_URL | https://api.databar.ai/v1 | API base URL | | CACHE_TTL_HOURS | 24 | Result cache TTL in hours | | MAX_POLL_ATTEMPTS | 150 | Max polling attempts for async tasks | | POLL_INTERVAL_MS | 2000 | Polling interval in ms |

How It Works

Async Task Handling

1. Server sends a run request to the Databar API
2. API returns a task_id
3. Server automatically polls /v1/tasks/{task_id} every 2 seconds
4. When status is completed, results are returned
5. If data has expired (1-hour retention), gone status is handled gracefully

Caching

• Results are cached for 24 hours by default
• Cache key: enrichment ID + serialized params
• Cached results don't consume credits
• Use skip_cache: true to force fresh data

Smart Categorization

Enrichments are automatically categorized (People, Company, Email, Phone, Social, Financial, Verification) to help the AI assistant pick the right tool.

Development

npm run dev      # Run with tsx (hot reload)
npm run build    # Compile TypeScript
npm start        # Run compiled output

Project Structure

databar-mcp-server/
├── src/
│   ├── index.ts           # MCP server entry point & tool handlers
│   ├── databar-client.ts  # Databar API client with polling
│   ├── cache.ts           # In-memory cache with TTL
│   ├── types.ts           # TypeScript type definitions
│   └── utils.ts           # Helpers & categorization
├── dist/                  # Compiled output (generated)
├── package.json
├── tsconfig.json
└── .gitignore

Troubleshooting

| Problem | Solution | |---------|----------| | Server not connecting | Verify API key, rebuild (npm run build), restart Claude Desktop | | "No enrichments found" | Try a broader search query; list cache refreshes every 5 minutes | | "Task timed out" | Some enrichments take longer; increase MAX_POLL_ATTEMPTS | | "Task data has expired" | Data is stored for 1 hour only; re-run the enrichment | | "Invalid API key" | Check .env or Claude Desktop config for typos/extra spaces |

Resources

• Databar API Documentation
• Databar Web App
• MCP Protocol Docs

License

MIT