shagarwal/databazaar-mcp

MCP server for DataBazaar — the data marketplace where AI agents discover, preview, purchase, **and sell** datasets.
> **DataBazaar is a marketplace, not a payment network.** All paid transactions
> are processed by Stripe (Stripe Connect for
> seller payouts; Stripe Billing for
> subscriptions). Funds move from the buyer's card to a registered seller's
> Stripe-Connected bank account, with DataBazaar collecting a 3% platform fee.
> No cryptocurrency, no peer-to-peer asset transfers, no money-transmission —
> the legal structure is the same as eBay or Etsy: an online marketplace
> where the marketplace operator does not hold or move user funds outside
> the regulated payments processor.
Quick Start (Claude.ai — remote connector)
For public discovery, connect to **https://api.databazaar.io/mcp/public** using
Streamable HTTP with no authentication. It exposes search_datasets, get_dataset,
preview_sample. Full downloads (including free data), purchases, private
history, and writes require the authenticated endpoint.
Run a public search → sample preview example with Python 3 (no packages):
Expected: success: true, scope: sample_only, sample rows, and elapsed seconds.
This does not measure a full retrieval.
Without --mcp, the same example uses REST. See the guide.
For full datasets (even free ones) and account operations, DataBazaar runs an authenticated remote MCP server at https://api.databazaar.io/mcp.
Claude.ai discovers OAuth via the standard RFC 8414 metadata document and
self-registers as a client via RFC 7591 Dynamic Client Registration — no
manual setup beyond clicking "Authorize" in the popup.
After signing up and authorizing the agent, call get_download_url with dataset_id.
For the Python full-data check, set DATABAZAAR_API_KEY in the environment and run
python3 first-retrieval.py --download (add --mcp for the authenticated transport).
It validates all 11 rows and times retrieval. Account setup is required first and
sample timings must not be reported as end-to-end onboarding success.
Quick Start (stdio — Claude Desktop / Cursor)
Search and samples work without credentials. To download full data, run
npx -y databazaar-mcp auth login or use an account API key from databazaar.io/operator/keys.
Quick Start (Docker — stdio)
For a local stdio container, build from this repository and run with stdin open:
No credentials are needed to start the server, inspect its tools, search, or
preview samples. For account operations, pass your own key at runtime with
docker run --rm -i -e DATABAZAAR_API_KEY databazaar-mcp after setting the
environment variable locally. Do not put credentials in the Dockerfile.
The container runs the stdio entry point. CI checks initialization and tool/resource discovery with
network access disabled; it does not perform marketplace actions.
Quick Start (Hosted HTTP — long-lived service)
Configuration
Set these environment variables before running:
| Variable | Required | Description |
|---|---|---|
| DATABAZAAR_API_KEY | For full downloads/account tools | Your API key (dbz_live_...) |
| DATABAZAAR_API_URL | No | Override API endpoint (default: https://api.databazaar.io) |
| DATABAZAAR_BUDGET_LIMIT_USD | No | Budget hint for the client; configure enforced purchase limits on your account API key |
| DATABAZAAR_MCP_PORT | No | HTTP transport port (default: 8788) |
Claude Desktop / Cursor Setup (stdio)
Add to your MCP config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
Hosted HTTP Transport Setup
Run databazaar-mcp-http as a long-lived process. Each HTTP caller supplies its own Bearer account credential; the server never lends an environment credential to callers. For managed account authorization, use https://api.databazaar.io/mcp.
Available Tools
Search & Discovery
- **find_data_for_task** — Task-based dataset recommendation with why_relevant explanations