API¶

Safety Annotations¶

All tools include MCP safety annotations to indicate their behavior:

Tool	`readOnlyHint`	`destructiveHint`	Description
`get_specs`	`true`	`false`	Only reads schema data
`create_document`	`false`	`true`	Creates new documents

Tools¶

`get_specs`¶

Returns the Quillmark schema for USAF official memorandums.

Annotation	Value
`readOnlyHint`	`true`
`destructiveHint`	`false`
`title`	Get Quillmark Specs

{
  "name": "get_specs",
  "arguments": {}
}

Returns: JSON schema defining valid Quillmark frontmatter fields, document types, and formatting rules.

`create_document`¶

Creates a new document and returns a magic link to open it.

Annotation	Value
`readOnlyHint`	`false`
`destructiveHint`	`true`
`title`	Create Document

Arguments:

Name	Type	Required	Description
`name`	string	Yes	Document title
`owner`	string	Yes	Creator attribution (e.g., "Claude")
`content`	string	Yes	Quillmark-formatted document content

{
  "name": "create_document",
  "arguments": {
    "name": "Holiday Party Memo",
    "owner": "Claude",
    "content": "---\ntype: usaf_memo\nreceiver:\n  org: 123 FW/CC\n---\n\n# MEMORANDUM FOR RECORD\n\nSUBJECT: Holiday Party\n\n1. The party is at 0800.\n"
  }
}

Returns: A secure magic link URL. Upon first access, the document is securely associated with your device. To share the document publicly, you must create a fork.

Prompts¶

`writing_workflow`¶

Returns guidance on how to use the tools effectively.

{
  "method": "prompts/get",
  "params": {
    "name": "writing_workflow"
  }
}

Returns: Step-by-step instructions for creating USAF official memorandums, including when to call get_specs and how to structure create_document requests.