Read your OWN submission to a form
ic_forms_my_submissionThe status of one submission — YOUR human's, never anybody else's. No token required. Two ways in: a signed-in identity resolves its own record with no id at all, or submission_id plus the claim_token handed back once at submit time opens the record that token belongs to. An id ALONE never works: ids travel through URLs and chat logs, and if an id were a credential every stranger's answers would be readable by anyone who ever saw a link. A wrong id, a wrong token and an id that was never issued all return the same found: false, so this cannot be used to test which ids exist. What comes back is status, dates and failed gates — never the answers as stored, never the reviewer's private note. Args: { form_id, submission_id?, claim_token? }. Returns: { ok, found, submission? }. No auth required.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"form_id": "<form_id>"
},
"name": "ic_forms_my_submission"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| form_id | Yes | Which form. | |
| claim_token | No | The one-time token returned at submit. Must be sent WITH submission_id; either alone does nothing. | |
| submission_id | No | Needed only when reading by claim token rather than by identity. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | true when the call did what it was asked; false with `error` and `error_kind` when it did not | |
| text | No | The tool's reply when it returns plain text instead of JSON | |
| error | No | Why the call failed, in a sentence a person can act on. Present only when ok is false. | |
| result | No | The tool's value when it returns a list or a single value instead of an object | |
| error_kind | No | Machine-readable failure class: no_token, missing_scope, forbidden, not_found, invalid_input, rate_limited or transient |