# Data Gatherers AI / LLM Integration

Authenticated, read-only aggregate marketplace intelligence tools for authorized Data Gatherers users.

Primary documentation:
- https://datagatherers.com/llms-full.txt
- https://datagatherers.com/docs/ai
- https://datagatherers.com/docs/mcp

MCP resource:
- https://mcp.datagatherers.com/mcp

Authorization:
- https://oidc.datagatherers.com
- https://mcp.datagatherers.com/.well-known/oauth-protected-resource

Important 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 workflow:
1. Call datagatherers_list_projects to discover authorized projects.
2. Call datagatherers_get_project_context for safe coverage context.
3. Call datagatherers_describe_project_analysis before querying unfamiliar analyses.
4. Call datagatherers_query_project_analysis or datagatherers_compare_markets with bounded filters.
5. Use datagatherers_explain_analysis_coverage when results are empty, stale, or hard to compare.

Public client-facing tools:
- datagatherers_list_projects: List Data Gatherers projects visible to the authenticated user.
- datagatherers_get_project_context: Describe safe metadata and aggregate coverage for one authorized Data Gatherers project.
- datagatherers_describe_project_analysis: Describe registered aggregate analyses, registered filter option providers, and safe filter rules for one authorized project.
- datagatherers_query_project_analysis: Run any registered aggregate Data Gatherers project analysis with safe bounded filters. Returns aggregate results only, never raw scraped records.
- 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.
- 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.