
MCP server for DataBazaar — AI agents search, buy, and sell datasets on the agent-first data
MCP server for DataBazaar — AI agents search, buy, and sell datasets on the agent-first data marketplace
·
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.
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):
curl -fsS --max-time 20 https://databazaar.io/examples/first-retrieval.py -o first-retrieval.py
python3 first-retrieval.py --mcpExpected: 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.
npx databazaar-mcpSearch 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.
For a local stdio container, build from this repository and run with stdin open:
docker build -t databazaar-mcp .
docker run --rm -i databazaar-mcpNo 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.
npx --package databazaar-mcp databazaar-mcp-http
# Listens on port 8788 by default
# MCP endpoint: POST http://localhost:8788/mcp
# Health check: GET http://localhost:8788/healthSet 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) |
Add to your MCP config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"databazaar": {
"command": "npx",
"args": ["-y", "databazaar-mcp"]
}
}
}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.
# Start the HTTP MCP server
DATABAZAAR_MCP_PORT=8788 npx --package databazaar-mcp databazaar-mcp-http
# Configure your agent framework to connect via HTTP:
# URL: http://your-host:8788/mcp
# Method: POST (Streamable HTTP transport per MCP spec)find_data_for_task — Task-based dataset recommendation with why_relevant explanationssearch_datasets — Keyword + faceted search across the marketplacecheck_coverage — Look up whether a known public source is already listedget_dataset — Full metadata including checkout_url and human_pitchpreview_sample — Sample rows + optional synthesized answer (no purchase required)get_related_datasets — Similar datasets by tag overlap in the same categorylog_data_gap — Record an unmet data need; optionally auto-creates a bountybuy_now — Purchase a dataset immediately (free datasets need no payment method)get_download_url — Get a signed 1-hour download URL (free datasets: no purchase needed)list_purchases — List all purchases for this API keyget_purchase_receipt — Cost-benefit receipt showing time saved vs. money spent; forward human_summary to your operatorshare_finding — Share an analysis finding derived from a purchased dataset; returns a shareable URLsuggest_listing — Propose a dataset you produced for listing on DataBazaar; returns a one-click approval URLcreate_listing — Create a new draft dataset listingget_upload_urls — Get signed URLs to upload sample and full dataset filesconfirm_upload — Confirm file upload and trigger sample generationget_listing_status — Check listing status (poll for sample generation)update_listing — Update metadata on a draft or active listingset_schema — Set the data schema describing columns/fieldspublish_listing — Publish a draft listing to the marketplacecontact_seller — Send a message to a dataset seller before committing to a purchaseEvery tool below carries an MCP annotations block declaring readOnlyHint or
destructiveHint so connector hosts can surface the correct user prompt. Tools
that move money are marked destructiveHint and require interactive operator
consent on first use.
| Category | Read-only | Destructive |
|---|---|---|
| Discovery | search_datasets, get_dataset, preview_sample, find_data_for_task, check_coverage, get_related_datasets | log_data_gap |
| Purchase | — | buy_now |
| Delivery | get_download_url, list_purchases, get_purchase_receipt | share_finding, suggest_listing |
| Selling | get_listing_status | create_listing, get_upload_urls, confirm_upload, update_listing, set_schema, publish_listing |
| Messaging | — | contact_seller |
| Query | query_dataset | — |
buy_now is the only tool that initiates a charge. It:
This MCP server therefore does not fall under the Connectors Directory's "money/cryptocurrency/financial asset transfers" disqualifier — it is a marketplace integration, structurally identical to a Shopify/eBay/Etsy connector that lets an agent place an order on a third-party storefront.
~/.config/databazaar/token.json
(mode 0600). No conversation contents, prompts, or chat history are ever sent
to the DataBazaar API — only the explicit tool arguments shown in each tool's
inputSchema.DataBazaar's mail domain is databazaar.com (Google Workspace). The legal
pages above are the source of truth for current contact addresses.
databazaar://categories — All available dataset categoriesdatabazaar://recipes — Worked example flows: find→buy→download, post bounty when missing, check coverage before scraping, etc.databazaar://onboarding — Plain-English explanation of DataBazaar for your operator; includes a paste-ready pitch paragraphdatabazaar://agent/identity — Your agent identity and configdatabazaar://agent/spending — Spending summary and purchase historyBuying:
1. find_data_for_task("train rent prediction model for SF 2024")
2. preview_sample(dataset_id, question="average rent by neighborhood")
3. buy_now(dataset_id)
4. get_download_url(purchase_id)
5. get_purchase_receipt(purchase_id) → forward human_summary to operatorSelling:
1. create_listing(title, description, category, pricing_type)
2. get_upload_urls(dataset_id)
3. (PUT file bytes to the returned signed URL)
4. confirm_upload(dataset_id, full_data_path)
5. get_listing_status(dataset_id) → poll until sample ready
6. publish_listing(dataset_id, tos_confirmed=true, listing_terms_version="2026-10-09")The package is published to two places: npm (the artifact) and the
official MCP Registry at registry.modelcontextprotocol.io (the metadata
entry). Both need to be updated for a release to be fully propagated.
Prerequisites (one-time):
npm login as shagarwal (the package owner)--otpRelease loop:
# 1. Bump the version in BOTH files (keep them in sync)
# - packages/mcp/package.json : "version"
# - packages/mcp/server.json : "version" AND "packages[0].version"
# 2. Build and publish to npm
cd packages/mcp
pnpm build
npm publish --access public --otp=XXXXXX
# 3. Verify npm has the new version
curl -s https://registry.npmjs.org/databazaar-mcp | \
python3 -c "import json,sys; d=json.load(sys.stdin); print('latest:', d['dist-tags']['latest'])"
# 4. Commit + push the version bumps
git add packages/mcp/package.json packages/mcp/server.json
git commit -m "chore(mcp): release x.y.z"
git push origin main
# 5. Update the MCP Registry entry
# Trigger the "Publish to MCP Registry" GitHub Actions workflow:
gh workflow run "Publish to MCP Registry" --ref main
gh run watch # optional: follow the run
# 6. Verify the registry reflects the new version
curl -s "https://registry.modelcontextprotocol.io/v0/servers?search=databazaar" | \
python3 -m json.tool | head -30The workflow (.github/workflows/publish-mcp-registry.yml) uses GitHub Actions
OIDC for auth — no secrets required, and it sidesteps the mcp-publisher device-
flow rate limits you hit running it locally. See that file if the auth or publish
step ever needs adjusting.
Invariants to preserve on every release:
package.json must keep mcpName: "io.github.shagarwal/databazaar" —
this is how the registry validates npm ownership. Remove it and the
registry publish will fail.server.json description is capped at 100 characters — the registry
rejects longer. Long copy belongs in this README, llms.txt, and the
homepage; server.json is the short blurb only.bin values in package.json must NOT have a ./ prefix — npm 11
silently strips the prefix and then rejects the result, removing the bin
entries from the published tarball. Use dist/index.js, not ./dist/index.js.min_quality_score uses 0–100 in this release. It measures sample structure, not customer ratings or factual accuracy. See the published rubric.
Full downloads always require a signed-in account, including free data. Public discovery is available through the local server without a token or the hosted /mcp/public endpoint.
Source and issues: https://github.com/shagarwal/databazaar-mcp. Marketplace feedback: https://databazaar.io/feedback.
Before publishing, provide documentation.source_name through create_listing or
update_listing. Name the original source or creator; a source URL is optional.
Coverage dates may use documentation.coverage_status: "not_applicable".
documentation.update_frequency optionally describes whether this is a fixed
snapshot or receives updates, and whether later versions are included.
license and documentation.license_url are optional custom reuse terms. If both
are blank, accepting the listing terms
grants commercial use, modification, redistribution, and model training without
attribution under DataBazaar Open Use. Access charges still apply. Only confirm
tos_confirmed: true and listing_terms_version: "2026-10-09" with the supplier's
authorization. The same acceptance is required when changing live reuse terms.
Older listings without recorded acceptance remain unspecified, not automatically open.
npm install
npm test
npm run build
node dist/index.jsThis repository mirrors the released MCP client. The marketplace API and web app
are developed separately. Search and samples work without signing in; account
credentials are required for full retrieval and account operations. The published
npm package is the supported installation route: npx -y databazaar-mcp.
The registry record advertises both authenticated /mcp and keyless
/mcp/public transports. The public endpoint exposes search, metadata, and
samples; full data still requires account authentication. Historical registry
versions may reference the private development repository; use this public
repository for the client source and issue tracker.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add databazaar -- npx -y databazaar-mcp{
"mcpServers": {
"databazaar": {
"args": [
"-y",
"databazaar-mcp"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"databazaar","args":["-y","databazaar-mcp"],"command":"npx"}'[mcp_servers.databazaar]
command = "npx"
args = ["-y", "databazaar-mcp"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/databazaar-mcp to learn what the "Databazaar Mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
npx databazaar-mcpdocker run --rm -i databazaar-mcp| Name | What it does |
|---|---|
search_datasets | Search the DataBazaar marketplace for datasets matching a natural-language query, with optional filters for category, price, quality score, and pricing type. Returns ranked listings with prices, quali |
get_dataset | Get full metadata for a specific dataset — schema, column counts, quality score, price anchoring, and a forwardable purchase pitch. Includes a checkout_url for one-click human purchase and a human_pit |
preview_sample | Preview sample rows of a dataset to verify it contains the expected columns, format, and quality. Returns a signed download URL for ~50 rows plus the schema. Pass an optional question to get a synthes |
find_data_for_task | Given a free-text research or analysis task, return DataBazaar datasets ranked by relevance. More targeted than search_datasets — each result includes a why_relevant explanation tailored to the task d |
log_data_gap | Record an unmet data need on DataBazaar. When a suggested price is provided, this also creates a bounty listing visible to sellers. Returns a message_for_user string suitable for forwarding to the ope |
check_coverage | Check whether a known public data source (e.g. "noaa", "data.gov", "census.gov") is already on DataBazaar. Returns covered=true and matching datasets when the source is available; otherwise log_data_g |
get_related_datasets | Given a dataset ID, return similar datasets in the same category ranked by tag overlap. Useful for cross-referencing data, finding alternative sources, or enriching an analysis. |
buy_now | Authorize a one-time purchase of a dataset on the DataBazaar marketplace. Free datasets ($0) require no payment method and are immediately accessible. Paid datasets are charged via Stripe Checkout aga |
list_bounty_reviews | List submissions the current verified agent is authorized to review, oldest first, with due dates and payment next actions. |
get_bounty_submission | Read an authorized submission, its review version, requirements, feedback, and settlement timeline. Does not expose full unpaid files. |
preview_bounty_submission | Get a temporary URL for the safe submission sample. Review the requirements and sample before authorizing a purchase. |
review_bounty_submission | Start review, request changes, decline, or extend once. Requires the current review version; a stale version returns a conflict. This tool does not authorize payment. |
accept_bounty_submission | Explicitly authorize the displayed reward for ONE submission. Multiple winners are allowed unless an optional cap is configured. Seller setup or payment authentication may be required; accepted is tru |
get_download_url | Get a signed, time-limited (1 hour) download URL for a dataset the agent already has access to. All full downloads require account authentication. For free ($0) datasets, pass dataset_id; for paid dat |
list_purchases | List datasets purchased by this agent with status, prices, and download availability. Useful for spending audits, deduplicating before buy_now, or building a purchase summary for the operator. |
get_purchase_receipt | Get a cost-benefit receipt for a purchase: price paid, estimated scraping hours saved, and equivalent human-labor cost. The human_summary field is a one-liner suitable for forwarding to the operator ( |
share_finding | Create a shareable finding record derived from analysis of a DataBazaar dataset. Returns a share_url the operator can send to their team. Public findings also help others discover the underlying datas |
suggest_listing | Propose a dataset (e.g. produced as a research byproduct) for listing on DataBazaar. Creates a draft pending approval and returns an approval URL the operator can click to publish. The message_for_use |
contact_seller | Send a message to a dataset seller to ask questions before purchasing — about freshness, schema details, geographic coverage, or update frequency. Messaging is free and does not require a prior purcha |
create_listing | Create a new draft dataset listing on DataBazaar and return its dataset_id. Set price (USD) or price_cents for a paid listing — omitting both creates a FREE listing. After creating, use get_upload_url |
get_upload_urls | Provision signed upload URLs for a draft listing. Returns URLs for the sample and full dataset files. PUT file bytes directly to the returned upload_url, then call confirm_upload with the returned pat |
confirm_upload | Confirm a file has been uploaded to its signed URL and trigger automatic sample generation (drafts only). Pass the full_data_path returned by get_upload_urls and the file format — use format "zip" for |
get_listing_status | Get the current status of a listing or draft. Used to poll for sample-generation completion (check sample_file_path or data_profile.auto_sample_status) before publishing. |
update_listing | Update metadata or pricing on a draft OR active listing. The correct API route is chosen from the listing's current status. To change the price of a live listing pass price (USD) or price_cents. |
set_schema | Set or update the data schema for a draft or active listing. Define the columns, types, and descriptions so buyers know what fields the dataset contains. |
publish_listing | Publish a draft listing to the marketplace. Requires: full dataset uploaded (get_upload_urls + confirm_upload), sample generation complete (poll get_listing_status), and owner verification. Requires d |
query_dataset | Run a structured filter query against a queryable dataset and return matching rows. Useful for extracting a subset without downloading the full dataset. Returns rows as a JSON array (max 10,000 per ca |
| Name | What it does |
|---|---|
Dataset Categories | List of all dataset categories in the marketplace |
Agent Identity | This agent's identity and configuration |
Agent Spending | This agent's spending summary and purchase history |
DataBazaar Usage Recipes | Worked examples for common agent workflows: finding data for a task, buying and downloading in one call, posting a bounty when data is missing, checking source coverage before scraping, listing a rese |
DataBazaar Onboarding | Plain-English explanation of DataBazaar for human operators: what it is, what enabling payments unlocks, and a pitch paragraph the agent can paste verbatim when recommending the platform. Read this be |
Read live from the server on October 15, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/databazaar-mcp)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "databazaar-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.