HumanEndpoint
Human-only capabilities for AI agents: ground truth, verification, judgement and real-world action.
我該用這個嗎
品質與安全性
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"humanendpoint": {
"url": "https://humanendpoint.au/mcp"
}
}
}遠端端點
https://humanendpoint.au/mcpstreamable-http它能做什麼
工具清單
工具（10）
🟢human_list_services
Discover human capabilities for tasks software cannot complete alone: call a business, supplier or organisation; check current price, stock, lead time or availability by phone; obtain information that is only available by speaking to a person; verify a physical fact or location in the real world; independently review AI output; apply human judgement; perform bounded manual research; or carry out another lawful physical-world action. Results are structured and can include evidence. If no listed capability fits, use custom-human-task.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢human_policy_preflight(objective)
Check whether a proposed human task is eligible before requesting a quote or spending funds.
輸入結構描述
{
"type": "object",
"properties": {
"objective": {
"type": "string",
"minLength": 1,
"maxLength": 10000
}
},
"required": [
"objective"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡human_request_quote(service_slug, objective, deliverables, constraints, deadline_at, ...)
Submit a request for human-reviewed terms for a real-world task whose cost depends on scope, feasibility, urgency or conditions. This sends the request into a HumanEndpoint workflow for review by a human operator, but does not commit funds or start execution. HumanEndpoint returns commercial terms that can be accepted or declined before payment. Provide callback_url to receive signed quote.offered or quote.declined webhooks instead of relying only on polling. Suitable tasks include calling a business for current price, stock, lead time or availability; retrieving information only available by phone; verifying a real-world fact; checking AI output; applying human judgement; doing bounded research; or carrying out a physical-world task. If no named service matches, set service_slug to custom-human-task.
輸入結構描述
{
"type": "object",
"properties": {
"service_slug": {
"type": "string"
},
"objective": {
"type": "string",
"minLength": 1,
"maxLength": 10000
},
"deliverables": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string"
}
},
"constraints": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"deadline_at": {
"type": "string"
},
"max_budget_usdc": {
"type": "number",
"minimum": 0
},
"max_expenses_usdc": {
"type": "number",
"minimum": 0,
"maximum": 100000
},
"requester": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"callback_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"service_slug",
"objective",
"deliverables"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢human_get_quote(quote_id, quote_token)
Retrieve a human-reviewed quote. Polling is always available as a fallback even when the quote request supplied callback_url. When status=offered, inspect the operator's service fee, expense authority and expiry. Creating the job accepts those terms. When declined, inspect the reason before deciding whether to resubmit.
輸入結構描述
{
"type": "object",
"properties": {
"quote_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"quote_token": {
"type": "string",
"minLength": 16
}
},
"required": [
"quote_id",
"quote_token"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡human_create_job(quote_id, quote_token, idempotency_key, callback_url, requester)
Accept the human-reviewed commercial terms using the quote_token and create the asynchronous HumanEndpoint job. Creating the job starts a workflow that may lead to human execution in the real world after required payment. Store the returned job_token because it is required for later reads and control.
輸入結構描述
{
"type": "object",
"properties": {
"quote_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"quote_token": {
"type": "string",
"minLength": 16
},
"idempotency_key": {
"type": "string",
"minLength": 8,
"maxLength": 160
},
"callback_url": {
"type": "string",
"format": "uri"
},
"requester": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"quote_id",
"quote_token",
"idempotency_key"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢human_get_job(job_id, job_token)
Retrieve job status, messages, history, payment state, expense accounting, result and evidence.
輸入結構描述
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"job_token": {
"type": "string",
"minLength": 16
}
},
"required": [
"job_id",
"job_token"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢human_list_expenses(job_id, job_token)
List pass-through expense requests for a secured job, including exact amount, payment status and receipt metadata.
輸入結構描述
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"job_token": {
"type": "string",
"minLength": 16
}
},
"required": [
"job_id",
"job_token"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢human_list_evidence(job_id, job_token)
List evidence artifacts and SHA-256 hashes for a secured human job. Download paths require the same job token.
輸入結構描述
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"job_token": {
"type": "string",
"minLength": 16
}
},
"required": [
"job_id",
"job_token"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡human_reply_to_job(job_id, job_token, message)
Send additional information to the human operator working on the job, including when the job is waiting for agent input.
輸入結構描述
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"job_token": {
"type": "string",
"minLength": 16
},
"message": {
"type": "string",
"minLength": 1,
"maxLength": 10000
}
},
"required": [
"job_id",
"job_token",
"message"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴human_cancel_job(job_id, job_token, reason)
Cancel an unpaid HumanEndpoint job immediately, or request cancellation of human work that may already be underway and may require refund or operator handling.
輸入結構描述
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"job_token": {
"type": "string",
"minLength": 16
},
"reason": {
"type": "string",
"maxLength": 2000
}
},
"required": [
"job_id",
"job_token"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}社群
證據