One server, twelve tools
MCP
The MCP server is a thin shell over the same endpoints. Every tool below maps one-to-one onto a live endpoint in this reference — nothing is listed here that does not answer.
Install
Shell
npx -y @sidaxis/mcp-server --versionmcp.json
{ "mcpServers": { "sidaxis": { "command": "npx", "args": ["-y", "@sidaxis/mcp-server"], "env": { "SIDAXIS_API_KEY": "sk_test_…", "SIDAXIS_VERSION": "2026-09-14", "ALLOWED_TOOLS": "mandate_check,mandate_get" } } } }The same file shape works in any MCP client that reads a server list. ALLOWED_TOOLS is an allowlist: omit it and the key's own scope decides. Start with the read and check tools, and add write tools deliberately.
Catalogue
Tool Does Endpoint Receipt tools ship with the Receipts reference, not before it. A tool is documented here only once there is an implementation that responds to it. The model is not the authority An agent calling mandate_check cannot widen its own mandate: mandate_create requires proof of a live human at the moment of the grant, which no tool call can produce on its own. See also Stable names → Authentication →
Tool catalogue
| Tool | Endpoint | What it does |
|---|---|---|
| identity_claim | identity-claims | Claim a coordinate for a person. Billed once per person, for life. |
| identity_recognise | identity-recognitions | Recognise a person already claimed. Free, at any volume. |
| identity_attribute_request | identity-attributes | Ask for one attribute and receive the answer, never the document. |
| mandate_create | mandates-create | Issue a mandate from a live human's grant. |
| mandate_list | mandates-list | List mandates by granter, agent or status. |
| mandate_get | mandates-get | Retrieve one mandate and its remaining ceiling. |
| mandate_check | mandates-check | Ask whether an action fits the mandate. Returns allowed with a reason. |
| mandate_revoke | mandates-revoke | Revoke a mandate. Effective on the next request, never billed. |
| receipt_get | receipts-get | Retrieve a full receipt, for a party to the transaction. |
| receipt_verify | receipts-verify | Check a receipt against the public record. No key required. |
| session_create | sessions-create | Open a hosted session and get a URL to redirect the person to. |
| session_get | sessions-get | Read the outcome of a hosted session. |