# ASTra

> ASTra is a freemium MCP server for files and documents. Let agents read, edit, validate and undo Word .docx files with exact operations. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, self-hosted
- **Website:** https://attentionform.com
- **Repository:** https://github.com/attentionform/astra/tree/HEAD/packages/mcp-server
- **GitHub stars:** 0
- **MCP Registry name:** com.attentionform/astra-mcp-server
- **Categories:** files and documents
- **Listing updated:** 2026-11-14

## About

A .docx is zipped XML, and one stray tag can ruin it. ASTra gives agents a cleaner view: every paragraph, table and chart appears as a row with a stable ID, and changes are typed operations aimed at those IDs. Saves are checked against the schema, and the registry says every save is kept as a git commit, so edits can be undone.

The demo shows a flow of open_document, compose_document, validate_document, visual_inspect and save_document. The site also lists atomic batches, sandboxed folders and a CLI plus TypeScript engine alongside the MCP server.

The local server runs over stdio from npm. ASTra is source-available, and the pricing page says solo workers, schools, non-profits and small organisations use it free in production, while larger organisations buy a licence.

## Features

- **Stable IDs:** Paragraphs, tables and charts each have a handle.
- **Schema-checked saves:** Files are written only if validation passes.
- **Git-style history:** Every save is a commit, so edits can be undone.
- **Atomic batches:** Groups of operations apply together.
- **Sandboxed folders:** Access is limited to chosen folders.

## Good for

- Build a board report from notes
- Edit a table cell without breaking the file
- Validate a generated contract before sending
- Roll back a bad automated edit

## Install

### Claude Code (Terminal)

```sh
claude mcp add astra-mcp-server -- npx -y @attentionform/astra-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "astra-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@attentionform/astra-mcp-server"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "astra-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@attentionform/astra-mcp-server"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "astra-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@attentionform/astra-mcp-server"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "astra-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@attentionform/astra-mcp-server"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "astra-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@attentionform/astra-mcp-server"
      ]
    }
  }
}
```

## Tools

- `open_document`: Opens a Word document.
- `compose_document`: Composes document content.
- `validate_document`: Validates the document.
- `visual_inspect`: Inspects the document visually.
- `save_document`: Saves the document after validation.

## FAQ

### Who can use it free?

People working alone, schools, non-profits and small organisations, with limits on revenue.

### What is the licence type?

Source-available.

### How is it run?

Locally over stdio via npm.

### Can edits be undone?

Yes, saves are kept as git commits.

### Is ASTra free?

ASTra has a free plan, with paid plans for more usage or features.

### How do I add ASTra to Claude Code?

Run this command in your terminal: claude mcp add astra-mcp-server -- npx -y @attentionform/astra-mcp-server

### What are the best alternatives to ASTra?

The closest alternatives to ASTra are CARTESIAN ECU, Invoices, SigPen, ConvertAudioToText and WhoScribe.

## Alternatives

- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.
- [Agent Data Tools: Documents to text](https://ai-powered.com/mcp/agent-data-tools-documents-to-text): Agent Data Tools: Documents to text is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/astra
