HumanEndpoint
Human-only capabilities for AI agents: ground truth, verification, judgement and real-world action.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`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"
}커뮤니티
증거