Documentation Index

Fetch the complete documentation index at: https://docs.dataddo.com/llms.txt

Use this file to discover all available pages before exploring further.

Data Delivery to AI & Agents

Prev Next

By the end of this article, you will know how to use Dataddo to keep the storage layer behind your RAG and LLM pipelines filled with fresh, quality-checked, PII-safe data, how to serve real-time-sensitive AI use cases from a CDC-replicated operational mirror, and how AI models and agents can retrieve the latest data directly through the MCP server with no storage layer of their own. Choose this pattern when the consumer of your data is an AI system rather than a person. If your goal is analytics in a warehouse, see Batch Ingestion to Data Warehouses; for raw large-volume landing zones, see Data Lake Ingestion; for pushing events to streaming backbones, see Streaming to Event Systems.

Architecture

AI systems rarely read from SaaS APIs directly. In practice, an embedding, retrieval, or fine-tuning pipeline reads from a warehouse, data lake, or object storage that something else keeps up to date. Dataddo is that something else:

  1. Sources extract data from your business applications on a schedule you control (see Batch Extraction). PII exclusion and hashing are applied here, at the source, before data leaves the extraction step.
  2. Flows move the data to the destination. The Data Quality Firewall validates data at the flow level and can block non-compliant records from ever reaching the storage your AI pipeline reads from.
  3. Destinations are the storage systems your AI tooling already consumes: data warehouses such as BigQuery, Snowflake, or Databricks, and file or object storage such as Amazon S3 or Azure Blob Storage (see Data Storages).

Your embedding or retrieval jobs then read from that destination on their own schedule. Dataddo does not run your vector database or your model; it guarantees that what enters the storage feeding them is current, validated, and stripped of sensitive fields.

Choosing an Architecture

AI systems can consume Dataddo-delivered data through three patterns. Which one fits depends on how fresh the data must be, how much history the AI needs, and whether you want to operate a storage layer at all:

  • Warehouse, lake, or object storage (described above) is the default: it holds long time-series ranges, so it suits RAG corpora, fine-tuning datasets, and any retrieval that reasons over history.
  • A CDC-replicated operational mirror serves real-time-sensitive use cases. Dataddo's high-throughput, log-based CDC replication keeps a continuously updated replica of your production database that an AI system can query with near-instant freshness, without overloading the production database itself. A typical example is a customer support chatbot that needs the current state of orders, tickets, or accounts the moment a customer asks.
  • Direct data retrieval via the MCP server works like dashboard delivery without a warehouse: extracted data is held in SmartCache and retrieved directly through a REST interface (JSON or CSV) or Apache Arrow, integrated with the MCP server. The model or agent gets the latest extracted data with no storage layer to operate. The trade-off: SmartCache holds recent extractions, not the long time-series ranges a warehouse or lake provides.
Warehouse / data lake Real-time CDC replica Direct retrieval (SmartCache via MCP)
Data freshness Per extraction schedule (batch) Near real time, continuous Latest completed extraction
History depth Long time-series ranges, full history Current state of the replicated tables Recent extractions only
Storage you operate Your warehouse / lake Your replica database None (Dataddo-hosted)
How AI reads it SQL / files, read by your pipeline SQL against the replica MCP tools, REST (JSON/CSV), Apache Arrow
Use when RAG corpora, fine-tuning, time-aware retrieval Latency-sensitive operational AI, e.g. support chatbots, without loading the production database Agents and models that need fresh data with zero infrastructure

The three patterns combine well: a support chatbot can answer order-status questions from the CDC replica while its knowledge base is re-embedded from the warehouse, and an agent can pull the latest campaign numbers through MCP.

Pillar 1: Feeding RAG and LLM Pipelines from Governed Data

RAG quality is bounded by the quality of the corpus. Two Dataddo capabilities matter here:

  • Scheduled delivery. Configure the extraction frequency to match how fresh your AI answers need to be, down to short intervals where the source API allows it. The snapshot keeping policy (append vs. replace) determines whether your pipeline sees a growing history or only the latest state.
  • Data Quality Firewall. Configure column-level rules that check for null values, zero values, and anomalies. In blocking mode, records that fail the rules never land in the table your embedding job reads, so a broken upstream export does not silently poison your index. In non-blocking mode you are notified and can decide whether to re-index.

Source Metadata for AI Consumers

AI systems work better when the data explains itself. Beyond the row-level technical metadata (dataddo_hash as a stable natural key, dataddo_extraction_timestamp for freshness), Dataddo can also output the metadata about the sources themselves that is available in its connectors:

  • Dataset descriptions - what a given dataset represents.
  • Field descriptions - the meaning of each column, as defined by the connector.
  • Field sensitivity / PII presence - which fields are flagged as sensitive or containing personal data.

For AI consumers this is directly useful context: dataset and field descriptions give retrieval and text-to-SQL agents the semantic grounding they otherwise have to guess at, and sensitivity flags let governance checks run automatically against what actually lands in the corpus.

Pillar 2: Governance for AI-Bound Data

Once a sensitive value is embedded into a vector store or absorbed into a fine-tuned model, removing it is difficult. The safest place to handle PII is therefore before delivery, and Dataddo does this at the source:

  • PII exclusion removes sensitive columns (names, addresses, personal identifiers) during source configuration, so they never enter the destination or any AI system downstream. See PII Exclusion and Hashing.
  • Column hashing replaces sensitive values with irreversible, deterministic hashes. Because the same input always produces the same hash, your AI pipeline can still join, deduplicate, and match records on the hashed column without ever seeing the original value. Supported hashing algorithms are md5 and xxh3.

This keeps the governance decision in one place: whatever tools read from the destination later, they can only see what you allowed through.

Pillar 3: Agents via MCP

The Dataddo MCP server is an early prototype. Its capabilities are limited and may change without notice. Do not build production workflows on it yet.

Beyond delivering data for AI, Dataddo can be operated by AI. The Dataddo MCP Server lets MCP-compatible clients (Claude, ChatGPT, Cursor, Gemini, and others) call Dataddo tools from a conversation:

Endpoint URL https://headless.dataddo.com/mcp
Transport Streamable HTTP
Authentication Dataddo API access token (Authorization: Bearer <token> header), obtained via Headless API Authorization
Rate limits Shares the Headless API quota of 10,000 calls per day

Data retrieval is available through the MCP server: extracted data held in SmartCache can be retrieved via the REST interface (JSON or CSV) or Apache Arrow, as described in Choosing an Architecture above. See the Dataddo MCP Server article for the current tool list. Planned capabilities include pipeline management (create and inspect sources, destinations, and flows) and monitoring and troubleshooting. Until those ship, agents that need to manage pipelines programmatically should use the Headless API directly; see Embedded Integration via Headless API.

The token you give an AI client carries the same permissions as your Dataddo user. Treat it like a password and review any changes an assistant makes.

Related: this documentation itself is AI-readable. Agents can fetch the full index at https://docs.dataddo.com/llms.txt and read any article as Markdown by appending .md to its URL.

Decision Guide

For AI-bound tables, the write strategy determines what your embedding pipeline sees between runs: upsert keeps a deduplicated, current-state table that is easy to re-index incrementally, insert with append snapshotting preserves history for time-aware retrieval, and truncate insert gives a clean full refresh when you re-embed everything anyway. Two metadata fields make these strategies practical for RAG ingestion: the Dataddo Hash gives you a stable natural key for deduplicating and updating documents (use it directly as the upsert composite key), and the Dataddo Extraction Timestamp lets your pipeline process only rows extracted since its last run.

Setup Walkthrough

  1. Create a data source. During configuration, unselect PII columns to exclude them, or mark them for hashing (see PII Exclusion and Hashing).
  2. Connect a destination your AI pipeline reads from: a warehouse for structured retrieval, or object storage for document-style corpora (see Data Lake Ingestion for file naming and format guidance).
  3. Create a data flow and configure Data Quality Firewall rules in blocking mode for columns your retrieval logic depends on.
  4. Point your embedding or retrieval jobs at the destination table or bucket. Schedule them at or below the extraction frequency to avoid indexing stale data.
  5. Optionally, connect your AI client to the MCP server to retrieve the latest extracted data directly (REST JSON/CSV or Apache Arrow) and, as planned tools ship, manage these pipelines conversationally.

Configuration Recommendations

Scenario Write mode Snapshotting Notes
Current-state corpus for RAG (re-index changed rows) Upsert Replace Composite key required; enables incremental re-embedding
Historical/time-aware corpus Insert Append Pair with date columns so retrieval can filter by period
Full re-embed on every run Truncate insert Replace Simplest; destination always mirrors the latest extraction

Operations

  • Backfilling: to load historical data into a new corpus, use Data Backfilling to Storages. Note that Data Quality Firewall rules are enforced during manual inserts too; you can bypass them with Skip flow rules validation if a strict rule blocks a historical load.
  • Monitoring: firewall rules in non-blocking mode log discrepancies and notify you, giving a signal for when to re-index. For MCP usage, watch the X-RateLimit-Remaining header against the shared 10,000 calls/day quota.

Troubleshooting

  • Blocked flows after enabling firewall rules: a blocking rule halted transfer. Review the logged discrepancy, fix or relax the rule, then re-run. See Data Quality Firewall.
  • MCP client cannot connect: verify the URL is exactly https://headless.dataddo.com/mcp and that the client supports Streamable HTTP (SSE-only clients are not supported). Expired tokens are the most common authentication failure.
  • For generic pipeline issues, see Troubleshooting.

Related Connectors and Next Steps