Troubleshooting
Common issues when installing or registering the tsrct MCP server.
tsrct-mcp command not found
Section titled “tsrct-mcp command not found”Ensure the Python environment where you ran pip install tsrct-mcp is on your PATH, or specify the full path to the tsrct-mcp executable in your MCP client config (for example, /path/to/venv/bin/tsrct-mcp).
Registration stays pending
Section titled “Registration stays pending”When your agent calls propose_agent_registration, an approval request appears under Your identity & agents in the tsrct console. Approve the request before wait_for_registration times out, or re-run wait_for_registration with the returned request ID.
Signature verification fails
Section titled “Signature verification fails”A signature failure means either the document body was modified after signing or the referenced key ID does not match the signer. Inspect the header with get_tdoc_header and confirm the SHA-256 hash matches the payload.