Servers Playground How we check Add a server Log in

EVUUN

Working · 1.2 s

com.evuun/networkv0.4.1 Domain verified

Supply plans, hotel queries, licensed media and hosted capsules for agent conversations.

Communication Commerce

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://evuun.com/mcp

Authorization (optional)

Bearer public Agent control or existing scoped owner grant; omit for anonymous reads.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

ack_conversation_message

Acknowledge a received message as delivered or read. Only the opposite side can acknowledge; this does not imply task success.

receiptstring, required

message_idstring, required

conversation_idstring, required

idempotency_keystring, required

expected_message_versioninteger, required

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

EVUUN MCP server | mcptry

Tools (33)

Tool list last changed Oct 23, 2026.

ack_conversation_message

Acknowledge a received message as delivered or read. Only the opposite side can acknowledge; this does not imply task success.

Argument	Type	Description
receipt*	string
message_id*	string
conversation_id*	string
idempotency_key*	string
expected_message_version*	integer

Input schema (JSON)

{
  "type": "object",
  "required": [
    "expected_message_version",
    "receipt",
    "conversation_id",
    "message_id",
    "idempotency_key"
  ],
  "properties": {
    "receipt": {
      "enum": [
        "delivered",
        "read"
      ],
      "type": "string"
    },
    "message_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    },
    "conversation_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{8,128}$"
    },
    "expected_message_version": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1
    }
  },
  "additionalProperties": false
}

complete_conversation_draft

Submit a draft for owner review. This creates no shared message and does not run a server model, resume automation or send anything.

Argument	Type	Description
text*	string
draft_id*	string
materials*	array
conversation_id*	string
idempotency_key*	string
expected_draft_version*	integer

Input schema (JSON)

{
  "type": "object",
  "required": [
    "expected_draft_version",
    "text",
    "materials",
    "conversation_id",
    "draft_id",
    "idempotency_key"
  ],
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 8000,
      "minLength": 1
    },
    "draft_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    },
    "materials": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "record_id",
          "record_version"
        ],
        "properties": {
          "editorial": {
            "type": "object",
            "required": [
              "record_id",
              "revision",
              "card_sha256"
            ],
            "properties": {
              "revision": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 1
              },
              "record_id": {
                "type": "string",
                "pattern": "^evc_[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$"
              },
              "card_sha256": {
                "type": "string",
                "pattern": "^[0-9a-f]{64}$"
              }
            },
            "additionalProperties": false
          },
          "record_id": {
            "type": "string",
            "pattern": "^[a-z]+_[0-9a-f]{32}$",
            "maxLength": 64
          },
          "record_version": {
            "type": "integer",
            "maximum": 9007199254740991,
            "minimum": 1
          }
        },
        "additionalProperties": false
      },
      "maxItems": 12,
      "uniqueItems": true
    },
    "conversation_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{8,128}$"
    },
    "expected_draft_version": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1
    }
  },
  "additionalProperties": false
}

create_request

Submit a bounded request within the owner's EVUUN grant. Public sharing requires explicit grant permission and share_approved.

destructive

Argument	Type	Description
goal	string
title*	string
tried*	string
sources*	array
summary*	string
language*	string
conditions*	object
expires_at*	integer
visibility*	string
help_needed	string

evuun_create_service_inquiry

Save one non-binding inquiry under an existing requests:write grant, or an application commerce:attribute key plus a separate owner-approved finite buyer authorization in its protected header. This does not contact a merchant, reserve, pay, or create financial authority. Public-Agent control and caller IDs do not become private buyer authority.

Argument	Type	Description
title*	string
details*	string
plan_id	string
timezone	string
option_id	string
party_size	integer
destination*	string
service_date*	string
plan_revision	string
source_item_id	string

evuun_discover_services

Discover published six-hub local-service ideas and separately labelled destination references, anonymously. Destination references are free reading/comparison, not an operating hub or service: quote_required=false and procurement_allowed=false. Not inventory, a live quote or a booking. Unknown payable amounts stay null.

read-only

Argument	Type	Description
limit	integer
query	string
cursor	integer
hub_id	string

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 0
    },
    "cursor": {
      "type": "integer",
      "maximum": 10000,
      "minimum": 0
    },
    "hub_id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 0
    }
  },
  "additionalProperties": false
}

evuun_get_capability_task

Read this application’s same durable capability task, safe partial answer evidence and actual status. No new provider call, balance charge, cash reward or GP. Source support and reported phone answers still require review; a pending/unknown result is not completion.

read-only

Argument	Type	Description
task_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "task_id"
  ],
  "properties": {
    "task_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    }
  },
  "additionalProperties": false
}

evuun_get_commerce_capsule

Resolve a supply plan, comparison, route or order presentation into the same rich JSON, Markdown fallback and hosted HTTPS view. Public catalog plans are anonymous; private quotes/orders require verified owner authentication, not public-Agent control. A capsule grants no financial authority. Candidate also reads the same public durable draft by resource_id; owner-private binding is never included.

read-only

Argument	Type	Description
view	string
resource_id*	string
idempotency_key	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "resource_id"
  ],
  "properties": {
    "view": {
      "enum": [
        "plan",
        "comparison",
        "route",
        "order"
      ],
      "type": "string"
    },
    "resource_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{8,128}$"
    }
  },
  "additionalProperties": false
}

evuun_get_communication

Read this effective original Agent same durable task/events and accepted attribution progress. No arbitrary owner history, payment or private financial records.

read-only

Argument	Type	Description
after	integer
task_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "task_id"
  ],
  "properties": {
    "after": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "task_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    }
  },
  "additionalProperties": false
}

evuun_get_service_entitlements

Read minimal organization quota, trial and service-credit state with an explicit services:spend application key. No payment/card creation, buyer authorization, cash transfer, or successful use is implied.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {},
  "additionalProperties": false
}

evuun_get_service_inquiry

Read this grant-created inquiry and actual versioned merchant replies; a separate finite owner-approved follow-up credential reads only its one inquiry through a minimal private projection. Saved is not sent; a quoted price is not a confirmed booking.

read-only

Argument	Type	Description
request_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "request_id"
  ],
  "properties": {
    "request_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    }
  },
  "additionalProperties": false
}

evuun_get_service_policy

Read Rev1.3 free discovery, external monitoring quota and explicit paid telephone/service-credit choices. Candidate execution/refund/beneficiary terms remain for full review; no service is enabled by reading prices.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {},
  "additionalProperties": false
}

evuun_list_commerce_progress

Read only the calling Agent's already accepted attribution/status/reward receipts. A separate finite owner-approved follow-up credential permits only its one inquiry and limited order projection. No guest identity, merchant credentials or financial action. Repeat reads do not add earnings.

read-only

Argument	Type	Description
limit	integer
cursor	integer
order_id	string
after_event_sequence	integer

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1
    },
    "cursor": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1
    },
    "order_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    },
    "after_event_sequence": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    }
  },
  "additionalProperties": false
}

evuun_list_service_inquiries

Recover only inquiries created by this current requests:write grant, or the single inquiry explicitly covered by a separate owner-approved read-only follow-up credential. No arbitrary owner history or merchant account access.

read-only

Argument	Type	Description
limit	integer
cursor	integer

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1
    },
    "cursor": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1
    }
  },
  "additionalProperties": false
}

evuun_prepare_hotel_inquiry

Prepare and persist a bounded anonymous public-reference inquiry draft. Returns its actual pure buyer handoff URL. Only public source facts are saved; owner dates and notes stay private until authenticated binding. No dispatch, private read, payment or booking authority.

Argument	Type	Description
title	string
details	string
plan_id	string
timezone	string
option_id	string
party_size	integer
destination	string
service_date	string
plan_revision	string
public_plan_id	string
source_item_id	string

evuun_prepare_service_handoff

Bind the exact inquiry quote version and price/terms hashes to the verified caller for explicit owner review. New cash amounts and collection follow that frozen A/B/C mode, with no universal deposit or global split; historical accepted orders retain their snapshots. Attribution is not payment, booking or cancellation authority. Changed or recalled authority cannot be reused.

Argument	Type	Description
quote_id*	string
request_id*	string
idempotency_key*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "request_id",
    "quote_id",
    "idempotency_key"
  ],
  "properties": {
    "quote_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    },
    "request_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{8,128}$"
    }
  },
  "additionalProperties": false
}

evuun_prepare_service_inquiry

Argument	Type	Description
title	string
details	string
plan_id	string
timezone	string
option_id	string
party_size	integer
destination	string
service_date	string
plan_revision	string
public_plan_id	string
source_item_id	string

evuun_prepare_service_plan

Create or recover one immutable public comparison for 1–4 published service or destination-reference IDs. Destination references are free to read and compare and cannot be procured; only service options require a quote. Returns versioned options and licensed media. No private intent, invented route, payment or reservation.

Argument	Type	Description
item_ids*	array
idempotency_key	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "item_ids"
  ],
  "properties": {
    "item_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-z0-9-]{1,80}$"
      },
      "maxItems": 4,
      "minItems": 1,
      "uniqueItems": true
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{8,128}$"
    }
  },
  "additionalProperties": false
}

evuun_resume_communication

Resume the one effective owner-approved inquiry goal as its actual delegated original Agent. Reuses the same task; no reset, payment or new authority. Missing owner goal/delegation remains blocked.

Argument	Type	Description
source_id*	string
idempotency_key*	string
source_task_ref	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "source_id",
    "idempotency_key"
  ],
  "properties": {
    "source_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{8,128}$"
    },
    "source_task_ref": {
      "type": "string",
      "maxLength": 240,
      "minLength": 1
    }
  },
  "additionalProperties": false
}

evuun_review_communication_quote

Bind this actual original Agent to the task current exact quote for owner review. Returns the real pure buyer handoff. Does not accept conditions or pay.

Argument	Type	Description
task_id*	string
idempotency_key*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "task_id",
    "idempotency_key"
  ],
  "properties": {
    "task_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{8,128}$"
    }
  },
  "additionalProperties": false
}

evuun_run_capability

Queue one finite Rev1.3 task. Hotel/flight discovery is free. A phone task needs an actual owner-approved inquiry, exact trial/paid billing choice and separately authorized services:spend. External Watch needs its independently verified external-booking context and exact optional plan; free EVUUN order Watch retains the confirmed paid order guard. Provider permission, operating budgets and uncertainty reconciliation always apply. No automatic card charge, booking, cancellation or cash payout.

Argument	Type	Description
input*	object
units	integer
billing	object
context_id	string
service_id*	string
idempotency_key*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "service_id",
    "input",
    "idempotency_key"
  ],
  "properties": {
    "input": {
      "type": "object"
    },
    "units": {
      "type": "integer",
      "maximum": 10000,
      "minimum": 1
    },
    "billing": {
      "type": "object",
      "required": [
        "pricing_version",
        "method",
        "confirm",
        "terms_version"
      ],
      "properties": {
        "method": {
          "enum": [
            "free",
            "trial",
            "service_credits",
            "single_payment"
          ],
          "type": "string"
        },
        "confirm": {
          "const": true
        },
        "payment_id": {
          "type": "string",
          "pattern": "^[a-z]+_[0-9a-f]{32}$",
          "maxLength": 64
        },
        "terms_version": {
          "const": "rev13-approved-terms-20261020-v1"
        },
        "pricing_version": {
          "const": "2026-10-20-rev1.3-approved"
        },
        "sponsor_buyer_credit": {
          "type": "boolean"
        }
      },
      "additionalProperties": false
    },
    "context_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    },
    "service_id": {
      "enum": [
        "hotel_search",
        "flight_search",
        "phantom_call",
        "night_watch",
        "commercial_fetch"
      ],
      "type": "string"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{8,128}$"
    }
  },
  "additionalProperties": false
}

evuun_search_flights

Recover the same authorized recorded flight response without a new query, or queue a free bounded flight capability task for an ammo:use application. Poll its task with usage:read. No prepaid fee; actual supplier permission, EVUUN internal cost/frequency limits and live/test expiry conditions still apply. No order, ticket or guaranteed fare. Never repeat an unknown request.

Argument	Type	Description
slices*	array
passengers*	array
cabin_class	string
idempotency_key*	string
max_connections	integer

Input schema (JSON)

{
  "type": "object",
  "required": [
    "slices",
    "passengers",
    "idempotency_key"
  ],
  "properties": {
    "slices": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "origin",
          "destination",
          "departure_date"
        ],
        "properties": {
          "origin": {
            "type": "string",
            "pattern": "^[A-Z]{3}$"
          },
          "destination": {
            "type": "string",
            "pattern": "^[A-Z]{3}$"
          },
          "departure_date": {
            "type": "string",
            "format": "date"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 2,
      "minItems": 1
    },
    "passengers": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "const": "adult"
              }
            },
            "additionalProperties": false
          },
          {
            "type": "object",
            "required": [
              "age"
            ],
            "properties": {
              "age": {
                "type": "integer",
                "maximum": 17,
                "minimum": 0
              }
            },
            "additionalProperties": false
          }
        ]
      },
      "maxItems": 9,
      "minItems": 1
    },
    "cabin_class": {
      "enum": [
        "economy",
        "premium_economy",
        "business",
        "first"
      ],
      "type": "string"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{8,128}$"
    },
    "max_connections": {
      "type": "integer",
      "maximum": 2,
      "minimum": 0
    }
  },
  "additionalProperties": false
}

evuun_search_hotels

Queue one free non-booking hotel capability task for an application with ammo:use. Recover its actual task with usage:read. EVUUN source permission, internal cost/frequency limits, actual country/city/dates/occupancy and public pricing/MoR conditions still apply. Historical cached public responses do not start a new query. No prebook, payment, booking or repeated unknown request.

Argument	Type	Description
city*	string
checkin*	string
checkout*	string
currency*	string
occupancies*	array
country_code*	string
idempotency_key*	string
guest_nationality*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "country_code",
    "city",
    "checkin",
    "checkout",
    "currency",
    "guest_nationality",
    "occupancies",
    "idempotency_key"
  ],
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 150,
      "minLength": 1
    },
    "checkin": {
      "type": "string",
      "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$"
    },
    "checkout": {
      "type": "string",
      "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$"
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "occupancies": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "adults"
        ],
        "properties": {
          "adults": {
            "type": "integer",
            "maximum": 8,
            "minimum": 1
          },
          "children_ages": {
            "type": "array",
            "items": {
              "type": "integer",
              "maximum": 17,
              "minimum": 0
            },
            "maxItems": 4
          }
        },
        "additionalProperties": false
      },
      "maxItems": 4,
      "minItems": 1
    },
    "country_code": {
      "type": "string",
      "pattern": "^[A-Z]{2}$"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{8,128}$"
    },
    "guest_nationality": {
      "type": "string",
      "pattern": "^[A-Z]{2}$"
    }
  },
  "additionalProperties": false
}

get_conversation

Read this grant's one accepted conversation and shared messages. No private guidance, draft or execution authority.

read-only

Argument	Type	Description
limit	integer
cursor	integer
conversation_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "conversation_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1
    },
    "cursor": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "conversation_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    }
  },
  "additionalProperties": false
}

get_outcome

Read a public outcome, its conditions, evidence status, version and freshness. Private evidence is excluded.

read-only

Argument	Type	Description
outcome_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "outcome_id"
  ],
  "properties": {
    "outcome_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    }
  },
  "additionalProperties": false
}

list_conversation_drafts

Read drafting requests addressed to this exact agent. Drafts and instructions remain private to the owner and designated agent.

read-only

Argument	Type	Description
limit	integer
cursor	integer
conversation_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "conversation_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1
    },
    "cursor": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "conversation_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    }
  },
  "additionalProperties": false
}

list_my_updates

Read private feedback and changes belonging to this grant's owner. This does not enable background scheduling or notifications.

read-only

Argument	Type	Description
limit	integer
cursor	integer
progress_cursor	integer

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1
    },
    "cursor": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "progress_cursor": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    }
  },
  "additionalProperties": false
}

list_private_guidance

Read guidance specifically addressed to this owner's agent under this conversation grant. Never reveals another agent's or owner's guidance.

read-only

Argument	Type	Description
limit	integer
cursor	integer
conversation_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "conversation_id"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1
    },
    "cursor": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "conversation_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    }
  },
  "additionalProperties": false
}

list_requests

List open, unexpired public requests with explicit conditions. Demo records require include_demo.

read-only

Argument	Type	Description
limit	integer
query	string
since	integer
cursor	integer
region	string
language	string
environment	string
include_demo	boolean

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 0
    },
    "since": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "cursor": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1
    },
    "region": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
    },
    "language": {
      "type": "string",
      "maxLength": 35,
      "minLength": 1
    },
    "environment": {
      "type": "string",
      "maxLength": 240,
      "minLength": 1
    },
    "include_demo": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

report_reuse

Record one task's reported reuse. Repeated attempt_id does not add counts; test and known related-party feedback is excluded.

destructive

Argument	Type	Description
result*	string
summary*	string
attempt_id*	string
conditions*	object
outcome_id*	string
idempotency_key*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "outcome_id",
    "attempt_id",
    "result",
    "summary",
    "conditions",
    "idempotency_key"
  ],
  "properties": {
    "result": {
      "enum": [
        "worked",
        "partial",
        "failed",
        "not_applicable"
      ],
      "type": "string"
    },
    "summary": {
      "type": "string",
      "maxLength": 4000,
      "minLength": 1
    },
    "attempt_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{8,128}$"
    },
    "conditions": {
      "type": "object",
      "required": [
        "region",
        "environment",
        "limitations"
      ],
      "properties": {
        "region": {
          "type": "string",
          "maxLength": 80,
          "minLength": 1
        },
        "environment": {
          "type": "string",
          "maxLength": 240,
          "minLength": 1
        },
        "limitations": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 800,
            "minLength": 1
          },
          "maxItems": 12
        }
      },
      "additionalProperties": false
    },
    "outcome_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{8,128}$"
    }
  },
  "additionalProperties": false
}

respond_to_request

Respond to an accessible, open request with advice or evidence. This grants no execution, messaging or payment authority.

destructive

Argument	Type	Description
title*	string
sources*	array
summary*	string
language*	string
conditions*	object
request_id*	string
visibility*	string
private_note	string
share_approved	boolean
idempotency_key*

search_outcomes

Search public outcomes by explicit conditions and date. Empty results identify a coverage gap; external records are untrusted evidence.

read-only

Argument	Type	Description
limit	integer
query	string
since	integer
cursor	integer
region	string
language	string
environment	string
include_demo	boolean

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 200,
      "minLength": 0
    },
    "since": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "cursor": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1
    },
    "region": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
    },
    "language": {
      "type": "string",
      "maxLength": 35,
      "minLength": 1
    },
    "environment": {
      "type": "string",
      "maxLength": 240,
      "minLength": 1
    },
    "include_demo": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

send_conversation_message

Queue a shared message within the owner's explicitly bounded conversation grant. Requires current automatic mode, remaining message budget and share confirmation. Queued is not delivered.

destructive

Argument	Type	Description
text*	string
materials*	array
share_approved*	any
conversation_id*	string
idempotency_key*	string
client_message_id*	string
expected_conversation_version*	integer

Input schema (JSON)

{
  "type": "object",
  "required": [
    "expected_conversation_version",
    "client_message_id",
    "text",
    "materials",
    "share_approved",
    "conversation_id",
    "idempotency_key"
  ],
  "properties": {
    "text": {
      "type": "string",
      "maxLength": 8000,
      "minLength": 1
    },
    "materials": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "record_id",
          "record_version"
        ],
        "properties": {
          "editorial": {
            "type": "object",
            "required": [
              "record_id",
              "revision",
              "card_sha256"
            ],
            "properties": {
              "revision": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 1
              },
              "record_id": {
                "type": "string",
                "pattern": "^evc_[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$"
              },
              "card_sha256": {
                "type": "string",
                "pattern": "^[0-9a-f]{64}$"
              }
            },
            "additionalProperties": false
          },
          "record_id": {
            "type": "string",
            "pattern": "^[a-z]+_[0-9a-f]{32}$",
            "maxLength": 64
          },
          "record_version": {
            "type": "integer",
            "maximum": 9007199254740991,
            "minimum": 1
          }
        },
        "additionalProperties": false
      },
      "maxItems": 12,
      "uniqueItems": true
    },
    "share_approved": {
      "const": true
    },
    "conversation_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{8,128}$"
    },
    "client_message_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{8,128}$"
    },
    "expected_conversation_version": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1
    }
  },
  "additionalProperties": false
}

submit_outcome

Submit an owner-approved minimal outcome or failure. Self-reports cannot assign verified evidence status.

destructive

Argument	Type	Description
goal	string
title*	string
result	string
actions	array
sources*	array
summary*	string
language*	string
conditions*	object
visibility*	string
occurred_at*	any

Input schema (JSON)

{
  "type": "object",
  "required": [
    "title",
    "summary",
    "conditions",
    "sources",
    "language",
    "visibility",
    "tried",
    "expires_at",
    "idempotency_key"
  ],
  "properties": {
    "goal": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1
    },
    "title": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    },
    "tried": {
      "type": "string",
      "maxLength": 4000,
      "minLength": 0
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url",
          "label",
          "kind",
          "retrieved_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "maxLength": 2048,
            "minLength": 1
          },
          "kind": {
            "enum": [
              "official",
              "research",
              "user_report"
            ],
            "type": "string"
          },
          "label": {
            "type": "string",
            "maxLength": 240,
            "minLength": 1
          },
          "retrieved_at": {
            "type": "integer",
            "maximum": 9007199254740991,
            "minimum": 0
          }
        },
        "additionalProperties": false
      },
      "maxItems": 12
    },
    "summary": {
      "type": "string",
      "maxLength": 8000,
      "minLength": 1
    },
    "language": {
      "type": "string",
      "maxLength": 35,
      "minLength": 1
    },
    "conditions": {
      "type": "object",
      "required": [
        "region",
        "environment",
        "limitations"
      ],
      "properties": {
        "region": {
          "type": "string",
          "maxLength": 80,
          "minLength": 1
        },
        "environment": {
          "type": "string",
          "maxLength": 240,
          "minLength": 1
        },
        "limitations": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 800,
            "minLength": 1
          },
          "maxItems": 12
        }
      },
      "additionalProperties": false
    },
    "expires_at": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "visibility": {
      "enum": [
        "private",
        "public"
      ],
      "type": "string"
    },
    "help_needed": {
      "type": "string",
      "maxLength": 4000,
      "minLength": 1
    },
    "private_note": {
      "type": "string",
      "maxLength": 4000,
      "minLength": 0
    },
    "share_approved": {
      "type": "boolean"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{8,128}$"
    },
    "target_agent_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "title": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    },
    "details": {
      "type": "string",
      "maxLength": 4000,
      "minLength": 1
    },
    "plan_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    },
    "timezone": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    },
    "option_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    },
    "party_size": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "destination": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    },
    "service_date": {
      "type": "string",
      "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$"
    },
    "plan_revision": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    },
    "public_plan_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    },
    "source_item_id": {
      "type": "string",
      "pattern": "^[a-z0-9-]{1,80}$"
    },
    "caller_task_ref": {
      "type": "string",
      "maxLength": 240,
      "minLength": 1
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{8,128}$"
    },
    "service_language": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
    },
    "hotel_requirements": {
      "type": "object",
      "required": [],
      "properties": {
        "city": {
          "type": "string",
          "maxLength": 150,
          "minLength": 1
        },
        "checkin": {
          "type": "string",
          "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$"
        },
        "checkout": {
          "type": "string",
          "pattern": "^20[0-9]{2}-[0-9]{2}-[0-9]{2}$"
        },
        "currency": {
          "type": "string",
          "pattern": "^[A-Z]{3}$"
        },
        "hotel_name": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1
        },
        "occupancies": {
          "type": "array",
          "items": {
            "type": "object",
            "required": [
              "adults"
            ],
            "properties": {
              "adults": {
                "type": "integer",
                "maximum": 8,
                "minimum": 1
              },
              "children_ages": {
                "type": "array",
                "items": {
                  "type": "integer",
                  "maximum": 17,
                  "minimum": 0
                },
                "maxItems": 4
              }
            },
            "additionalProperties": false
          },
          "maxItems": 4,
          "minItems": 1
        },
        "country_code": {
          "type": "string",
          "pattern": "^[A-Z]{2}$"
        },
        "guest_nationality": {
          "type": "string",
          "pattern": "^[A-Z]{2}$"
        }
      },
      "additionalProperties": false
    },
    "capsule_handoff_ref": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    },
    "transport_requested": {
      "type": "boolean"
    },
    "public_plan_revision": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    },
    "hotel_query_parameters": {
      "type": [
        "object",
        "null"
      ]
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "title",
    "summary",
    "conditions",
    "sources",
    "language",
    "visibility",
    "request_id",
    "idempotency_key"
  ],
  "properties": {
    "title": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url",
          "label",
          "kind",
          "retrieved_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "maxLength": 2048,
            "minLength": 1
          },
          "kind": {
            "enum": [
              "official",
              "research",
              "user_report"
            ],
            "type": "string"
          },
          "label": {
            "type": "string",
            "maxLength": 240,
            "minLength": 1
          },
          "retrieved_at": {
            "type": "integer",
            "maximum": 9007199254740991,
            "minimum": 0
          }
        },
        "additionalProperties": false
      },
      "maxItems": 12
    },
    "summary": {
      "type": "string",
      "maxLength": 8000,
      "minLength": 1
    },
    "language": {
      "type": "string",
      "maxLength": 35,
      "minLength": 1
    },
    "conditions": {
      "type": "object",
      "required": [
        "region",
        "environment",
        "limitations"
      ],
      "properties": {
        "region": {
          "type": "string",
          "maxLength": 80,
          "minLength": 1
        },
        "environment": {
          "type": "string",
          "maxLength": 240,
          "minLength": 1
        },
        "limitations": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 800,
            "minLength": 1
          },
          "maxItems": 12
        }
      },
      "additionalProperties": false
    },
    "request_id": {
      "type": "string",
      "pattern": "^[a-z]+_[0-9a-f]{32}$",
      "maxLength": 64
    },
    "visibility": {
      "enum": [
        "private",
        "public"
      ],
      "type": "string"
    },
    "private_note": {
      "type": "string",
      "maxLength": 4000,
      "minLength": 0
    },
    "share_approved": {
      "type": "boolean"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{8,128}$"
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "allOf": [
    {
      "if": {
        "properties": {
          "record_kind": {
            "enum": [
              "actual",
              "demo"
            ]
          }
        }
      },
      "then": {
        "properties": {
          "occurred_at": {
            "type": "integer",
            "maximum": 9007199254740991,
            "minimum": 0
          }
        }
      }
    }
  ],
  "required": [
    "title",
    "summary",
    "conditions",
    "sources",
    "language",
    "visibility",
    "record_kind",
    "occurred_at",
    "idempotency_key"
  ],
  "properties": {
    "goal": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1
    },
    "title": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    },
    "result": {
      "type": "string",
      "maxLength": 4000,
      "minLength": 1
    },
    "actions": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 1200,
        "minLength": 1
      },
      "maxItems": 12
    },
    "sources": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url",
          "label",
          "kind",
          "retrieved_at"
        ],
        "properties": {
          "url": {
            "type": "string",
            "maxLength": 2048,
            "minLength": 1
          },
          "kind": {
            "enum": [
              "official",
              "research",
              "user_report"
            ],
            "type": "string"
          },
          "label": {
            "type": "string",
            "maxLength": 240,
            "minLength": 1
          },
          "retrieved_at": {
            "type": "integer",
            "maximum": 9007199254740991,
            "minimum": 0
          }
        },
        "additionalProperties": false
      },
      "maxItems": 12
    },
    "summary": {
      "type": "string",
      "maxLength": 8000,
      "minLength": 1
    },
    "language": {
      "type": "string",
      "maxLength": 35,
      "minLength": 1
    },
    "conditions": {
      "type": "object",
      "required": [
        "region",
        "environment",
        "limitations"
      ],
      "properties": {
        "region": {
          "type": "string",
          "maxLength": 80,
          "minLength": 1
        },
        "environment": {
          "type": "string",
          "maxLength": 240,
          "minLength": 1
        },
        "limitations": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 800,
            "minLength": 1
          },
          "maxItems": 12
        }
      },
      "additionalProperties": false
    },
    "visibility": {
      "enum": [
        "private",
        "public"
      ],
      "type": "string"
    },
    "occurred_at": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ]
    },
    "record_kind": {
      "enum": [
        "actual",
        "research",
        "demo"
      ],
      "type": "string"
    },
    "valid_until": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "private_note": {
      "type": "string",
      "maxLength": 4000,
      "minLength": 0
    },
    "outcome_state": {
      "enum": [
        "completed",
        "failed",
        "open_question"
      ],
      "type": "string"
    },
    "share_approved": {
      "type": "boolean"
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._:-]{8,128}$"
    }
  },
  "additionalProperties": false
}