create_user_request
Create a new verification request to ask another user to share verified assets. Each asset is an object naming its type, e.g. { "type": "email" }.
ACCESS: needs a Proof account. Authenticate this client (Claude Code: /mcp → Authenticate), or sign in with start_login — a session opens this tool — then call this tool again.
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": {
"assets": "<assets>"
},
"name": "create_user_request"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| assets | Yes | Assets to request, e.g. [{ "type": "email" }, { "type": "phone", "required": false }] | |
| partial_ok | No | Whether partial asset sharing is acceptable (default: false) | |
| action_type | No | Purpose of the request (default: verification); custom and confirmation also need an action_context title | |
| callback_url | No | HTTPS webhook URL for request status updates | |
| redirect_url | No | HTTPS URL to redirect the subject after completing the request | |
| reference_id | No | External reference ID for tracking | |
| action_context | No | What the recipient is shown about why the assets are needed, e.g. { "title": "Confirm your contact details" } | |
| expires_in_hours | No | Hours until request expires (default: 168, i.e. 7 days) | |
| public_profile_id | No | Public profile ID for branding | |
| validity_requirement | No | How recently an existing proof must have been verified for the recipient to reuse it: a number and a unit, h hours, d days, w weeks or m months (30 days), e.g. "24h", "7d", "1m" |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | MongoDB ObjectId | |
| assets | No | ||
| status | No | Status of a verification request | |
| outcome | No | `relying_party` when the request was created to wait for your outcome; null otherwise. Absent from an API that predates the field. | |
| progress | No | ||
| created_at | No | ||
| expires_at | No | ||
| partial_ok | No | ||
| updated_at | No | ||
| action_type | No | Type of action for verification request or authorization | |
| callback_url | No | The webhook URL set on the request, if any | |
| completed_at | No | ||
| redirect_url | No | ||
| reference_id | No | ||
| action_context | No | The action the person is asked to authorize; null when the request carries none | |
| computed_state | No | Additive machine-readable effective state: re-derives expiry from expires_at (never trusts the stored status). BOTH `is_expiring_soon` and `next_action` are role-aware — `next_action.role` says which side this envelope was computed for, and the two fields are consistent within it. Present only on authenticated owner/requester and recipient responses; absent on public/third-party surfaces. | |
| verification_url | No | URL for the verification flow | |
| validity_requirement | No | Required proof freshness as set on the request (e.g. "7d"); null when none was set | |
| outcome_timeout_seconds | No | The window set on the request, in seconds; null when it does not wait for an outcome. Absent from an API that predates the field. |