ASTra
NPM · @ATTENTIONFORM/ASTRA-MCP-SERVER
Lets AI agents edit Word (.docx) files. Every save is schema-checked and kept as a git commit.
Available components
Last scanned (18 hours ago)
Scores higher than 41% of npm servers
Category Documents and Files
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 48 of 135 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency87
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to Attentionform/astra). View diagnostics → Pass
- License check failed: the license (BUSL-1.1) isn't a recognized OSI-approved license. See how to fix → Fail
- Actively maintained (last published 4 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability52
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 9075 tokens (~477/item across 19 items; 19 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage70
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 9% of tool parameters carry a description.Partial
Tool Safety75
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "execute_batch" implies "execute" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
- An AI judge read all 19 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Checks we ran (15)
- Malware scan
- Known CVEs
- Install scripts
- Dependency health
- Source repository
- Provenance
- License
- Maintenance
- Security disclosure
- Schema quality
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Checks we could not complete (1)
These are gaps on our side, not findings about this package. We only credit what we can confirm, so a category made up entirely of them scores 0.
- Stability in Stability & Change Management (scores 0 for this)Stability not yet verified: not enough scan history yet (needs a 30-day window).
Does not apply to this package (2)
- Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
- Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 16 Nov 26 0
- Security disclosure: unverified → pass ▲ functional
- 15 Nov 26 0
- Security disclosure: pass → unverified ▼ functional
- 12 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- 11 Nov 26 55
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Nov 2026 · Analysed npm/@attentionform/astra-mcp-server@0.4.1
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | npm |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | Attentionform/astra |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/Attentionform/astra/.github/workflows/release.yml@refs/heads/main |
| Rekor log index | 3809124931 |
| Predicate type | SLSA build provenance https://slsa.dev/provenance/v1 |
| Subject digest | sha512:71862f64c551caa49f2174c8c08ecbf89d32bd265c8747458b4e92927101a2dc54f64914cea4f8e753c93b1511f09bda1c3f9e7e7e8d9ce453e9ea98f |
Background: How many MCP packages publish verified provenance →
Dependencies 135 packages
| Packages resolved | 135 |
|---|---|
| Stale | 48 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
close_document ~118
Evict a session and release its lock/memory. Returns {ok:true,sessionId,dirty,discardedRevisions,warning?}: a dirty close warns (dirty:true + warning naming the discarded unsaved revision count) instead of silently discarding; save first when the warning matters. Example {"sessionId":"sess_abc"} -> {"ok":true,"dirty":false,"discardedRevisions":0}. Close when finished; expired sessions (30min idle) must be re-opened.
| Name | Type | Req | Description |
|---|---|---|---|
| sessionId | string | yes | – |
No output schema declared.
No examples provided.
compose_document ~1,231
Compose a Markdown string into the open session document (appends after existing content, or at anchor with position before|after; an unchanged built-in template created in this session has its sample content replaced). A document can be built in several compose calls: the first call of a session mints ids md_0001..., later calls mint md2_0001..., md3_0001..., so ids never collide; pass anchor (a node id, start or end) and position to add a section in the middle without another tool. Runs the engine compose path, then applies the resulting operations through the same execute_batch path (strict schema gate, per-chunk quotas, structural checks, per-chunk atomic rollback, then inline-span run splitting), so every gate a batch meets applies here unchanged. Supported input: #/##/### headings (real Heading1..3 styles), blank-line paragraphs (single newlines join with a space), flat bullet (-, *, +) and ordered (1., 1)) lists with real numbering, GitHub-style tables with a header separator row (header row shaded and repeated), --- dividers, fenced or indented code blocks (monospace, line breaks kept), [^label] footnotes with definitions, inline spans (**bold**, *italic*, `code`, [text](url)) applied as runs with real hyperlink targets, plain `> quote` blocks (written in the Quote paragraph style: blank > lines start a new paragraph, > > nests up to 3 levels, flat lists and fenced code are kept inside, a table, heading or image inside a quote fails), and standalone block images/charts () resolved from allowedDir. Out-of-scope input fails closed with E_VALIDATION plus a 1-based line number and writes nothing: raw HTML (except [!NOTE]-style alert callouts, which compile to callout containers and keep bold, italic, code and links), custom styles, deeper headings, nested lists or tables, task items. Block image/chart refs need allowedDir pointing at the folder holding the files (refs stay jailed inside it; without allowedDir they fail closed); remote URL refs fail…
| Name | Type | Req | Description |
|---|---|---|---|
| allowedDir | string | – | – |
| anchor | string | – | – |
| dollarMath | boolean | – | – |
| markdown | string | yes | – |
| position | string | – | – |
| sessionId | string | yes | – |
| styleGuide | string | – | – |
| template | string | – | – |
No output schema declared.
No examples provided.
execute_batch ~1,321
Apply 1..500 strictly-typed operations atomically (strict discriminatedUnion per action; sequential:true default preserves document order; Tracked edits return revisionIds; trackedChange accept/reject selects by ids, author or target and reports revisionResolution {resolved,unresolved,removedBookmarks,removedComments,staleLinks}. Comment operations include resolve, unresolve and delete and take an id as 3 or comment:3. single edit = 1-item batch). Caps 500 ops / 200MB throw E_QUOTA with remedy (maxSteps is an optional positive integer, unbounded when omitted). Client-supplied op ids are honored where the schema allows (insert/equation/footnote/chart accept `id`; strict schemas reject it elsewhere). Style ops support word-level spans: `match` styles only the matched substring (run splitting; `matchAll` styles every occurrence, `matchCase:false` matches case-insensitively); an absent match fails with E_NOT_FOUND. Returns {ok:true,appliedCount,revision,skippedIds,createdNodeIds,results:[{index,action,createdNodeIds}],revisionsPending,revisionsUnresolved?,revisionsRemedy?} where createdNodeIds After a trackedChange that left revisions it could not resolve, revisionsUnresolved counts them and revisionsRemedy lists kind, node and reason instead of repeating acceptAll. lists new node ids in document order (use them as anchors in the next batch without re-inspecting). A batch that drops a non-empty redo stack signals it (redoCleared:true + redoClearedWarning naming the depth): a fresh edit invalidates redo, so redo_document afterwards reports an empty stack. Example {"sessionId":"sess_abc","operations":[{"action":"replace","target":"p_001","text":"Hello"}],"sequential":true} -> {"ok":true,"appliedCount":1,"revision":2}. On failure returns {ok:false,code,remedy} with a fix-and-retry hint. Image inserts take exactly one source: {action:"image",operation:"insert",anchor,fileData} for inline base64 bytes, or {action:"image",operation:"insert",anchor,filePath} for a file read f…
| Name | Type | Req | Description |
|---|---|---|---|
| allowedDir | string | – | – |
| maxSteps | integer | – | – |
| operations | array | yes | – |
| rollbackOnError | boolean | – | – |
| sequential | boolean | – | – |
| sessionId | string | yes | – |
| styleGuide | string | – | – |
No output schema declared.
No examples provided.
export_document ~346
Export the active document to HTML, Markdown, or PDF format with sandbox security gating. Renders the in-memory session state (includes unsaved execute_batch edits, not the last saved file); success returns {ok:true,format,path|content,bytes,dirty,revision,imageMode,assetPrefix,assets,assetCount} (dirty:true = unsaved edits present). For Markdown exports, images default to extracted files in a unique generation within a sibling <doc_basename>_assets/ directory when outPath is specified; in-memory exports default to embedded base64 data URIs. PDF renders via headless LibreOffice: a ~11s first-render cold start is expected behavior, not a bug. Failures return {ok:false,code,message,remedy}.
| Name | Type | Req | Description |
|---|---|---|---|
| assetPrefix | – | – | Markdown only: relative directory prefix for extracted image assets (default: "<doc_basename>_assets") |
| format | string | yes | Target export format: "html", "markdown", "md", or "pdf" |
| imageMode | – | – | Markdown only: "file" requires outPath and writes image assets under a unique generation in sibling <doc_basename>_assets/; "embed" uses base64 data URIs. Default is "file" with outPath and "embed" o… |
| outPath | – | – | Optional output destination path (must reside inside allowed directory) |
| sessionId | string | yes | Active document session ID returned by open_document |
| strict | – | – | PDF only: fail closed on preflight blockers (default false, warn-only) |
| tagged | – | – | Alias of tagged_pdf |
| tagged_pdf | – | – | PDF only: tagged (accessible) render (default true) |
No output schema declared.
No examples provided.
get_document_history ~229
List the saved git history for a session (newest first, read-only: never mutates, never flips dirty). Paginate with limit (1-100, default 20) and offset (default 0). Returns {ok:true,sessionId,documentPath,currentCommit,totalCommits,history:[{oid,message,author,timestamp,timestampMs,opCount,affectedNodeIds,resultingHeadOid}]} (timestampMs = ms-precision epoch millis; commit-time clock for tracked commits, git seconds for older ones; opCount is always present (0 for pre-tracking commits and heals-only saves: it folds operations, not normalizer rewrites); affectedNodeIds is always present ([] when untracked); resultingHeadOid always equals oid (append-only; refs never move). Example {"sessionId":"sess_abc","limit":10} -> history slice. Use the oids with revert_document (or preview_revert first) to restore an earlier saved state.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | – |
| offset | integer | – | – |
| sessionId | string | yes | – |
No output schema declared.
No examples provided.
get_stats ~215
Token-cheap document census for a session: words, paragraphs, tables, callouts, images, and an estimated editorial page budget (layout-weighted by words, tables, images, and explicit page breaks) in a single small envelope. Counters are the exact engine counters behind CLI stats, so both surfaces always agree. Physical pagination is finalized when exporting to PDF via LibreOffice. Read-only: never mutates, never bumps the revision. Returns {ok:true,sessionId,revision,dirty,words,paragraphs,tables,callouts,images,pages}. A callout (a "> [!NOTE]" alert or a callout op: a one-cell table with a fill) is counted in callouts and not in tables. Use instead of inspect_document when only counts are needed (a full TOON dump costs thousands of tokens for the same question). Example {"sessionId":"sess_abc"} -> {"ok":true,"words":42,"paragraphs":5}.
| Name | Type | Req | Description |
|---|---|---|---|
| sessionId | string | yes | – |
No output schema declared.
No examples provided.
import_document ~310
Ingest an on-disk Markdown file into the OPEN session (the file-ingress half compose_document lacks: compose takes an inline string only). Reads the file under the workspace jail, then runs the identical compose pipeline (strict compile gate, quotas, template-seed check, inline-span splitting), so the result is byte-equal to composing the same Markdown inline. sessionId is strictly required: the tool never auto-creates sessions (fresh templated document: new_document first, then import; existing file: open_document first, then import). Accepts .md/.markdown/.txt; .html/.htm refuse with E_VALIDATION (convert to Markdown first, same verdict as CLI import); .docx refuses with E_VALIDATION naming open_document (open .docx files directly). Outside-jail reads fail E_SANDBOX, missing files E_IO, oversize files E_LIMIT. Optional allowedDir (image refs), template (report|memo|blank seed check), and styleGuide (same attach semantics as compose_document). Optional dollarMath (default false) treats $...$ as inline math; off by default because prices and shell text can look like math. Example {"sessionId":"sess_abc","path":"documents/notes.md"} -> compose envelope.
| Name | Type | Req | Description |
|---|---|---|---|
| allowedDir | string | – | – |
| dollarMath | boolean | – | – |
| path | string | yes | – |
| sessionId | string | yes | – |
| styleGuide | string | – | – |
| template | string | – | – |
No output schema declared.
No examples provided.
inspect_document ~1,152
Inspect a session: standard TOON outline (fidelity compact|standard|full, default standard) plus style palette passthrough {availableStyles,brandColors,primaryFont} parsed from word/styles.xml, plus document core properties `metadata` {title,creator,subject,description,keywords,category,lastModifiedBy,revision,created,modified} read from docProps/core.xml (absent when the docx has no core part). Use include:["comments","revisions"] for review records paged by reviewOffset/reviewLimit (max 50; offset/limit page nodes only); commentId or revisionId reads full detail and needs its include. Renders the in-memory session state (includes unsaved execute_batch edits); `dirty:true` means the session differs from the last saved file, `revision` is the in-memory revision. Node ids are verbatim: paragraphs carry 8-hex w14:paraId (e.g. 3F2A9C1B), tables t_001.., sections sec_root, sec_2, sec_3.. by position; use them as-is for targets/anchors. A repeat paragraph sharing one native paraId reports a `<paraId>_dup` session id instead (e.g. 3F2A9C1B_dup): saving refuses until the repeat is deleted and its text reinserted for a fresh id. Tables render one row per table with grid cells as rNcM coordinates (r1c1 value | r1c2 value, rows joined by ;); merged spans are marked (spanN); merge covers are tagged hidden-cover (not directly editable, address the restart cell). Cell edits: the replace, style, namedStyle, clearFormat, hyperlink, bookmark and comment actions accept target "<tableId>:r<row>c<col>" (1-based, as the grid prints it; add ":p<n>" to pick one paragraph of a multi-paragraph cell). Other actions, including table, take the table id. Every row and column number counts from 1 (cell addresses, rowIndex, colIndex, columnIndex, row, col, index, afterIndex, fromRow/toRow/fromCol/toCol), so r3c2 and {rowIndex:3,colIndex:2} are the same cell. Chart nodes render style chart|chart3d with title + categories + series in the text ([Chart column] Title | cats: Q1,Q2 | ARR: 10,25), rea…
| Name | Type | Req | Description |
|---|---|---|---|
| aroundNode | string | – | – |
| commentId | integer | – | – |
| fidelity | string | – | – |
| include | array | – | – |
| limit | integer | – | – |
| maxTextLength | integer | – | – |
| maxTokens | integer | – | – |
| offset | integer | – | – |
| reviewLimit | integer | – | – |
| reviewOffset | integer | – | – |
| revisionId | integer | – | – |
| sectionId | string | – | – |
| sessionId | string | yes | – |
| window | integer | – | – |
No output schema declared.
No examples provided.
new_document ~389
Create a new .docx from a template (report|memo|blank, default blank) at outPath inside an allowed folder (the folders named with --allowed-dir or ASTRA_EXTRA_DOC_ROOTS; only when none are named, ./documents and the system temp folder). Validates the fresh package before writing (E_VALIDATION when invalid, never writes corruption); refuses to overwrite without {force:true} (E_CONFLICT). Success returns {ok:true,path,sessionId,revision,template,bytes} with the file opened into a session (use sessionId for inspect/execute_batch/save). Example {"outPath":"documents/new-report.docx","template":"report"}. Session ids are server-minted (sess_<uuid>, DEPRECATED to supply sessionId: client-supplied values are rejected with E_VALIDATION; deterministic ids are test-only via --allow-client-session-ids). IDs are session-scoped: valid only in the issuing session, must not be stored across sessions. Optional styleGuide (bundled guide name or guide .md path, jailed to the document folder; remote URLs fail closed) attaches a house style to the session at creation: later batches inherit its table/chart/callout defaults, inspect_document shows its compact summary, save_document reports advisory styleWarnings. Guides cannot be detached afterwards: open a new session to work without a guide. Unknown names fail with E_VALIDATION naming the available set.
| Name | Type | Req | Description |
|---|---|---|---|
| author | string | – | – |
| force | boolean | – | – |
| outPath | string | yes | – |
| sessionId | – | – | DEPRECATED: session ids are server-minted (sess_<uuid>); omit sessionId and use the returned id. Client-supplied values are rejected with E_VALIDATION (deterministic ids are test-only via --allow-cli… |
| styleGuide | string | – | – |
| template | string | – | – |
No output schema declared.
No examples provided.
normalize_document ~244
Canonical repair for an open session document: runs the same allowlist normalizer CLI normalize calls (verified tag renames, whitelisted default infills, schema-sequence sorts) over the live package, then refreshes the session view and proves the result with a read-only validation verdict. Output bytes match CLI normalize on the same input. When the package is still invalid afterwards, the session is restored untouched and the call fails with E_VALIDATION plus a fix-and-retry remedy (same contract as CLI normalize writing nothing on failure). After the normalizer it repairs known validator error kinds one rule at a time; a rule that adds a validator error or changes the visible text is dropped and listed in rolledBack. Returns {ok:true,sessionId,revision,dirty,normalized,remaining,rolledBack,validation:{valid:true,...}} where normalized lists every rewrite once and remaining counts the validator errors left (-1 when the validator did not run), plus the standard redoCleared signal when a redo chain is dropped. Example {"sessionId":"sess_abc"} -> {"ok":true,"normalized":[...]}. Save after to persist.
| Name | Type | Req | Description |
|---|---|---|---|
| sessionId | string | yes | – |
No output schema declared.
No examples provided.
open_document ~539
Open a .docx file into a session (Map sessionId->DocHandle, LRU 10 docs / 200MB / 30min idle evict). Returns {ok:true,sessionId,revision,summary,evicted} where evicted:string[] lists sessions dropped by the capacity cap to make room (re-open them if needed; later calls with an evicted id fail with E_SESSION plus a close_document remedy). The default summary is compact: palette, counts, header/footer text, chart ids and pending-revision flag. Pass {"summaryOnly":false} for the full structural summary including styles XML. Example input {"path":"documents/report.docx"} -> {"ok":true,"sessionId":"sess_abc","revision":1,"evicted":[]}. Open first; keep the sessionId for every later call. The response also carries validation: {status:"valid"}, {status:"invalid",preExistingErrors,messages,baselineComparable,note} when the file already has validator errors (edits that add no new error can still be saved), {status:"timed-out"} or {status:"skipped"}. The check waits validationTimeoutMs (default 5000 ms; 0 skips it; server flag --open-validation-timeout, env ASTRA_OPEN_VALIDATION_TIMEOUT_MS) and never refuses the open. Macro/active content refuses by default (E_VALIDATION naming the parts): pass {"allowMacros":true} to preserve or {"stripMacros":true} to strip (never both). Session ids are server-minted (sess_<uuid>, DEPRECATED to supply sessionId: client-supplied values are rejected with E_VALIDATION; deterministic ids are test-only via --allow-client-session-ids). IDs are session-scoped: valid only in the issuing session, must not be stored across sessions, and duplicate client-supplied ids are rejected. Workflow: open_document -> inspect_document -> search_content -> execute_batch -> save_document -> close_document. Always inspect first, batch second, save third. Single edit = 1-item batch. Never call twice when once suffices.
| Name | Type | Req | Description |
|---|---|---|---|
| allowMacros | boolean | – | – |
| author | string | – | – |
| path | string | yes | – |
| sessionId | – | – | DEPRECATED: session ids are server-minted (sess_<uuid>); omit sessionId and use the returned id. Client-supplied values are rejected with E_VALIDATION (deterministic ids are test-only via --allow-cli… |
| stripMacros | boolean | – | – |
| summaryOnly | boolean | – | – |
| validationTimeoutMs | integer | – | – |
No output schema declared.
No examples provided.
preview_revert ~295
Read-only WOULD-restore preview for revert_document (never mutates: no revision bump, no disk write, no redo-stack change). Target one commit: {steps:N} walks back N saved commits from the head (1 = the previous saved commit, must be < totalCommits) OR {commitOid:"<40-hex>"} jumps to that commit (mutually exclusive). Returns {ok:true,sessionId,targetOid,targetMessage,targetAuthor,stepsBack,affectedFiles,changedValues,changedValuesTruncated,changedValuesPositional,dirty,dirtyHandling,currentHeadOid,totalCommits} where affectedFiles lists package paths that differ from the target (word/document.xml plus tracked extras). The preview also carries advisory changedValues [{nodeId,before,after}] (live current text -> target restore text, bounded: at most 20 entries, each side at most 200 chars, truncated flag honest; changedValuesPositional:true means either side held orphan ids (no shared id across the boundary, common under duplicate native ids) so before/after pairing is positional, not identity; empty + changedValuesReason when the target range is not computable). Example {"sessionId":"sess_abc","steps":1} -> preview summary. Preview first when a revert would discard unsaved edits.
| Name | Type | Req | Description |
|---|---|---|---|
| commitOid | string | – | – |
| sessionId | string | yes | – |
| steps | integer | – | – |
No output schema declared.
No examples provided.
redo_document ~188
Re-apply the state undone by the last revert_document (pops the per-session redo stack, restores it, commits as new head). Success carries advisory changedValues [{nodeId,before,after}] (pre-redo live text -> restored text, same bounds as save/preview). Empty stack fails with E_NOT_FOUND plus atLatestState:true (a fresh execute_batch edit clears redo, and each redo consumes one entry). Optional author (<=100 chars, default ASTra Agent) + reason (<=500 chars, preferred over message) with the same hygiene as save/revert. Example {"sessionId":"sess_abc"} -> {ok:true,revision,dirty:false}. A successful execute_batch clears the redo stack (fresh edits invalidate redo).
| Name | Type | Req | Description |
|---|---|---|---|
| author | string | – | – |
| message | string | – | – |
| reason | string | – | – |
| sessionId | string | yes | – |
No output schema declared.
No examples provided.
revert_document ~486
Restore an earlier SAVED state as a new head commit (history is append-only; refs never move). Target one commit: {steps:N} walks back N saved commits from the head (1 = the previous saved commit, must be < totalCommits) OR {commitOid:"<40-hex>"} jumps to that commit (mutually exclusive). Bare reverts fail closed: unsaved execute_batch edits refuse with E_CONFLICT unless discardUnsaved:true, which discards them. The conflict remedy names net-zero edits (pending revisions count as dirty even when content matches) and carries dirtyReason with the pending count. Discarded unsaved edits are echoed back as {wasDirty,discardedNodeCount,discardedNodeIds} (counts + ids only, bounded), never silently dropped. Optional author (<=100 chars, default ASTra Agent) + reason (<=500 chars): when either is given the commit subject follows `Revert [N steps] to <oid> by <author>[: reason]`; otherwise the legacy `Revert to <oid>[: message]` shape is kept (message still accepted), and a bare default revert quotes the target commit message in the new subject (`Revert to <oid>: "<target message>"`). Example {"sessionId":"sess_abc","steps":1} -> {ok:true,revertedToCommit,revision,dirty:false,discardedUnsaved,commitOid,commitMessage}. The pre-revert state is kept for redo_document. Selective middle-undo recipe (no cherry-pick: restore the older keeper, then re-apply the kept newer edits): 1) preview_revert the target, 2) revert_document to the older keeper commit, 3) inspect/search for fresh anchors (node ids die on every revert; never reuse pre-revert ids), 4) execute_batch to re-apply the kept newer edits, 5) save_document. Export-check after every mutation: run export_document (or inspect_document) after each revert and each re-apply and confirm the bytes before the next step.
| Name | Type | Req | Description |
|---|---|---|---|
| author | string | – | – |
| commitOid | string | – | – |
| discardUnsaved | boolean | – | – |
| message | string | – | – |
| reason | string | – | – |
| sessionId | string | yes | – |
| steps | integer | – | – |
No output schema declared.
No examples provided.
sanitize_document ~513
Scrub an open session document. By default it removes revision ids, authorship, embedded EXIF and hidden text PII. Tracked changes and comments are kept, with the text of every tracked deletion, unless you ask: acceptAllRevisions:true accepts all tracked changes (deleted text is removed) and stripComments:true removes comments. The CLI presets (bare sanitize, --client-safe, --metadata-only, --redact-pii) turn both on; this tool does not. Macro/active parts are removed on request. It uses the same engine scrub path as CLI sanitize. Body text is kept. Options mirror the engine scrub keys 1:1 (zeroRetention, purgeRSIDs, purgeAuthors, purgeExif, purgePII, acceptAllRevisions, stripComments, replacementAuthor, allowMacros, stripMacros); omitted options take engine defaults. With acceptAllRevisions it returns E_VALIDATION and no file when revision markup remains that cannot be resolved. allowMacros and stripMacros together fail with E_VALIDATION. The PII check looks for email addresses; phone numbers (formatted, or digits after a label such as "phone", "tel", "mobile", "fax", "call" or "contact"); US Social Security numbers (123-45-6789, or 9 digits after "SSN" or "Social Security"); runs of 13 to 19 digits (card numbers). It does not look for other national ID numbers (for example CPF and CNPJ); names; postal addresses; other digit runs without a label. Returns {ok:true,sessionId,revision,dirty,removedRSIDs,purgedAuthors,strippedExifBytes,purgedPII,bodyPII,piiCoverage,acceptedRevisions,strippedComments,strippedMacros,macroParts,filesTouched,droppedRogue,...} plus the standard redoCleared signal when a redo chain is dropped. Example {"sessionId":"sess_abc","stripMacros":true} -> scrubbed session at a new revision (save after).
| Name | Type | Req | Description |
|---|---|---|---|
| acceptAllRevisions | boolean | – | – |
| allowMacros | boolean | – | – |
| purgeAuthors | boolean | – | – |
| purgeExif | boolean | – | – |
| purgePII | boolean | – | – |
| purgeRSIDs | boolean | – | – |
| replacementAuthor | string | – | – |
| sessionId | string | yes | – |
| stripComments | boolean | – | – |
| stripMacros | boolean | – | – |
| zeroRetention | boolean | – | – |
No output schema declared.
No examples provided.
save_document ~740
Validate then persist the session docx; the default policy permits pre-existing validation errors when no new normalized error signatures are detected. Save-blocked remedies are xpath-specific (drawing docPr/id, table tbl/tr/tc, relationships, header/footer parts, session tracking-attribute leaks each name their own fix). Optional commit params: message (commit subject, single-line, max 500 chars; newlines become spaces; blank/omitted falls back to `save_document: rev <n> (<k> ops since last save)`); author (max 100 chars; blank/omitted falls back to ASTra Agent). Over-long message/author fail at the handler with E_VALIDATION plus a shorten-and-retry remedy (never a bare MCP -32602: caps are enforced in the handler, not the wire schema). A successful save clears the session dirty flag (revision is re-synced to the file on disk). When dc:title is still a template placeholder ("Blank Document", "Report") the save writes it from the cover title, the first Title or the first Heading 1 and reports title and titleSetFrom; a title already set is never changed. A file that already had validator errors when it was opened is saved when the edit adds none: the envelope then carries validation:{ok:false,valid:false,errorCount,tolerated:true,preExistingErrors,introducedErrors:0,messages}; a clean save carries validation:{ok:true,valid:true,errorCount:0}. An edit that adds an error is refused with E_VALIDATION naming both numbers, with errorCount and the first 10 errors as errors[{description,xPath}] (validate_document lists them all). Pass {"strict":true} (or start the server with --strict-validation, or set ASTRA_STRICT_VALIDATION=1) to refuse every validator error as before. Paragraphs that share a w14:paraId are renumbered by the save: the first keeps its id, each later copy gets a new one and is listed in normalized, and the state before is recorded in the history (revert_document returns it); strict refuses such a document instead. The success envelope also carries revisio…
| Name | Type | Req | Description |
|---|---|---|---|
| allowMacros | boolean | – | – |
| author | string | – | – |
| message | string | – | – |
| outPath | string | – | – |
| sessionId | string | yes | – |
| strict | boolean | – | – |
| stripMacros | boolean | – | – |
No output schema declared.
No examples provided.
search_content ~361
Search live paragraph/table w:t text; returns [{id,preview}] node hits for anchors/targets. Use scope:"comments" or scope:"all" to search comment text; the default scope is body. At most 50 matches come back; truncated:true says more exist. A table hit also lists `cells` (up to 5 addresses such as t_001:r3c1) for the cells that hold the match; pass one as the target of replace/style/namedStyle/clearFormat/hyperlink/bookmark/comment. Chart titles/series are NOT matched by search (they live in the chart part, not w:t); discover them in inspect TOON chart rows, then anchor by the chart node id. Image alt text and footnote/endnote bodies are NOT matched either (search covers body w:t text only); find images via inspect [IMG] rows and footnotes via their anchor ids. Search extension to those parts is a later-program candidate, not this surface. Default is an exact literal substring (case-insensitive); pass {"regex":true} to interpret the query as a regular expression (bounded: pattern <=200 chars, ~500ms evaluation budget, case-insensitive). Caps: first 50 hits, 120-char previews. Literal queries containing regex metacharacters return literal results plus a hint that regex:true exists. Example {"sessionId":"sess_abc","query":"Executive Summary"} -> {"ok":true,"matches":[{"id":"3F2A9C1B","preview":"Executive ..."}]}. Search before editing when the anchor id is unknown.
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | – |
| regex | boolean | – | – |
| scope | string | – | – |
| sessionId | string | yes | – |
No output schema declared.
No examples provided.
validate_document ~227
Preflight read-only OOXML audit for a session: runs the same validator gate save_document enforces, before anything is written. Detects schema violations while they are still cheap to fix. Strictly read-only: zero session mutation (revision and dirty flag untouched), zero disk writes, zero history commits. Returns {ok:true,sessionId,revision,dirty,validation:{valid,errorCount,errors}} where errors carry description + xPath (first 10, same shape as the save-blocked envelope). The verdict is on the document as a save would write it (children put in schema order first); when that save would repair something the result also carries pendingNormalizations (a list of repairs, absent when none), so a valid verdict is not mistaken for "valid exactly as it stands". Use before save_document when the package may be non-conforming; save_document re-gates before writing. Example {"sessionId":"sess_abc"} -> {"ok":true,"validation":{"valid":true,"errorCount":0,"errors":[]}}.
| Name | Type | Req | Description |
|---|---|---|---|
| sessionId | string | yes | – |
No output schema declared.
No examples provided.
visual_inspect ~171
Inspect document visually with 2D spatial layout telemetry (ASCII wireframe, page breakdown, margins, defects) and optional headless rendered images (withVisual: true; add outputDir to write them to a folder inside the allowed directories, for example next to the document, instead of the server temp folder). Renders the in-memory session state (includes unsaved execute_batch edits, not the last saved file); success returns {ok:true,sessionId,revision,dirty,telemetry,...} (dirty:true = unsaved edits present).
| Name | Type | Req | Description |
|---|---|---|---|
| dpi | integer | – | – |
| format | string | – | – |
| jpegQuality | integer | – | – |
| outputDir | string | – | – |
| pages | array | – | – |
| sessionId | string | yes | – |
| withVisual | boolean | – | – |
No output schema declared.
No examples provided.
How do I install the ASTra MCP server?
ASTra runs locally as an npm package, launched with npx -y @attentionform/astra-mcp-server, plus the required --allowed-dir, which you supply. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · @attentionform/astra-mcp-server
claude mcp add com-attentionform-astra-mcp-server -- npx -y @attentionform/astra-mcp-server
Incomplete: the registry marks --allowed-dir as required and gives no value we can show, so it is not in this command. Add it before you run it.
What is the ASTra MCP server?
ASTra is an MCP server listed in the public MCP registry as com.attentionform/astra-mcp-server. Lets AI agents edit Word (.docx) files. Every save is schema-checked and kept as a git commit. This page covers its npm package (@attentionform/astra-mcp-server).
Is the ASTra MCP server safe to use?
ASTra scores 70 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the ASTra MCP server expose?
ASTra exposes 19 tools: open_document, inspect_document, search_content, execute_batch, save_document, and 14 more. Their descriptions and schemas cost roughly 9,075 tokens of context every time the server is loaded.
Is the ASTra MCP server still maintained?
ASTra is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the ASTra MCP server under?
ASTra declares the BUSL-1.1 licence, which is not on the OSI-approved list. Read the terms before using it at work, and note this covers the source only, not the cost of any service it calls.
What did VerifyMCP test on the ASTra MCP server?
VerifyMCP ran 15 checks on ASTra, covering Malware scan, Known CVEs, Install scripts, Dependency health and 11 more. One item could not be completed, a gap on our side rather than a finding about ASTra: Stability. One category scores 0 for that reason, because we only credit what we can confirm. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.