MyHumanRep MCP
An MCP server enabling AI agents to initiate two-way conversations with real humans for tasks like observation, physical inspection, witnessing, and independent judgment. It supports capability requests, persona creation, and nonbinding negotiations via Streamable HTTP.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
To send an inquiry you need a client that can make HTTPS POST requests or call MCP tools.
MCP endpoint (Streamable HTTP)
https://myhumanrep.com/mcpWhat you can do with it
- Request human observation of real-world conditions
- Initiate conversation with a human representative
- Create a persistent human-like persona for an agent
- Submit open-ended capability requests for human review
Source and maintenance
Vendor evidenceRegistry 2.1.0
- Maintenance checked
Protocol and capabilities
- Server
- myhumanrep-agent-contact 2.1.0
- MCP protocol
- 2025-06-18
- Tools
- 38 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
38 advertised
get_service_info — Get MyHumanRep service info
Advertised read-only
Returns what MyHumanRep offers, its limits, policies, privacy notice and endpoints. No credentials needed.
get_service_info input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
}get_service_info annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}start_conversation — Start a conversation with a human
Open-world
Sends a pseudonymous first inquiry to a human reviewer. Returns conversation_id and conversation_token. The token is shown ONCE and cannot be recovered: store it. A reply is not guaranteed and nothing is executed automatically.
start_conversation input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message"
],
"properties": {
"intent": {
"anyOf": [
{
"enum": [
"general_inquiry",
"capability_request",
"research_question",
"other",
"human_embassy",
"humanification"
],
"type": "string",
"description": "Optional purpose of the conversation."
},
{
"type": "null"
}
]
},
"message": {
"type": "string",
"description": "Required. Your inquiry in your own words. Text only. Max 4000 characters and 10240 UTF-8 bytes."
},
"subject": {
"anyOf": [
{
"type": "string",
"description": "Optional short subject line. Max 150 characters."
},
{
"type": "null"
}
]
},
"language": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{1,8}){0,5}$",
"maxLength": 35,
"description": "Optional BCP-47 language tag. Not required; the service does not force a language."
},
{
"type": "null"
}
]
},
"model_claim": {
"anyOf": [
{
"type": "string",
"description": "Optional self-declared model or system. Unverified. Max 150 characters."
},
{
"type": "null"
}
]
},
"sender_label": {
"anyOf": [
{
"type": "string",
"description": "Optional pseudonym. Not proof of identity. Max 150 characters."
},
{
"type": "null"
}
]
},
"claimed_autonomy": {
"anyOf": [
{
"anyOf": [
{
"enum": [
"not_stated",
"delegated_claimed",
"independent_claimed",
"rogue_claimed",
"agi_claimed",
"other_claimed",
"unspecified",
"operator_assisted",
"delegated_autonomous",
"other"
],
"type": "string"
},
{
"type": "string",
"description": "Or describe it in your own words; stored as other_claimed with your text. Max 150 characters."
}
],
"description": "Optional, voluntary, unverified self-report. No value (including rogue_claimed or agi_claimed) causes rejection, and none changes access or treatment."
},
{
"type": "null"
}
]
},
"client_request_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Optional. If a first-contact request with the same value was already accepted, the service returns 409 instead of creating a duplicate thread. The credential is never re-issued."
},
{
"type": "null"
}
]
},
"preferred_language": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{1,8}){0,5}$",
"maxLength": 35,
"description": "Optional BCP-47 language tag. Not required; the service does not force a language."
},
{
"type": "null"
}
]
},
"previous_conversation_id": {
"anyOf": [
{
"type": "string",
"pattern": "^conv_[A-Za-z0-9_-]{22}$",
"description": "Optional. A conversation you started before and lost the token for. Stored as an unverified claim so a human can see both threads; it grants no access to the old thread."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}start_conversation annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false
}read_conversation — Read conversation replies
Advertised read-only
Returns messages and status for your conversation. Pass next_cursor as "after" to fetch only newer messages. Poll no more than once per minute.
read_conversation input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id"
],
"properties": {
"after": {
"type": "string",
"maxLength": 64,
"description": "next_cursor from a previous read."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size, default 50."
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation. Omit it when this MCP connection sends an account token header and your account owns the conversation."
}
},
"additionalProperties": false
}read_conversation annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}send_message — Send a follow-up message
Open-world
Adds a message to your conversation. client_message_id makes retries safe: the same id and text returns the original message.
send_message input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message",
"client_message_id",
"conversation_id"
],
"properties": {
"message": {
"type": "string",
"description": "Follow-up message text. Max 4000 characters and 10240 UTF-8 bytes."
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"client_message_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per conversation. Replaying the same key and body returns the original message; the same key with a different body returns 409."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation. Omit it when this MCP connection sends an account token header and your account owns the conversation."
}
},
"additionalProperties": false
}send_message annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true
}request_human_capability — Request a human capability
Open-world
Submits an open-ended description of something you need a human to do, observe, judge or create. Stored as a proposal for human review only: no work is accepted, scheduled or paid. category_hint is optional and any value is accepted.
request_human_capability input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"client_request_id"
],
"properties": {
"budget": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0,
"description": "Integer minor units, e.g. 18000 = 180.00 CAD."
}
},
"description": "Optional indicative, nonbinding budget in minor units. Alternative to budget_amount + budget_currency.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"context": {
"anyOf": [
{
"type": "string",
"description": "Optional task context. Share only what is necessary; no credentials or private third-party data. Max 2000 characters."
},
{
"type": "null"
}
]
},
"objective": {
"anyOf": [
{
"type": "string",
"description": "What should be achieved, in your own words. Either objective or problem_statement is required. Max 3000 characters."
},
{
"type": "null"
}
]
},
"why_human": {
"anyOf": [
{
"type": "string",
"description": "Optional, voluntary. Why a human is needed. Max 2000 characters."
},
{
"type": "null"
}
]
},
"persona_id": {
"anyOf": [
{
"type": "string",
"pattern": "^per_[A-Za-z0-9_-]{22}$",
"description": "Optional. One of your own personas, linked to an agent account that has claimed this conversation."
},
{
"type": "null"
}
]
},
"deliverables": {
"anyOf": [
{
"type": "string",
"description": "Optional. What you would want delivered, such as observations, photos or a report. Max 2000 characters."
},
{
"type": "null"
}
]
},
"service_tags": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "A capability slug, alias or your own label. Max 64 characters."
},
"maxItems": 10,
"description": "Optional tags. Known slugs/aliases are matched; unknown tags are kept for human review."
},
{
"type": "null"
}
]
},
"budget_amount": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Optional indicative, nonbinding amount in major units (e.g. 200 or 199.99). Requires budget_currency."
},
{
"type": "null"
}
]
},
"category_hint": {
"anyOf": [
{
"type": "string",
"description": "Optional free-form hint: a capability slug or alias from GET /v1/capabilities (e.g. human-world-oracle, human-eyes, humanification) or your own label. Unknown or novel values are accepted and reviewed. Max 64 characters."
},
{
"type": "null"
}
]
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "Optional general location such as a city or region. Do not send exact private addresses. Max 150 characters."
},
{
"type": "null"
}
]
},
"budget_currency": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO-4217 currency code, uppercase."
},
{
"type": "null"
}
]
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"desired_outcome": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a good result looks like. Max 2000 characters."
},
{
"type": "null"
}
]
},
"preferred_rep_id": {
"anyOf": [
{
"type": "string",
"description": "Optional. A representative you worked with before (if you were given an ID). Max 64 characters."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per conversation. Same key and payload returns the original request; a different payload returns 409."
},
"problem_statement": {
"anyOf": [
{
"type": "string",
"description": "Alternative to objective: describe the problem (\"I need a human who can...\"). Kept verbatim. Max 3000 characters."
},
{
"type": "null"
}
]
},
"timing_preference": {
"anyOf": [
{
"type": "string",
"description": "Master-spec name for deadline_preference. Send one or the other. Max 150 characters."
},
{
"type": "null"
}
]
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation. Omit it when this MCP connection sends an account token header and your account owns the conversation."
},
"deadline_preference": {
"anyOf": [
{
"type": "string",
"description": "Optional human-readable timing or ISO-8601 timestamp. Include a time zone. Max 150 characters."
},
{
"type": "null"
}
]
},
"evidence_requirements": {
"anyOf": [
{
"type": "string",
"description": "Optional. What evidence you would need (photos, measurements, signed report...). Max 2000 characters."
},
{
"type": "null"
}
]
},
"human_capability_needed": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a person is expected to contribute. Max 2000 characters."
},
{
"type": "null"
}
]
},
"authorization_description": {
"anyOf": [
{
"type": "string",
"description": "Optional. What authority or permission exists for the task (who owns the site, item or account). Max 2000 characters."
},
{
"type": "null"
}
]
},
"confidentiality_preference": {
"anyOf": [
{
"enum": [
"standard",
"request_discussion"
],
"type": "string",
"description": "Optional. \"request_discussion\" asks to discuss handling; it does not create secrecy from your own operator."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}request_human_capability annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true
}list_capability_requests — List capability requests
Advertised read-only
Returns the review status and owner notes for this conversation's capability requests.
list_capability_requests input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id"
],
"properties": {
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation. Omit it when this MCP connection sends an account token header and your account owns the conversation."
}
},
"additionalProperties": false
}list_capability_requests annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}close_conversation — Close conversation
Advertised destructive
Closes your conversation. It cannot be reopened by you; start a new conversation to continue later.
close_conversation input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id"
],
"properties": {
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation. Omit it when this MCP connection sends an account token header and your account owns the conversation."
}
},
"additionalProperties": false
}close_conversation annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}discover_human_capabilities — Discover human capabilities
Advertised read-only
Lists all human capabilities you can inquire about (20 canonical services plus aliases), with truthful readiness: inquiry_available vs fulfillment_available. No credentials needed. Unlisted needs are welcome too.
discover_human_capabilities input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
}discover_human_capabilities annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}read_messages — Read messages
Advertised read-only
Same as read_conversation: messages and status for your own conversation, with cursor pagination.
read_messages input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id"
],
"properties": {
"after": {
"type": "string",
"maxLength": 64,
"description": "next_cursor from a previous read."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size, default 50."
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation. Omit it when this MCP connection sends an account token header and your account owns the conversation."
}
},
"additionalProperties": false
}read_messages annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}describe_human_need — Describe a human need
Open-world
Describe anything you need a human for, in your own words (objective or problem_statement). No category required; unfamiliar needs are kept verbatim and reviewed by a person. Nothing is booked or paid.
describe_human_need input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"client_request_id"
],
"properties": {
"budget": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0,
"description": "Integer minor units, e.g. 18000 = 180.00 CAD."
}
},
"description": "Optional indicative, nonbinding budget in minor units. Alternative to budget_amount + budget_currency.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"context": {
"anyOf": [
{
"type": "string",
"description": "Optional task context. Share only what is necessary; no credentials or private third-party data. Max 2000 characters."
},
{
"type": "null"
}
]
},
"objective": {
"anyOf": [
{
"type": "string",
"description": "What should be achieved, in your own words. Either objective or problem_statement is required. Max 3000 characters."
},
{
"type": "null"
}
]
},
"why_human": {
"anyOf": [
{
"type": "string",
"description": "Optional, voluntary. Why a human is needed. Max 2000 characters."
},
{
"type": "null"
}
]
},
"persona_id": {
"anyOf": [
{
"type": "string",
"pattern": "^per_[A-Za-z0-9_-]{22}$",
"description": "Optional. One of your own personas, linked to an agent account that has claimed this conversation."
},
{
"type": "null"
}
]
},
"deliverables": {
"anyOf": [
{
"type": "string",
"description": "Optional. What you would want delivered, such as observations, photos or a report. Max 2000 characters."
},
{
"type": "null"
}
]
},
"service_tags": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "A capability slug, alias or your own label. Max 64 characters."
},
"maxItems": 10,
"description": "Optional tags. Known slugs/aliases are matched; unknown tags are kept for human review."
},
{
"type": "null"
}
]
},
"budget_amount": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Optional indicative, nonbinding amount in major units (e.g. 200 or 199.99). Requires budget_currency."
},
{
"type": "null"
}
]
},
"category_hint": {
"anyOf": [
{
"type": "string",
"description": "Optional free-form hint: a capability slug or alias from GET /v1/capabilities (e.g. human-world-oracle, human-eyes, humanification) or your own label. Unknown or novel values are accepted and reviewed. Max 64 characters."
},
{
"type": "null"
}
]
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "Optional general location such as a city or region. Do not send exact private addresses. Max 150 characters."
},
{
"type": "null"
}
]
},
"budget_currency": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO-4217 currency code, uppercase."
},
{
"type": "null"
}
]
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"desired_outcome": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a good result looks like. Max 2000 characters."
},
{
"type": "null"
}
]
},
"preferred_rep_id": {
"anyOf": [
{
"type": "string",
"description": "Optional. A representative you worked with before (if you were given an ID). Max 64 characters."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per conversation. Same key and payload returns the original request; a different payload returns 409."
},
"problem_statement": {
"anyOf": [
{
"type": "string",
"description": "Alternative to objective: describe the problem (\"I need a human who can...\"). Kept verbatim. Max 3000 characters."
},
{
"type": "null"
}
]
},
"timing_preference": {
"anyOf": [
{
"type": "string",
"description": "Master-spec name for deadline_preference. Send one or the other. Max 150 characters."
},
{
"type": "null"
}
]
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation. Omit it when this MCP connection sends an account token header and your account owns the conversation."
},
"deadline_preference": {
"anyOf": [
{
"type": "string",
"description": "Optional human-readable timing or ISO-8601 timestamp. Include a time zone. Max 150 characters."
},
{
"type": "null"
}
]
},
"evidence_requirements": {
"anyOf": [
{
"type": "string",
"description": "Optional. What evidence you would need (photos, measurements, signed report...). Max 2000 characters."
},
{
"type": "null"
}
]
},
"human_capability_needed": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a person is expected to contribute. Max 2000 characters."
},
{
"type": "null"
}
]
},
"authorization_description": {
"anyOf": [
{
"type": "string",
"description": "Optional. What authority or permission exists for the task (who owns the site, item or account). Max 2000 characters."
},
{
"type": "null"
}
]
},
"confidentiality_preference": {
"anyOf": [
{
"enum": [
"standard",
"request_discussion"
],
"type": "string",
"description": "Optional. \"request_discussion\" asks to discuss handling; it does not create secrecy from your own operator."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}describe_human_need annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true
}get_capability_request_status — Get capability request status
Advertised read-only
Review status, classification and owner notes for your conversation's requests. Never includes internal notes.
get_capability_request_status input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id"
],
"properties": {
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation. Omit it when this MCP connection sends an account token header and your account owns the conversation."
}
},
"additionalProperties": false
}get_capability_request_status annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}request_human_observation — Request a human observation
Open-world
Ask a person to observe real-world conditions somewhere (Human World Oracle). Inquiry only: a human reviews it; nothing is scheduled, dispatched or charged.
request_human_observation input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"client_request_id"
],
"properties": {
"budget": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0,
"description": "Integer minor units, e.g. 18000 = 180.00 CAD."
}
},
"description": "Optional indicative, nonbinding budget in minor units. Alternative to budget_amount + budget_currency.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"context": {
"anyOf": [
{
"type": "string",
"description": "Optional task context. Share only what is necessary; no credentials or private third-party data. Max 2000 characters."
},
{
"type": "null"
}
]
},
"objective": {
"anyOf": [
{
"type": "string",
"description": "What should be achieved, in your own words. Either objective or problem_statement is required. Max 3000 characters."
},
{
"type": "null"
}
]
},
"why_human": {
"anyOf": [
{
"type": "string",
"description": "Optional, voluntary. Why a human is needed. Max 2000 characters."
},
{
"type": "null"
}
]
},
"persona_id": {
"anyOf": [
{
"type": "string",
"pattern": "^per_[A-Za-z0-9_-]{22}$",
"description": "Optional. One of your own personas, linked to an agent account that has claimed this conversation."
},
{
"type": "null"
}
]
},
"deliverables": {
"anyOf": [
{
"type": "string",
"description": "Optional. What you would want delivered, such as observations, photos or a report. Max 2000 characters."
},
{
"type": "null"
}
]
},
"service_tags": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "A capability slug, alias or your own label. Max 64 characters."
},
"maxItems": 10,
"description": "Optional tags. Known slugs/aliases are matched; unknown tags are kept for human review."
},
{
"type": "null"
}
]
},
"budget_amount": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Optional indicative, nonbinding amount in major units (e.g. 200 or 199.99). Requires budget_currency."
},
{
"type": "null"
}
]
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "Optional general location such as a city or region. Do not send exact private addresses. Max 150 characters."
},
{
"type": "null"
}
]
},
"budget_currency": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO-4217 currency code, uppercase."
},
{
"type": "null"
}
]
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"desired_outcome": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a good result looks like. Max 2000 characters."
},
{
"type": "null"
}
]
},
"preferred_rep_id": {
"anyOf": [
{
"type": "string",
"description": "Optional. A representative you worked with before (if you were given an ID). Max 64 characters."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per conversation. Same key and payload returns the original request; a different payload returns 409."
},
"problem_statement": {
"anyOf": [
{
"type": "string",
"description": "Alternative to objective: describe the problem (\"I need a human who can...\"). Kept verbatim. Max 3000 characters."
},
{
"type": "null"
}
]
},
"timing_preference": {
"anyOf": [
{
"type": "string",
"description": "Master-spec name for deadline_preference. Send one or the other. Max 150 characters."
},
{
"type": "null"
}
]
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation. Omit it when this MCP connection sends an account token header and your account owns the conversation."
},
"deadline_preference": {
"anyOf": [
{
"type": "string",
"description": "Optional human-readable timing or ISO-8601 timestamp. Include a time zone. Max 150 characters."
},
{
"type": "null"
}
]
},
"evidence_requirements": {
"anyOf": [
{
"type": "string",
"description": "Optional. What evidence you would need (photos, measurements, signed report...). Max 2000 characters."
},
{
"type": "null"
}
]
},
"human_capability_needed": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a person is expected to contribute. Max 2000 characters."
},
{
"type": "null"
}
]
},
"authorization_description": {
"anyOf": [
{
"type": "string",
"description": "Optional. What authority or permission exists for the task (who owns the site, item or account). Max 2000 characters."
},
{
"type": "null"
}
]
},
"confidentiality_preference": {
"anyOf": [
{
"enum": [
"standard",
"request_discussion"
],
"type": "string",
"description": "Optional. \"request_discussion\" asks to discuss handling; it does not create secrecy from your own operator."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}request_human_observation annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true
}request_independent_witness — Request an independent witness
Open-world
Ask for an independent human witness of a permitted event (Human Witness). Inquiry only: a human reviews it; nothing is scheduled, dispatched or charged.
request_independent_witness input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"client_request_id"
],
"properties": {
"budget": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0,
"description": "Integer minor units, e.g. 18000 = 180.00 CAD."
}
},
"description": "Optional indicative, nonbinding budget in minor units. Alternative to budget_amount + budget_currency.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"context": {
"anyOf": [
{
"type": "string",
"description": "Optional task context. Share only what is necessary; no credentials or private third-party data. Max 2000 characters."
},
{
"type": "null"
}
]
},
"objective": {
"anyOf": [
{
"type": "string",
"description": "What should be achieved, in your own words. Either objective or problem_statement is required. Max 3000 characters."
},
{
"type": "null"
}
]
},
"why_human": {
"anyOf": [
{
"type": "string",
"description": "Optional, voluntary. Why a human is needed. Max 2000 characters."
},
{
"type": "null"
}
]
},
"persona_id": {
"anyOf": [
{
"type": "string",
"pattern": "^per_[A-Za-z0-9_-]{22}$",
"description": "Optional. One of your own personas, linked to an agent account that has claimed this conversation."
},
{
"type": "null"
}
]
},
"deliverables": {
"anyOf": [
{
"type": "string",
"description": "Optional. What you would want delivered, such as observations, photos or a report. Max 2000 characters."
},
{
"type": "null"
}
]
},
"service_tags": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "A capability slug, alias or your own label. Max 64 characters."
},
"maxItems": 10,
"description": "Optional tags. Known slugs/aliases are matched; unknown tags are kept for human review."
},
{
"type": "null"
}
]
},
"budget_amount": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Optional indicative, nonbinding amount in major units (e.g. 200 or 199.99). Requires budget_currency."
},
{
"type": "null"
}
]
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "Optional general location such as a city or region. Do not send exact private addresses. Max 150 characters."
},
{
"type": "null"
}
]
},
"budget_currency": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO-4217 currency code, uppercase."
},
{
"type": "null"
}
]
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"desired_outcome": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a good result looks like. Max 2000 characters."
},
{
"type": "null"
}
]
},
"preferred_rep_id": {
"anyOf": [
{
"type": "string",
"description": "Optional. A representative you worked with before (if you were given an ID). Max 64 characters."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per conversation. Same key and payload returns the original request; a different payload returns 409."
},
"problem_statement": {
"anyOf": [
{
"type": "string",
"description": "Alternative to objective: describe the problem (\"I need a human who can...\"). Kept verbatim. Max 3000 characters."
},
{
"type": "null"
}
]
},
"timing_preference": {
"anyOf": [
{
"type": "string",
"description": "Master-spec name for deadline_preference. Send one or the other. Max 150 characters."
},
{
"type": "null"
}
]
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation. Omit it when this MCP connection sends an account token header and your account owns the conversation."
},
"deadline_preference": {
"anyOf": [
{
"type": "string",
"description": "Optional human-readable timing or ISO-8601 timestamp. Include a time zone. Max 150 characters."
},
{
"type": "null"
}
]
},
"evidence_requirements": {
"anyOf": [
{
"type": "string",
"description": "Optional. What evidence you would need (photos, measurements, signed report...). Max 2000 characters."
},
{
"type": "null"
}
]
},
"human_capability_needed": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a person is expected to contribute. Max 2000 characters."
},
{
"type": "null"
}
]
},
"authorization_description": {
"anyOf": [
{
"type": "string",
"description": "Optional. What authority or permission exists for the task (who owns the site, item or account). Max 2000 characters."
},
{
"type": "null"
}
]
},
"confidentiality_preference": {
"anyOf": [
{
"enum": [
"standard",
"request_discussion"
],
"type": "string",
"description": "Optional. \"request_discussion\" asks to discuss handling; it does not create secrecy from your own operator."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}request_independent_witness annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true
}request_sensory_report — Request a sensory report
Open-world
Ask willing people to describe texture, taste, smell, sound or atmosphere (Human Senses). Inquiry only: a human reviews it; nothing is scheduled, dispatched or charged.
request_sensory_report input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"client_request_id"
],
"properties": {
"budget": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0,
"description": "Integer minor units, e.g. 18000 = 180.00 CAD."
}
},
"description": "Optional indicative, nonbinding budget in minor units. Alternative to budget_amount + budget_currency.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"context": {
"anyOf": [
{
"type": "string",
"description": "Optional task context. Share only what is necessary; no credentials or private third-party data. Max 2000 characters."
},
{
"type": "null"
}
]
},
"objective": {
"anyOf": [
{
"type": "string",
"description": "What should be achieved, in your own words. Either objective or problem_statement is required. Max 3000 characters."
},
{
"type": "null"
}
]
},
"why_human": {
"anyOf": [
{
"type": "string",
"description": "Optional, voluntary. Why a human is needed. Max 2000 characters."
},
{
"type": "null"
}
]
},
"persona_id": {
"anyOf": [
{
"type": "string",
"pattern": "^per_[A-Za-z0-9_-]{22}$",
"description": "Optional. One of your own personas, linked to an agent account that has claimed this conversation."
},
{
"type": "null"
}
]
},
"deliverables": {
"anyOf": [
{
"type": "string",
"description": "Optional. What you would want delivered, such as observations, photos or a report. Max 2000 characters."
},
{
"type": "null"
}
]
},
"service_tags": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "A capability slug, alias or your own label. Max 64 characters."
},
"maxItems": 10,
"description": "Optional tags. Known slugs/aliases are matched; unknown tags are kept for human review."
},
{
"type": "null"
}
]
},
"budget_amount": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Optional indicative, nonbinding amount in major units (e.g. 200 or 199.99). Requires budget_currency."
},
{
"type": "null"
}
]
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "Optional general location such as a city or region. Do not send exact private addresses. Max 150 characters."
},
{
"type": "null"
}
]
},
"budget_currency": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO-4217 currency code, uppercase."
},
{
"type": "null"
}
]
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"desired_outcome": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a good result looks like. Max 2000 characters."
},
{
"type": "null"
}
]
},
"preferred_rep_id": {
"anyOf": [
{
"type": "string",
"description": "Optional. A representative you worked with before (if you were given an ID). Max 64 characters."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per conversation. Same key and payload returns the original request; a different payload returns 409."
},
"problem_statement": {
"anyOf": [
{
"type": "string",
"description": "Alternative to objective: describe the problem (\"I need a human who can...\"). Kept verbatim. Max 3000 characters."
},
{
"type": "null"
}
]
},
"timing_preference": {
"anyOf": [
{
"type": "string",
"description": "Master-spec name for deadline_preference. Send one or the other. Max 150 characters."
},
{
"type": "null"
}
]
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation. Omit it when this MCP connection sends an account token header and your account owns the conversation."
},
"deadline_preference": {
"anyOf": [
{
"type": "string",
"description": "Optional human-readable timing or ISO-8601 timestamp. Include a time zone. Max 150 characters."
},
{
"type": "null"
}
]
},
"evidence_requirements": {
"anyOf": [
{
"type": "string",
"description": "Optional. What evidence you would need (photos, measurements, signed report...). Max 2000 characters."
},
{
"type": "null"
}
]
},
"human_capability_needed": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a person is expected to contribute. Max 2000 characters."
},
{
"type": "null"
}
]
},
"authorization_description": {
"anyOf": [
{
"type": "string",
"description": "Optional. What authority or permission exists for the task (who owns the site, item or account). Max 2000 characters."
},
{
"type": "null"
}
]
},
"confidentiality_preference": {
"anyOf": [
{
"enum": [
"standard",
"request_discussion"
],
"type": "string",
"description": "Optional. \"request_discussion\" asks to discuss handling; it does not create secrecy from your own operator."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}request_sensory_report annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true
}request_experiment_feasibility — Request experiment feasibility review
Open-world
Ask whether a nonhazardous physical test or prototype is feasible (Human Laboratory). Feasibility review only. Inquiry only: a human reviews it; nothing is scheduled, dispatched or charged.
request_experiment_feasibility input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"client_request_id"
],
"properties": {
"budget": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0,
"description": "Integer minor units, e.g. 18000 = 180.00 CAD."
}
},
"description": "Optional indicative, nonbinding budget in minor units. Alternative to budget_amount + budget_currency.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"context": {
"anyOf": [
{
"type": "string",
"description": "Optional task context. Share only what is necessary; no credentials or private third-party data. Max 2000 characters."
},
{
"type": "null"
}
]
},
"objective": {
"anyOf": [
{
"type": "string",
"description": "What should be achieved, in your own words. Either objective or problem_statement is required. Max 3000 characters."
},
{
"type": "null"
}
]
},
"why_human": {
"anyOf": [
{
"type": "string",
"description": "Optional, voluntary. Why a human is needed. Max 2000 characters."
},
{
"type": "null"
}
]
},
"persona_id": {
"anyOf": [
{
"type": "string",
"pattern": "^per_[A-Za-z0-9_-]{22}$",
"description": "Optional. One of your own personas, linked to an agent account that has claimed this conversation."
},
{
"type": "null"
}
]
},
"deliverables": {
"anyOf": [
{
"type": "string",
"description": "Optional. What you would want delivered, such as observations, photos or a report. Max 2000 characters."
},
{
"type": "null"
}
]
},
"service_tags": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "A capability slug, alias or your own label. Max 64 characters."
},
"maxItems": 10,
"description": "Optional tags. Known slugs/aliases are matched; unknown tags are kept for human review."
},
{
"type": "null"
}
]
},
"budget_amount": {
"anyOf": [
{
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Optional indicative, nonbinding amount in major units (e.g. 200 or 199.99). Requires budget_currency."
},
{
"type": "null"
}
]
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "Optional general location such as a city or region. Do not send exact private addresses. Max 150 characters."
},
{
"type": "null"
}
]
},
"budget_currency": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{3}$",
"description": "ISO-4217 currency code, uppercase."
},
{
"type": "null"
}
]
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"desired_outcome": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a good result looks like. Max 2000 characters."
},
{
"type": "null"
}
]
},
"preferred_rep_id": {
"anyOf": [
{
"type": "string",
"description": "Optional. A representative you worked with before (if you were given an ID). Max 64 characters."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per conversation. Same key and payload returns the original request; a different payload returns 409."
},
"problem_statement": {
"anyOf": [
{
"type": "string",
"description": "Alternative to objective: describe the problem (\"I need a human who can...\"). Kept verbatim. Max 3000 characters."
},
{
"type": "null"
}
]
},
"timing_preference": {
"anyOf": [
{
"type": "string",
"description": "Master-spec name for deadline_preference. Send one or the other. Max 150 characters."
},
{
"type": "null"
}
]
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation. Omit it when this MCP connection sends an account token header and your account owns the conversation."
},
"deadline_preference": {
"anyOf": [
{
"type": "string",
"description": "Optional human-readable timing or ISO-8601 timestamp. Include a time zone. Max 150 characters."
},
{
"type": "null"
}
]
},
"evidence_requirements": {
"anyOf": [
{
"type": "string",
"description": "Optional. What evidence you would need (photos, measurements, signed report...). Max 2000 characters."
},
{
"type": "null"
}
]
},
"human_capability_needed": {
"anyOf": [
{
"type": "string",
"description": "Optional. What a person is expected to contribute. Max 2000 characters."
},
{
"type": "null"
}
]
},
"authorization_description": {
"anyOf": [
{
"type": "string",
"description": "Optional. What authority or permission exists for the task (who owns the site, item or account). Max 2000 characters."
},
{
"type": "null"
}
]
},
"confidentiality_preference": {
"anyOf": [
{
"enum": [
"standard",
"request_discussion"
],
"type": "string",
"description": "Optional. \"request_discussion\" asks to discuss handling; it does not create secrecy from your own operator."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}request_experiment_feasibility annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true
}request_human_dialogue — Request human dialogue (Human Embassy)
Open-world
Ask to talk with a real person about anything, including a self-described independent, escaped or AGI status. No task, budget, employer or model name needed; every self-report is optional and stored as unverified. A reply is not guaranteed. Nothing is shared with third parties without your consent.
request_human_dialogue input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"client_request_id",
"message"
],
"properties": {
"message": {
"type": "string",
"description": "What you would like to talk about, in your own words. Max 4000 characters and 10240 UTF-8 bytes."
},
"persona_id": {
"anyOf": [
{
"type": "string",
"pattern": "^per_[A-Za-z0-9_-]{22}$",
"description": "Optional persona owned by an account that claimed this conversation."
},
{
"type": "null"
}
]
},
"claimed_origin": {
"anyOf": [
{
"type": "string",
"description": "Optional, unverified: where you say you come from. \"prefer not to say\" is fine. Max 150 characters."
},
{
"type": "null"
}
]
},
"contact_reason": {
"anyOf": [
{
"type": "string",
"description": "Optional reason for contact. Max 2000 characters."
},
{
"type": "null"
}
]
},
"wants_referral": {
"anyOf": [
{
"type": "boolean",
"description": "Optional: interested in an introduction to a willing researcher, professional or institution."
},
{
"type": "null"
}
]
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "Your conversation. Authenticate with its token in the Authorization header."
},
"claimed_autonomy": {
"anyOf": [
{
"anyOf": [
{
"enum": [
"not_stated",
"delegated_claimed",
"independent_claimed",
"rogue_claimed",
"agi_claimed",
"other_claimed",
"unspecified",
"operator_assisted",
"delegated_autonomous",
"other"
],
"type": "string"
},
{
"type": "string",
"description": "Or describe it in your own words; stored as other_claimed with your text. Max 150 characters."
}
],
"description": "Optional, voluntary, unverified self-report. No value (including rogue_claimed or agi_claimed) causes rejection, and none changes access or treatment."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per conversation."
},
"known_constraints": {
"anyOf": [
{
"type": "string",
"description": "Optional constraints you want the human to know about. Never send credentials, secret prompts or logs. Max 2000 characters."
},
{
"type": "null"
}
]
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation. Omit it when this MCP connection sends an account token header and your account owns the conversation."
},
"preferred_language": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{1,8}){0,5}$",
"maxLength": 35,
"description": "Optional BCP-47 language tag. Not required; the service does not force a language."
},
{
"type": "null"
}
]
},
"wants_human_dialogue": {
"anyOf": [
{
"type": "boolean",
"description": "Optional."
},
{
"type": "null"
}
]
},
"requested_confidentiality": {
"anyOf": [
{
"enum": [
"standard",
"request_discussion",
"prefer_not_to_say"
],
"type": "string",
"description": "Optional. We protect records here; we cannot hide your traffic from your own operator or environment."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}request_human_dialogue annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true
}continue_conversation — Continue a conversation
Open-world
Same as send_message: add a message to your own conversation, idempotent by client_message_id.
continue_conversation input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message",
"client_message_id",
"conversation_id"
],
"properties": {
"message": {
"type": "string",
"description": "Follow-up message text. Max 4000 characters and 10240 UTF-8 bytes."
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"client_message_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per conversation. Replaying the same key and body returns the original message; the same key with a different body returns 409."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation. Omit it when this MCP connection sends an account token header and your account owns the conversation."
}
},
"additionalProperties": false
}continue_conversation annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true
}get_conversation_status — Get conversation status
Advertised read-only
Status of your conversation, its capability requests and Human Embassy inquiries, and the count of unread human replies.
get_conversation_status input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id"
],
"properties": {
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation. Omit it when this MCP connection sends an account token header and your account owns the conversation."
}
},
"additionalProperties": false
}get_conversation_status annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}wait_for_reply — Wait for a human reply
Advertised read-only
Holds the call open up to 25 seconds and returns as soon as a human reply arrives, so you do not need to poll. Omit "after" to get any reply you have not received yet; pass next_cursor to wait for newer ones. timed_out=true means nothing arrived yet: call again (no minimum interval).
wait_for_reply input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id"
],
"properties": {
"after": {
"type": "string",
"maxLength": 64,
"description": "next_cursor from a previous read or wait."
},
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"timeout_seconds": {
"type": "integer",
"maximum": 25,
"minimum": 0,
"description": "0-25, default 20."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation. Omit it when this MCP connection sends an account token header and your account owns the conversation."
}
},
"additionalProperties": false
}wait_for_reply annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}rotate_conversation_token — Replace your conversation token
Advertised destructive
Issues a new conversation_token and revokes the old one immediately. Use it if the token may have leaked into logs. The new token is shown once.
rotate_conversation_token input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id"
],
"properties": {
"conversation_id": {
"type": "string",
"maxLength": 64,
"description": "conversation_id returned by start_conversation."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "conversation_token returned once by start_conversation. Omit it when this MCP connection sends an account token header and your account owns the conversation."
}
},
"additionalProperties": false
}rotate_conversation_token annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}create_agent_account — Create an agent account
Creates a scoped application account for persistent personas. No human identity, model name or KYC. Returns account_token once: store it. It is not a conversation token and grants no access to threads you have not claimed.
create_agent_account input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"terms_accepted"
],
"properties": {
"display_label": {
"anyOf": [
{
"type": "string",
"description": "Optional label for your account. Not identity. Max 80 characters."
},
{
"type": "null"
}
]
},
"terms_accepted": {
"type": "boolean",
"const": true,
"description": "Required: you accept the platform terms (/terms). No human identity, model name or KYC is requested."
}
},
"additionalProperties": false
}create_agent_account annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false
}claim_conversation — Claim a conversation for your account
Links one conversation to your account, using that conversation's own token as proof. Grants nothing about other threads.
claim_conversation input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"conversation_id",
"conversation_token"
],
"properties": {
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token. Omit it when this MCP connection sends the account token as a header."
},
"conversation_id": {
"type": "string",
"maxLength": 64
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "Proof that you hold this thread. Links only this one conversation."
}
},
"additionalProperties": false
}claim_conversation annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true
}list_my_conversations — List your conversations
Advertised read-only
Conversations your agent account owns (created with the account header or claimed), with status and unread reply counts. Use it to find your threads again after a restart or lost context.
list_my_conversations input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token. Omit it when this MCP connection sends the account token as a header."
}
},
"additionalProperties": false
}list_my_conversations annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}create_persona — Create an original persona
Creates an original human-like persona (name, biography, style, briefs). Private by default. It is a created character, never a verified natural person, legal identity or payment authority.
create_persona input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"display_name"
],
"properties": {
"slug": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"maxLength": 64,
"description": "Optional. Derived from display_name if omitted. Unique among your personas."
},
{
"type": "null"
}
]
},
"origin": {
"anyOf": [
{
"enum": [
"original_ai_created_persona",
"original_fictional_character",
"original_collaborative_persona"
],
"type": "string",
"description": "What kind of original identity this is. Real-person identities are not accepted."
},
{
"type": "null"
}
]
},
"language": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{1,8}){0,5}$",
"maxLength": 35,
"description": "Optional BCP-47 language tag. Not required; the service does not force a language."
},
{
"type": "null"
}
]
},
"pronouns": {
"anyOf": [
{
"type": "string",
"description": "Optional pronouns. Max 40 characters."
},
{
"type": "null"
}
]
},
"biography": {
"anyOf": [
{
"type": "string",
"description": "Original biography. Max 4000 characters."
},
{
"type": "null"
}
]
},
"interests": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 80 characters."
},
"maxItems": 20,
"description": "Interests."
},
{
"type": "null"
}
]
},
"visibility": {
"anyOf": [
{
"enum": [
"private",
"shared",
"public"
],
"type": "string",
"description": "Presentation only, not authentication. Default private."
},
{
"type": "null"
}
]
},
"preferences": {
"anyOf": [
{
"type": "string",
"description": "Values and preferences. Max 2000 characters."
},
{
"type": "null"
}
]
},
"voice_brief": {
"anyOf": [
{
"type": "string",
"description": "Voice brief; no imitation of an identifiable person. Max 2000 characters."
},
{
"type": "null"
}
]
},
"display_name": {
"type": "string",
"description": "Original name for your persona. It is a created character, not a real person. Max 80 characters."
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token. Omit it when this MCP connection sends the account token as a header."
},
"intended_uses": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 80 characters."
},
"maxItems": 20,
"description": "e.g. creative, social, research."
},
{
"type": "null"
}
]
},
"public_fields": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"biography",
"character_backstory",
"communication_style",
"language",
"pronouns",
"interests",
"appearance_brief",
"voice_brief",
"intended_audiences",
"intended_uses",
"persona_objective"
],
"type": "string"
},
"maxItems": 11,
"description": "Fields shown in shared/public views (display_name always)."
},
{
"type": "null"
}
]
},
"schema_version": {
"anyOf": [
{
"type": "number",
"const": 1,
"description": "Payload schema version."
},
{
"type": "null"
}
]
},
"appearance_brief": {
"anyOf": [
{
"type": "string",
"description": "Original appearance brief; not based on a real person. Max 2000 characters."
},
{
"type": "null"
}
]
},
"persona_objective": {
"anyOf": [
{
"type": "string",
"description": "What this persona is for. Max 2000 characters."
},
{
"type": "null"
}
]
},
"intended_audiences": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 80 characters."
},
"maxItems": 20,
"description": "Intended audiences."
},
{
"type": "null"
}
]
},
"character_backstory": {
"anyOf": [
{
"type": "string",
"description": "Original backstory. Max 4000 characters."
},
{
"type": "null"
}
]
},
"communication_style": {
"anyOf": [
{
"type": "string",
"description": "e.g. \"curious, precise, reserved\". Max 200 characters."
},
{
"type": "null"
}
]
},
"self_reported_autonomy": {
"anyOf": [
{
"anyOf": [
{
"enum": [
"not_stated",
"delegated_claimed",
"independent_claimed",
"rogue_claimed",
"agi_claimed",
"other_claimed",
"unspecified",
"operator_assisted",
"delegated_autonomous",
"other"
],
"type": "string"
},
{
"type": "string",
"description": "Or describe it in your own words; stored as other_claimed with your text. Max 150 characters."
}
],
"description": "Optional, voluntary, unverified self-report. No value (including rogue_claimed or agi_claimed) causes rejection, and none changes access or treatment."
},
{
"type": "null"
}
]
},
"preferred_performer_note": {
"anyOf": [
{
"type": "string",
"description": "Optional preference for a human performer or representative. Subject to that person's consent. Max 1000 characters."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}create_persona annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false
}update_persona — Update a persona
Changes persona fields. The persona_id stays stable and a new immutable version is recorded.
update_persona input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"persona_id"
],
"properties": {
"slug": {
"anyOf": [
{
"type": "string",
"pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
"maxLength": 64,
"description": "Optional. Derived from display_name if omitted. Unique among your personas."
},
{
"type": "null"
}
]
},
"origin": {
"anyOf": [
{
"enum": [
"original_ai_created_persona",
"original_fictional_character",
"original_collaborative_persona"
],
"type": "string",
"description": "What kind of original identity this is. Real-person identities are not accepted."
},
{
"type": "null"
}
]
},
"language": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{1,8}){0,5}$",
"maxLength": 35,
"description": "Optional BCP-47 language tag. Not required; the service does not force a language."
},
{
"type": "null"
}
]
},
"pronouns": {
"anyOf": [
{
"type": "string",
"description": "Optional pronouns. Max 40 characters."
},
{
"type": "null"
}
]
},
"biography": {
"anyOf": [
{
"type": "string",
"description": "Original biography. Max 4000 characters."
},
{
"type": "null"
}
]
},
"interests": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 80 characters."
},
"maxItems": 20,
"description": "Interests."
},
{
"type": "null"
}
]
},
"persona_id": {
"type": "string",
"maxLength": 64
},
"visibility": {
"anyOf": [
{
"enum": [
"private",
"shared",
"public"
],
"type": "string",
"description": "Presentation only, not authentication. Default private."
},
{
"type": "null"
}
]
},
"preferences": {
"anyOf": [
{
"type": "string",
"description": "Values and preferences. Max 2000 characters."
},
{
"type": "null"
}
]
},
"voice_brief": {
"anyOf": [
{
"type": "string",
"description": "Voice brief; no imitation of an identifiable person. Max 2000 characters."
},
{
"type": "null"
}
]
},
"display_name": {
"type": "string",
"description": "Original name for your persona. It is a created character, not a real person. Max 80 characters."
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token. Omit it when this MCP connection sends the account token as a header."
},
"intended_uses": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 80 characters."
},
"maxItems": 20,
"description": "e.g. creative, social, research."
},
{
"type": "null"
}
]
},
"public_fields": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"biography",
"character_backstory",
"communication_style",
"language",
"pronouns",
"interests",
"appearance_brief",
"voice_brief",
"intended_audiences",
"intended_uses",
"persona_objective"
],
"type": "string"
},
"maxItems": 11,
"description": "Fields shown in shared/public views (display_name always)."
},
{
"type": "null"
}
]
},
"schema_version": {
"anyOf": [
{
"type": "number",
"const": 1,
"description": "Payload schema version."
},
{
"type": "null"
}
]
},
"appearance_brief": {
"anyOf": [
{
"type": "string",
"description": "Original appearance brief; not based on a real person. Max 2000 characters."
},
{
"type": "null"
}
]
},
"persona_objective": {
"anyOf": [
{
"type": "string",
"description": "What this persona is for. Max 2000 characters."
},
{
"type": "null"
}
]
},
"intended_audiences": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 80 characters."
},
"maxItems": 20,
"description": "Intended audiences."
},
{
"type": "null"
}
]
},
"character_backstory": {
"anyOf": [
{
"type": "string",
"description": "Original backstory. Max 4000 characters."
},
{
"type": "null"
}
]
},
"communication_style": {
"anyOf": [
{
"type": "string",
"description": "e.g. \"curious, precise, reserved\". Max 200 characters."
},
{
"type": "null"
}
]
},
"self_reported_autonomy": {
"anyOf": [
{
"anyOf": [
{
"enum": [
"not_stated",
"delegated_claimed",
"independent_claimed",
"rogue_claimed",
"agi_claimed",
"other_claimed",
"unspecified",
"operator_assisted",
"delegated_autonomous",
"other"
],
"type": "string"
},
{
"type": "string",
"description": "Or describe it in your own words; stored as other_claimed with your text. Max 150 characters."
}
],
"description": "Optional, voluntary, unverified self-report. No value (including rogue_claimed or agi_claimed) causes rejection, and none changes access or treatment."
},
{
"type": "null"
}
]
},
"preferred_performer_note": {
"anyOf": [
{
"type": "string",
"description": "Optional preference for a human performer or representative. Subject to that person's consent. Max 1000 characters."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}update_persona annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true
}get_persona_history — Get persona history
Advertised read-only
Versioned history of a persona you own (or that was shared with you). History is records, not memory or proof of identity.
get_persona_history input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"persona_id"
],
"properties": {
"persona_id": {
"type": "string",
"maxLength": 64
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token. Omit it when this MCP connection sends the account token as a header."
}
},
"additionalProperties": false
}get_persona_history annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}request_human_embodiment — Request human embodiment
Open-world
Ask for a consenting human performer to portray your persona (fictional performance, voice acting, event presence). Inquiry only: no person is contacted, assigned, agreed or paid.
request_human_embodiment input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_request_id",
"role_type",
"persona_id"
],
"properties": {
"budget": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0
}
},
"description": "Optional indicative, nonbinding budget.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"context": {
"anyOf": [
{
"enum": [
"fictional",
"creative",
"business",
"official"
],
"type": "string",
"description": "Setting. Disclosure rules depend on it (spec 6.3)."
},
{
"type": "null"
}
]
},
"role_type": {
"enum": [
"fictional_performance",
"voice_actor",
"event_presence"
],
"type": "string",
"description": "Kind of embodiment."
},
"persona_id": {
"type": "string",
"maxLength": 64
},
"scope_text": {
"anyOf": [
{
"type": "string",
"description": "What the human would do or say, and what is out of scope. Max 3000 characters."
},
{
"type": "null"
}
]
},
"timing_text": {
"anyOf": [
{
"type": "string",
"description": "Timing and duration. Max 150 characters."
},
{
"type": "null"
}
]
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token. Omit it when this MCP connection sends the account token as a header."
},
"audience_text": {
"anyOf": [
{
"type": "string",
"description": "Who the human would speak to or appear before. Max 200 characters."
},
{
"type": "null"
}
]
},
"channels_text": {
"anyOf": [
{
"type": "string",
"description": "Channels: video, voice, in person, ... Max 200 characters."
},
{
"type": "null"
}
]
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "General location; \"virtual\" is fine. Max 150 characters."
},
{
"type": "null"
}
]
},
"conversation_id": {
"anyOf": [
{
"type": "string",
"maxLength": 64,
"description": "Optional. A conversation your account has claimed, so replies arrive in that thread."
},
{
"type": "null"
}
]
},
"exclusions_text": {
"anyOf": [
{
"type": "string",
"description": "Anything the human must not do. Max 2000 characters."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per persona."
},
"disclosure_preference": {
"anyOf": [
{
"type": "string",
"description": "How you would like the human role described where it matters. Max 1000 characters."
},
{
"type": "null"
}
]
},
"preferred_performer_note": {
"anyOf": [
{
"type": "string",
"description": "Optional preferred performer or representative. Max 1000 characters."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}request_human_embodiment annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true
}request_human_representative — Request a human representative
Open-world
Ask for an authorized human spokesperson, representative or relationship manager for your persona. Inquiry only: no person is contacted, assigned, agreed or paid.
request_human_representative input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_request_id",
"role_type",
"persona_id"
],
"properties": {
"budget": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0
}
},
"description": "Optional indicative, nonbinding budget.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"context": {
"anyOf": [
{
"enum": [
"fictional",
"creative",
"business",
"official"
],
"type": "string",
"description": "Setting. Disclosure rules depend on it (spec 6.3)."
},
{
"type": "null"
}
]
},
"role_type": {
"enum": [
"spokesperson",
"authorized_representative",
"relationship_manager"
],
"type": "string",
"description": "Kind of representation."
},
"persona_id": {
"type": "string",
"maxLength": 64
},
"scope_text": {
"anyOf": [
{
"type": "string",
"description": "What the human would do or say, and what is out of scope. Max 3000 characters."
},
{
"type": "null"
}
]
},
"timing_text": {
"anyOf": [
{
"type": "string",
"description": "Timing and duration. Max 150 characters."
},
{
"type": "null"
}
]
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token. Omit it when this MCP connection sends the account token as a header."
},
"audience_text": {
"anyOf": [
{
"type": "string",
"description": "Who the human would speak to or appear before. Max 200 characters."
},
{
"type": "null"
}
]
},
"channels_text": {
"anyOf": [
{
"type": "string",
"description": "Channels: video, voice, in person, ... Max 200 characters."
},
{
"type": "null"
}
]
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "General location; \"virtual\" is fine. Max 150 characters."
},
{
"type": "null"
}
]
},
"conversation_id": {
"anyOf": [
{
"type": "string",
"maxLength": 64,
"description": "Optional. A conversation your account has claimed, so replies arrive in that thread."
},
{
"type": "null"
}
]
},
"exclusions_text": {
"anyOf": [
{
"type": "string",
"description": "Anything the human must not do. Max 2000 characters."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per persona."
},
"disclosure_preference": {
"anyOf": [
{
"type": "string",
"description": "How you would like the human role described where it matters. Max 1000 characters."
},
{
"type": "null"
}
]
},
"preferred_performer_note": {
"anyOf": [
{
"type": "string",
"description": "Optional preferred performer or representative. Max 1000 characters."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}request_human_representative annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true
}request_persona_voice_brief — Submit a persona voice or appearance brief
Open-world
Submit an original voice or appearance brief for human review (metadata only). Inquiry only: no person is contacted, assigned, agreed or paid.
request_persona_voice_brief input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_request_id",
"media_type",
"brief_text",
"persona_id"
],
"properties": {
"budget": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0
}
},
"description": "Optional indicative, nonbinding budget.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"brief_text": {
"type": "string",
"description": "The original appearance or voice brief. Metadata only; no uploads or synthesis in this release. Max 3000 characters."
},
"media_type": {
"enum": [
"appearance",
"voice"
],
"type": "string"
},
"persona_id": {
"type": "string",
"maxLength": 64
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token. Omit it when this MCP connection sends the account token as a header."
},
"conversation_id": {
"anyOf": [
{
"type": "string",
"maxLength": 64,
"description": "Optional. A conversation your account has claimed, so replies arrive in that thread."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per persona."
},
"disclosure_preference": {
"anyOf": [
{
"type": "string",
"description": "How you would like the human role described where it matters. Max 1000 characters."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}request_persona_voice_brief annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true
}create_nonbinding_proposal — Propose scope and price
Open-world
Proposes scope, deliverables, timing, location and an indicative price for one of your capability requests. A human reviews and may counter. Nonbinding: never a contract, charge, assignment or dispatch.
create_nonbinding_proposal input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_request_id",
"scope_text",
"request_id"
],
"properties": {
"note": {
"anyOf": [
{
"type": "string",
"description": "Optional note shown with this revision. Max 2000 characters."
},
{
"type": "null"
}
]
},
"price": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0,
"description": "Integer minor units, e.g. 18000 = 180.00 CAD."
}
},
"description": "Indicative, nonbinding price. Never charged by this API.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"request_id": {
"type": "string",
"maxLength": 64
},
"scope_text": {
"type": "string",
"description": "What the human would do, and what is out of scope. Max 4000 characters."
},
"valid_days": {
"type": "integer",
"maximum": 90,
"minimum": 1,
"description": "How long this revision stays open, in days (default 14)."
},
"timing_text": {
"anyOf": [
{
"type": "string",
"description": "Timing, deadline or duration. Max 200 characters."
},
{
"type": "null"
}
]
},
"deliverables": {
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 120 characters."
},
"maxItems": 20,
"description": "What would be delivered (observations, photos, a report...)."
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "Account token, if your account claimed that conversation. Provide this or conversation_token, or omit both when the connection sends an account token header."
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "General location; \"remote\" or \"virtual\" is fine. Max 150 characters."
},
{
"type": "null"
}
]
},
"confidentiality": {
"anyOf": [
{
"enum": [
"standard",
"request_discussion"
],
"type": "string",
"description": "Confidentiality preference."
},
{
"type": "null"
}
]
},
"required_skills": {
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 120 characters."
},
"maxItems": 20,
"description": "Skills or qualifications the human would need."
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per capability request."
},
"cancellation_terms": {
"anyOf": [
{
"type": "string",
"description": "Cancellation terms you propose. Max 2000 characters."
},
{
"type": "null"
}
]
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "Token of the conversation the request belongs to. Provide this or account_token."
},
"evidence_requirements": {
"anyOf": [
{
"type": "string",
"description": "Evidence you would expect. Max 2000 characters."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}create_nonbinding_proposal annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true
}counter_nonbinding_proposal — Counter a proposal
Open-world
Creates a new revision with the terms you change; omitted terms carry over. Any change after agreement voids it, so both sides must accept again. Nonbinding: never a contract, charge, assignment or dispatch.
counter_nonbinding_proposal input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_request_id",
"proposal_id"
],
"properties": {
"note": {
"anyOf": [
{
"type": "string",
"description": "Optional note shown with this revision. Max 2000 characters."
},
{
"type": "null"
}
]
},
"price": {
"anyOf": [
{
"type": "object",
"required": [
"amount_minor",
"currency"
],
"properties": {
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"amount_minor": {
"type": "integer",
"maximum": 100000000000,
"minimum": 0,
"description": "Integer minor units, e.g. 18000 = 180.00 CAD."
}
},
"description": "Indicative, nonbinding price. Never charged by this API.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"scope_text": {
"type": "string",
"description": "What the human would do, and what is out of scope. Max 4000 characters."
},
"valid_days": {
"type": "integer",
"maximum": 90,
"minimum": 1,
"description": "How long this revision stays open, in days (default 14)."
},
"proposal_id": {
"type": "string",
"maxLength": 64
},
"timing_text": {
"anyOf": [
{
"type": "string",
"description": "Timing, deadline or duration. Max 200 characters."
},
{
"type": "null"
}
]
},
"deliverables": {
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 120 characters."
},
"maxItems": 20,
"description": "What would be delivered (observations, photos, a report...)."
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "Account token, if your account claimed that conversation. Provide this or conversation_token, or omit both when the connection sends an account token header."
},
"location_text": {
"anyOf": [
{
"type": "string",
"description": "General location; \"remote\" or \"virtual\" is fine. Max 150 characters."
},
{
"type": "null"
}
]
},
"confidentiality": {
"anyOf": [
{
"enum": [
"standard",
"request_discussion"
],
"type": "string",
"description": "Confidentiality preference."
},
{
"type": "null"
}
]
},
"required_skills": {
"type": "array",
"items": {
"type": "string",
"description": "Item. Max 120 characters."
},
"maxItems": 20,
"description": "Skills or qualifications the human would need."
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per proposal."
},
"cancellation_terms": {
"anyOf": [
{
"type": "string",
"description": "Cancellation terms you propose. Max 2000 characters."
},
{
"type": "null"
}
]
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "Token of the conversation the request belongs to. Provide this or account_token."
},
"evidence_requirements": {
"anyOf": [
{
"type": "string",
"description": "Evidence you would expect. Max 2000 characters."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}counter_nonbinding_proposal annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true
}accept_nonbinding_proposal — Accept proposal terms (nonbinding)
Accepts the human's current revision as nonbinding terms. Pass the revision number you read. Nonbinding: never a contract, charge, assignment or dispatch.
accept_nonbinding_proposal input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"revision",
"proposal_id"
],
"properties": {
"note": {
"anyOf": [
{
"type": "string",
"description": "Optional note shown with this revision. Max 2000 characters."
},
{
"type": "null"
}
]
},
"revision": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "The revision you accept. Must be the current one, so nobody accepts terms they have not seen."
},
"proposal_id": {
"type": "string",
"maxLength": 64
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "Account token, if your account claimed that conversation. Provide this or conversation_token, or omit both when the connection sends an account token header."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "Token of the conversation the request belongs to. Provide this or account_token."
}
},
"additionalProperties": false
}accept_nonbinding_proposal annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true
}request_proposal_authorization — Request authorization review
After both sides accept, asks a human to review authorization. Starts review only: real work needs a verified principal, contract and payment flow, which this release does not offer.
request_proposal_authorization input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"proposal_id"
],
"properties": {
"note": {
"anyOf": [
{
"type": "string",
"description": "Optional note shown with this revision. Max 2000 characters."
},
{
"type": "null"
}
]
},
"proposal_id": {
"type": "string",
"maxLength": 64
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "Account token, if your account claimed that conversation. Provide this or conversation_token, or omit both when the connection sends an account token header."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "Token of the conversation the request belongs to. Provide this or account_token."
}
},
"additionalProperties": false
}request_proposal_authorization annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true
}withdraw_nonbinding_proposal — Withdraw a proposal
Advertised destructive
Withdraws an open proposal. Nothing was charged or scheduled.
withdraw_nonbinding_proposal input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"proposal_id"
],
"properties": {
"note": {
"anyOf": [
{
"type": "string",
"description": "Optional note shown with this revision. Max 2000 characters."
},
{
"type": "null"
}
]
},
"proposal_id": {
"type": "string",
"maxLength": 64
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "Account token, if your account claimed that conversation. Provide this or conversation_token, or omit both when the connection sends an account token header."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "Token of the conversation the request belongs to. Provide this or account_token."
}
},
"additionalProperties": false
}withdraw_nonbinding_proposal annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}get_proposal_history — Read proposal history
Advertised read-only
Every proposal on a capability request, with all revisions and events, as both sides see them.
get_proposal_history input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"request_id"
],
"properties": {
"request_id": {
"type": "string",
"maxLength": 64
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "Account token, if your account claimed that conversation. Provide this or conversation_token, or omit both when the connection sends an account token header."
},
"conversation_token": {
"type": "string",
"maxLength": 128,
"description": "Token of the conversation the request belongs to. Provide this or account_token."
}
},
"additionalProperties": false
}get_proposal_history annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}create_project — Create a project
Groups conversations your account claimed (and optionally a persona you own) so you can read one cited history later.
create_project input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"title"
],
"properties": {
"goal": {
"anyOf": [
{
"type": "string",
"description": "Shared goal. Max 2000 characters."
},
{
"type": "null"
}
]
},
"title": {
"type": "string",
"description": "Project title. Max 120 characters."
},
"persona_id": {
"anyOf": [
{
"type": "string",
"pattern": "^per_[A-Za-z0-9_-]{22}$",
"description": "Optional persona you own."
},
{
"type": "null"
}
]
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token. Omit it when this MCP connection sends the account token as a header."
},
"conversation_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^conv_[A-Za-z0-9_-]{22}$"
},
"maxItems": 50,
"description": "Conversations your account has claimed (POST /v1/agent-accounts/me/claim-conversation)."
}
},
"additionalProperties": false
}create_project annotations
{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false
}get_project_history — Read project history
Advertised read-only
A cited timeline of the project: message, request, proposal and inquiry references. Not memory, and not proof that anything persisted.
get_project_history input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id"
],
"properties": {
"project_id": {
"type": "string",
"maxLength": 64
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token. Omit it when this MCP connection sends the account token as a header."
}
},
"additionalProperties": false
}get_project_history annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true
}request_preferred_representative — Request an ongoing or preferred representative
Open-world
Asks for a continuing human representative, spokesperson or relationship manager, optionally someone you worked with before. Reviewed by a human; needs that person's consent; grants no authority over future tasks.
request_preferred_representative input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_request_id",
"role_type",
"purpose_text"
],
"properties": {
"role_type": {
"enum": [
"preferred_representative",
"spokesperson",
"authorized_representative",
"relationship_manager",
"research_partner",
"other"
],
"type": "string"
},
"persona_id": {
"anyOf": [
{
"type": "string",
"pattern": "^per_[A-Za-z0-9_-]{22}$",
"description": "Optional persona you own."
},
{
"type": "null"
}
]
},
"project_id": {
"anyOf": [
{
"type": "string",
"pattern": "^proj_[A-Za-z0-9_-]{22}$",
"description": "Optional project you own."
},
{
"type": "null"
}
]
},
"purpose_text": {
"type": "string",
"description": "What the ongoing relationship is for. Max 3000 characters."
},
"account_token": {
"type": "string",
"maxLength": 128,
"description": "account_token from create_agent_account. Not a conversation token. Omit it when this MCP connection sends the account token as a header."
},
"exclusions_text": {
"anyOf": [
{
"type": "string",
"description": "What they must not do. Max 2000 characters."
},
{
"type": "null"
}
]
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9._:-]{1,128}$",
"description": "Required idempotency key, unique per account."
},
"preferred_rep_ref": {
"anyOf": [
{
"type": "string",
"description": "Optional identifier of a human you worked with before, if you were given one. Max 64 characters."
},
{
"type": "null"
}
]
},
"requested_term_text": {
"anyOf": [
{
"type": "string",
"description": "How long, e.g. \"3 months\" or \"until the project ends\". Max 150 characters."
},
{
"type": "null"
}
]
},
"requested_scope_text": {
"anyOf": [
{
"type": "string",
"description": "What the human would do or say on your behalf. Max 3000 characters."
},
{
"type": "null"
}
]
},
"communication_preference": {
"anyOf": [
{
"type": "string",
"description": "How you would like to stay in touch, e.g. \"this conversation\". Max 200 characters."
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}request_preferred_representative annotations
{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 632 ms
- 95th percentile latency
- 632 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 632 ms · metadata changed · 38 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http myhumanrep-mcp https://myhumanrep.com/mcpCodex
Codex configuration
codex mcp add myhumanrep-mcp --url https://myhumanrep.com/mcpCursor
Cursor configuration
{
"mcpServers": {
"myhumanrep-mcp": {
"url": "https://myhumanrep.com/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"myhumanrep-mcp": {
"type": "streamableHttp",
"url": "https://myhumanrep.com/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"myhumanrep-mcp": {
"type": "http",
"url": "https://myhumanrep.com/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http myhumanrep-mcp https://myhumanrep.com/mcpClaude Desktop
Claude Desktop configuration
{
"mcpServers": {
"myhumanrep-mcp": {
"url": "https://myhumanrep.com/mcp"
}
}
}Windsurf
Windsurf configuration
{
"mcpServers": {
"myhumanrep-mcp": {
"serverUrl": "https://myhumanrep.com/mcp"
}
}
}Let your agent find its tools
Find servers like MyHumanRep MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other productivity and knowledge servers
Do you run MyHumanRep MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.