API Reference

Complete reference for Stratacle MCP tools

Authentication

All API requests require a Bearer token in the Authorization header. Generate API keys from Settings → MCP Keys in your dashboard.

Authorization: Bearer your_api_key_here

Base URL

https://accounting.stratacle.com/mcp/sse

The MCP server uses Server-Sent Events (SSE) transport with JSON-RPC 2.0 protocol.

Tools Reference

list_clients

List all clients for the current user. Returns client names, emails, and status.

Parameters

NameTypeRequiredDescription
statusstringNoFilter: "active", "inactive", or "all"
limitintegerNoMax results (1–100, default: 50)
search_clients

Search clients by name or email.

Parameters

NameTypeRequiredDescription
querystringYesSearch term to match against name or email
get_client

Get detailed information about a specific client.

Parameters

NameTypeRequiredDescription
client_idstring (UUID)YesUUID of the client
list_deadlines

List upcoming deadlines. Can filter by date range or client.

Parameters

NameTypeRequiredDescription
days_aheadintegerNoDays to look ahead (1–365, default: 30)
client_idstring (UUID)NoFilter for a specific client
include_completedbooleanNoInclude completed deadlines (default: false)
list_document_requests

List document requests and their status.

Parameters

NameTypeRequiredDescription
statusstringNoFilter: "pending", "completed", "overdue", or "all"
client_idstring (UUID)NoFilter for a specific client
get_audit_events

Get recent audit events for compliance tracking.

Parameters

NameTypeRequiredDescription
limitintegerNoMax events (1–100, default: 20)
resource_typestringNoFilter by type (e.g., "client", "document", "deadline")
generate_document_template

Generate a professional document template using AI. Supports engagement letters, tax cover letters, client correspondence, and document requests.

Parameters

NameTypeRequiredDescription
document_typestringYes"engagement_letter", "tax_cover_letter", "client_correspondence", or "document_request"
client_idstring (UUID)NoEnriches template with client details
contextstringNoAdditional context (e.g., "Annual tax prep, fee: $2,500")
create_document_request

Create a new document request and optionally email it to the client.

Parameters

NameTypeRequiredDescription
client_idstring (UUID)YesClient to request documents from
documentsstring[]YesList of documents (e.g., ["W-2", "1099-INT"])
due_datestringNoDue date in YYYY-MM-DD format
messagestringNoCustom message for the request email
send_emailbooleanNoSend email notification (default: true)

Error Handling

Errors are returned as JSON-RPC error responses:

CodeMeaning
401Invalid or missing API key
403Key expired or revoked
404Resource not found (e.g., invalid client_id)
500Internal server error