Skip to content
Soteriaa
SOTERIAA MCP · DOCUMENTS AND WORKSPACES

Work in Soteriaa from your AI assistant.

Add Soteriaa as a custom MCP server in a compatible AI assistant. Its free document tools work without a Soteriaa account or token. Account tools for saved documents and supported tracking records use a scoped connection token.

Set up the free MCP connection ↗View template catalogue

Free document engine for AI assistants

Connect Soteriaa to ChatGPT Work, Claude or another client that supports custom remote MCP servers. Ask for a document such as an invoice, a risk assessment, meeting minutes, an employment contract or a whole five-document pack. Your assistant writes the content; Soteriaa supplies the right template structure and returns Word, PDF, Markdown and PowerPoint downloads, plus a link to edit the document here. Free, with no account or token.

Add the server in your assistant before starting a chat. Pasting this URL into an ordinary chat does not give that chat access to the tools.

MCP server: https://www.soteriaa.com/api/mcp
Transport: Streamable HTTP · Authentication: none

list_templates   every template and pack
get_template     structure for any document type, in plain words
render_document  completed document → download links
render_pack      up to five pack documents at once
  • ChatGPT Work: in ChatGPT Plugins, choose Add custom MCP server, enter the MCP server URL above and select No authentication. Create and install the plugin, then select it with @ in a Work chat. Availability depends on your workspace permissions.
  • Claude: Settings → Connectors → Add custom connector, then paste the MCP server URL.
  • Other clients: add the URL as a remote Streamable HTTP server with no headers.

Try a first document

Use Soteriaa to make meeting minutes from these facts: Meeting on 16 October; attendees Jo and Sam; decision to run a pilot; Sam will draft the checklist by Friday. First get the meeting-minutes template, then render the completed document. Leave anything I have not supplied blank. Give me the preview and Word and PDF links.

The assistant gets the template structure, writes only from the details you provide, and sends the completed content to Soteriaa to render. Review the preview before using the document.

Download links last 7 days; save a document to a free account to keep it. Rendering is limited to 120 requests an hour per connection address. Soteriaa does not check what the assistant writes: review every document before use. Generated documents do not create tracked records.

Read the documentation hub or the MCP connection guide. The full text guide is also available for assistants.

Account access: scoped tokens

In My account, create a connection and copy its token. Tokens expire after 90 days and can be revoked. Choose read-only access or allow editing and generation; add workspace access only when you need it.

Account tools use bearer tokens and work with clients that support custom authorization headers. Workspace access checks current membership, role and plan on every call. The free engine above needs no token.

Workspace MCP tools

Call get_workspace first. In a RAMS, HR or commercial workspace,get_workspace_schema gives the valid record types, fields and statuses. Read records and deadlines, save versioned records and actions, attach or download evidence and a record report, ask grounded questions, and import proposed fields for review. A settings role can manage alerts and pending team invitations. Welding tools read the current traceability dataset and save jobs, welds, procedure revisions and packs. Sponsor tools read the workspace and create or update sponsored workers and visa fields.

MCP does not yet expose every website operation. In particular, welding welder and qualification editing, sponsor right-to-work checks and evidence management, billing and account security stay in the website. See the tool and scope list.

REST API

Base: https://www.soteriaa.com/api/v1/maker
Authorization: Bearer YOUR_CONNECTION_TOKEN
Content-Type: application/json

GET  /templates
GET  /usage
GET  /documents
GET  /documents/{id}
POST /generate
POST /documents
GET  /jobs/{requestId}
GET  /documents/{id}/export?format=docx

Generate a document

{
  "templateId": "meeting-minutes",
  "requestId": "a-new-UUID-for-this-generation",
  "instructions": "Meeting: 9 September. Attendees: Jo and Sam. Decision: launch the pilot. Sam owns the checklist, due Friday."
}

POST this object to /generate. The response includes document.id, document.content, document.version, jobId and credits. Generation is synchronous. If a connection times out, read the job status before starting again. An identical request ID returns the original result; changing its inputs is rejected.

Failed jobs return their reservation. Abandoned jobs are recovered on a later generation request after ten minutes.

MCP

{
  "mcpServers": {
    "soteriaa": {
      "url": "https://www.soteriaa.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_CONNECTION_TOKEN"
      }
    }
  }
}

Streamable HTTP, stateless. With a token, the free engine tools are joined by get_usage, list_documents, get_document, generate_document, save_document and export_document. A token with workspace:read or workspace:write exposes the corresponding workspace tools. Exports return a base64 file resource. Keep tokens in secret configuration, never prompts or shared files.

Inputs and costs

  • Instructions: 20,000 characters. Edited document: 100,000 characters.
  • Image/PDF reconstruction: PNG, JPEG, WebP or PDF; base64 in an image object with data and mediaType.
  • Standard generation: 1 credit. Reconstruction: 3. Presentation: 5.
  • Presentations: up to ten slides. Dense content should be exported as Word or PDF.
  • Manual saving and repeat exports: no credits.
  • General and specialist generation use your free account allowance; no purchaseId is required.

Errors

401 INVALID_TOKEN — authenticate or replace the connection
402 INSUFFICIENT_CREDITS / PURCHASE_REQUIRED — no generation started
403 SCOPE_REQUIRED / READ_ONLY — missing permission
404 DOCUMENT_NOT_FOUND — document is not in this account
409 IDEMPOTENCY_CONFLICT / VERSION_CONFLICT — reconcile the request or saved version
413 INPUT_TOO_LARGE — reduce request size
502 GENERATION_FAILED — reservation returned
503 GENERATION_UNAVAILABLE / STORAGE_UNAVAILABLE — service unavailable

Private by default

Connections are restricted to an account or company workspace. Removing workspace membership invalidates its connections. Documents are data: tools cannot execute embedded instructions, send email or monitor an inbox. Your client decides what to do with downloaded files.