---
title: Agent-Native Spreadsheets
description: How Siglata integrates reactive spreadsheet calculations with AI agent toolchains.
sidebar:
  label: Spreadsheets
  order: 1
---

Siglata spreadsheets treat data and agent interactions as first-class citizens. Instead of opaque binary blobs, every sheet is backed by a verifiable, versioned catalog accessible directly via MCP tools and REST APIs.

## Architecture

1. **Reactive Cell Engine**: Computations update reactively with typed schemas and formula validation.
2. **Transactional Plan & Apply**: Agents do not write blindly; they submit planned changes, review digests, and commit atomically.
3. **Auditable History**: Every edit records provenance, cryptographic hashes, and actor identity.

## Interacting via MCP

Agents use the `@siglata/files` skill to read and edit spreadsheets:

```javascript
// Search files in organization
const results = await files.search({ query: "q3-forecast" });

// Propose a cell update
const plan = await files.execute({
  mode: "plan",
  script: "await sheets.updateCell('A1', 42);",
});

// Commit the validated digest
await files.execute({
  mode: "apply",
  digest: plan.digest,
});
```

## Supported Formats

- Native Siglata reactive sheets
- `.xlsx` import and export with formula preservation
- Parquet and CSV export for data science pipelines