AI integration

Use Data Gatherers safely with LLMs

Authenticated, read-only aggregate marketplace intelligence tools for authorized Data Gatherers users. This guide is generated from the public MCP tool catalog so assistants can learn the intended workflow, authentication boundaries, and data safety rules before calling tools.

Non-negotiable safety rules

  • Never request or expect raw scraped records from client-facing MCP tools.
  • Client-facing MCP tools expose metadata, coverage, freshness evidence, and aggregate analysis only.
  • Every tool call is authorized against the authenticated user's organizations, projects, roles, and scopes.
  • Use project-scoped country, provider, and integration values returned by the tools before constructing filters.
  • Treat empty aggregate responses as inconclusive until coverage and freshness have been checked.

Recommended assistant workflow

  1. Discover accessible projects with datagatherers_list_projects.
  2. Inspect project coverage using datagatherers_get_project_context.
  3. Discover supported analyses and filters using datagatherers_describe_project_analysis.
  4. Run bounded aggregate queries or comparisons only after the analysis contract is known.
  5. Use coverage explanations when results are empty, stale, partial, or hard to compare.

Published public tools

datagatherers_list_projects

List Data Gatherers projects visible to the authenticated user.

read-only

datagatherers_get_project_context

Describe safe metadata and aggregate coverage for one authorized Data Gatherers project.

read-only

datagatherers_describe_project_analysis

Describe registered aggregate analyses, registered filter option providers, and safe filter rules for one authorized project.

read-only

datagatherers_query_project_analysis

Run any registered aggregate Data Gatherers project analysis with safe bounded filters. Returns aggregate results only, never raw scraped records.

read-only

datagatherers_explain_analysis_coverage

Explain safe coverage, freshness evidence, caveats, and recommended next steps for an authorized project/filter set. Returns metadata only, never raw scraped records.

read-only

datagatherers_compare_markets

Compare authorized Data Gatherers markets across countries, providers, or projects using bounded aggregate analysis queries. Returns aggregate results only, never raw scraped records.

read-only