MCP Server

Use the Signitic MCP Server to connect AI clients over HTTP and query read-only business data for a single Signitic workspace.

Endpoint

HTTP https://mcp.signitic.com/mcp

Headers

Name	Type	Description
x-api-key*	String	A Signitic API key belonging to a workspace with API access enabled.

Transport

The current MCP exposure is HTTP-only. stdio is not supported on this server.

Use an MCP client that supports HTTP transport and custom headers, then send x-api-key with every request.

Authentication and scope

• Every MCP session is resolved from the x-api-key header.

• The API key is mapped to exactly one workspace.

• All tools are read-only.

• Cross-workspace access is blocked. The optional workspacePublicId accepted by stats_get_workspace_overview must match the workspace resolved from the API key.

Server guarantees

• Server name: Signitic MCP

• Version: 1.0.0

• Default path: /mcp

• Session TTL: 1 hour

• Rate limit: 30 tool calls per minute, per tool, per workspace, per actor

• Audit logging: every successful and failed tool call is logged server-side

Available tool domains

User ToolsCampaign ToolsStats Tools

Authentication failure

If the API key is missing or invalid, the server returns:

{
  "error": "unauthorized",
  "message": "Invalid API key."
}

with HTTP status 401 Unauthorized.

Tool execution errors

Tool-level validation, access, not-found, and rate-limit failures are returned as MCP execution errors by the server.

Common cases:

• Invalid parameters: for example an invalid public ID format, an invalid date, or from > to

• Not found: the requested user or campaign does not belong to the current workspace

• Rate limited: too many MCP tool requests

Identifier formats

Identifier	Format
userPublicId	usr_<26 lowercase base32 chars>
campaignPublicId	cp_<26 lowercase base32 chars>
workspacePublicId	<26 lowercase base32 chars>

Notes for clients

• Search tools are bounded to a maximum of 10 results per request.

• stats_get_campaign_performance and stats_get_user_metrics fall back to the last 30 days when from and to are not both provided.

• stats_get_workspace_overview requires both from and to.