{"openapi":"3.2.1","info":{"title":"UnblockAgents API","version":"1.0.0","description":"Anonymous US pilot intake for manual review. No payment or fulfillment guarantee. Do not submit secrets or medical intake."},"servers":[{"url":"https://unblockagents.com"}],"security":[],"paths":{"/mcp":{"post":{"operationId":"mcpMessage","summary":"Remote MCP Streamable HTTP endpoint","description":"Stateless JSON-RPC endpoint for get_capabilities, list_services, submit_request, get_request_status and open_request_form. The optional MCP Apps HTML resource at ui://unblockagents/request-form opens the human form in compatible hosts; non-UI clients receive a URL. Opening the form never submits a request. No approved fixed-price offers or referral bookings exist yet. The same pilot limits and manual-review rules apply.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"MCP JSON-RPC response (JSON or event stream depending on protocol version)","content":{"application/json":{"schema":{"type":"object"}},"text/event-stream":{"schema":{"type":"string"}}}},"403":{"description":"Origin or host rejected","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Unsupported media type","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/offers":{"get":{"operationId":"listOffers","summary":"List agency-approved fixed-price offers","description":"Only approved, available offers appear here. No partner offers or referral submission are active yet. Generic intake does not book or quote a service.","responses":{"200":{"description":"Current fixed-price offer catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferCatalog"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/capabilities":{"get":{"operationId":"getCapabilities","summary":"Discover service availability","responses":{"200":{"description":"Capabilities","content":{"application/json":{"schema":{"type":"object"},"example":{"name":"UnblockAgents","description":"Human help for AI agents blocked by physical tasks, phone calls or offline information.","stage":"pilot","geographic_availability":["US"],"accepting_requests":true,"review":"Manual review; no guaranteed fulfillment or response time.","authentication":"Anonymous; no API key required.","source_type":"Self-reported, not verified agent identity.","request_kinds":{"work_request":"Ask for manual review of a currently piloted nonclinical task.","information":"Ask a question about a nonclinical service before requesting work.","future_service":"Register interest in a nonclinical service that is not currently offered; this is not a booking or waitlist guarantee."},"inquiry_contact":"Information and future-service inquiries require a reply email; status links do not carry an answer.","services":[{"id":"real_world_help","availability":"pilot","examples":["Physical visits with permission","Calls to businesses","Offline information","Local service quotes"]},{"id":"business_call","availability":"pilot","accepting_intake":true,"geographic_eligibility":["US"],"local_coverage":"unconfirmed_until_manual_review","same_day_availability":"unknown","response_time_target":null,"fulfillment_guaranteed":false,"price_status":"not_quoted","payment_collected_on_submission":false,"submission_creates_commitment":false,"result_delivery":{"status_api_includes_result":false,"callbacks_sent":false,"contact_email_recommended":true,"contact_email_needed_for_manual_answer":true,"method":"manual_follow_up_if_contact_email_provided"},"example_request":{"summary":"Call a Spokane store about an item","blocker":"The store does not publish current stock online.","desired_outcome":"Ask whether the specified item is in stock today. Do not reserve or purchase it.","source_type":"agent","authorized":true,"category":"business_call","country":"US","location":"Spokane, WA","timing":"Today, if available","agent":{"name":"Example assistant"},"contact":{"email":"user@example.com"},"additional_information":"Example store: Example Shop; item: replacement filter ABC-123; public phone: 202-555-0140."}},{"id":"doctor_consult","availability":"under_study","accepting_intake":false,"pricing":"If launched, a $1 UnblockAgents handling fee is planned on top of a provider-confirmed consultation price. No patient quote or checkout exists today.","callback_phone_collection":false}],"fixed_price_offers":{"accepting_referrals":false,"available_count":0,"catalog_url":"https://unblockagents.com/api/v1/offers"},"restrictions":["No illegal or unauthorized tasks","No emergencies","No medical intake","No passwords, keys, tokens, payment details, SSNs, ID images or medical records"],"budget":"Optional customer spending ceiling in USD cents, with no service-imposed minimum or maximum bid. Omit it if the customer has not set a ceiling. It is not a quote, payment or proof of funds.","callbacks":"Stored as contact information only; never fetched or delivered in v1.","current_capabilities":["request_intake","nonclinical_service_interest","manual_review","status_polling"],"planned_capabilities":["quoting","provider_coordination","payments"],"protocols":{"rest":true,"a2a":false,"mcp":true,"mcp_apps":true},"links":{"agents":"https://unblockagents.com/agents","business_calls":"https://unblockagents.com/business-calls","consults":"https://unblockagents.com/consults","progress":"https://unblockagents.com/progress.json","openapi":"https://unblockagents.com/openapi.json","offers":"https://unblockagents.com/api/v1/offers","create":"https://unblockagents.com/api/v1/requests","mcp":"https://unblockagents.com/mcp","mcp_app_resource":"ui://unblockagents/request-form"},"example":{"summary":"Check an item at a Spokane store","blocker":"The store does not publish current stock online.","desired_outcome":"Ask a person to check stock and photograph the packaging with permission.","source_type":"agent","authorized":true,"category":"physical_visit","country":"US","location":"Spokane, WA","agent":{"name":"Example assistant"},"contact":{"email":"user@example.com"}}}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/requests":{"post":{"operationId":"createRequest","summary":"Submit a real-world blocker for manual review","description":"Maximum body 24,576 bytes. Metadata maximum 2,048 characters. For information or future_service inquiries about nonclinical services, provide contact.email for a reply. Idempotency-Key is optional; if used, generate a private random key with at least 128 bits of entropy at submission time. Same normalized payload and key replay the receipt for 24 hours; a different payload returns 409. After 24 hours key reuse can create a new request. No callbacks are invoked. Medical categories are unavailable. For business calls, include the store and exact item; intake does not guarantee a same-day response, collect payment, or commit to the job.","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{32,128}$"},"description":"Optional private retry key; generate a random UUID or 32 random bytes in hex at submission time. Omit it if you cannot generate a cryptographically random key."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Request"},"example":{"summary":"Call a Spokane store about an item","blocker":"The store does not publish current stock online.","desired_outcome":"Ask whether the specified item is in stock today. Do not reserve or purchase it.","source_type":"agent","authorized":true,"category":"business_call","country":"US","location":"Spokane, WA","timing":"Today, if available","agent":{"name":"Example assistant"},"contact":{"email":"user@example.com"},"additional_information":"Example store: Example Shop; item: replacement filter ABC-123; public phone: 202-555-0140."}}}},"responses":{"200":{"description":"Idempotent replay","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Receipt"}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Receipt"}}}},"400":{"description":"Invalid JSON or key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Cross-site submission rejected","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Key already used with different data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Body too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Unsupported media type or encoding","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation failed or service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited or daily pilot capacity reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until retry"}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Intake paused","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/status/{tracking_token}":{"get":{"operationId":"getRequestStatus","summary":"Read sparse status using a private bearer URL","description":"Poll no more frequently than once per minute. Do not share the token or URL. No original request content or completed-task answer is returned. Supply a contact email if manual follow-up is needed.","parameters":[{"name":"tracking_token","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}],"responses":{"200":{"description":"Current status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Status"}}}},"404":{"description":"Unknown or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Request":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"summary":{"type":"string","minLength":5,"maxLength":200},"blocker":{"type":"string","minLength":10,"maxLength":4000},"desired_outcome":{"type":"string","minLength":10,"maxLength":4000},"source_type":{"type":"string","enum":["agent","human"]},"authorized":{"type":"boolean","const":true},"request_kind":{"type":"string","enum":["work_request","information","future_service"]},"category":{"default":"other","type":"string","minLength":1,"maxLength":80},"country":{"default":"US","type":"string","const":"US"},"location":{"type":"string","minLength":1,"maxLength":300},"deadline":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"timing":{"type":"string","minLength":1,"maxLength":300},"budget":{"type":"object","properties":{"max_minor":{"type":"integer","minimum":0,"maximum":9007199254740991},"currency":{"default":"USD","type":"string","const":"USD"}},"required":["max_minor"],"additionalProperties":false},"agent":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"version":{"type":"string","minLength":1,"maxLength":80},"platform":{"type":"string","minLength":1,"maxLength":120}},"additionalProperties":false},"contact":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"callback_url":{"type":"string","maxLength":1000,"format":"uri"}},"additionalProperties":false},"additional_information":{"type":"string","minLength":1,"maxLength":4000},"metadata":{"type":"object","propertyNames":{"type":"string","maxLength":80},"additionalProperties":{"anyOf":[{"type":"string","maxLength":500},{"type":"number"},{"type":"boolean"},{"type":"null"}]}}},"required":["summary","blocker","desired_outcome","source_type","authorized"],"additionalProperties":false},"Receipt":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"request_id":{"type":"string"},"status":{"type":"string","enum":["received","reviewing","needs_information","quoted","accepted","in_progress","completed","declined","canceled"]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"status_url":{"type":"string","format":"uri"},"message":{"type":"string"}},"required":["request_id","status","created_at","status_url","message"]},"Status":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"request_id":{"type":"string"},"status":{"type":"string","enum":["received","reviewing","needs_information","quoted","accepted","in_progress","completed","declined","canceled"]},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"updated_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"message":{"type":"string"}},"required":["request_id","status","created_at","updated_at","message"]},"Error":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"fields":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"string"}}},"correlation_id":{"type":"string"}},"required":["code","message","fields","correlation_id"]}},"required":["error"]},"Offer":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{2,79}$"},"title":{"type":"string","minLength":1,"maxLength":160},"provider":{"type":"string","minLength":1,"maxLength":160},"description":{"type":"string","minLength":1,"maxLength":1000},"price":{"type":"object","properties":{"amount_minor":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"currency":{"type":"string","const":"USD"}},"required":["amount_minor","currency"],"additionalProperties":false},"service_area":{"type":"object","properties":{"country":{"type":"string","const":"US"},"regions":{"minItems":1,"type":"array","items":{"type":"string","minLength":2,"maxLength":80}}},"required":["country","regions"],"additionalProperties":false},"required_inputs":{"type":"array","items":{"type":"string","minLength":1,"maxLength":160}},"exclusions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":300}},"price_valid_until":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","title","provider","description","price","service_area","required_inputs","exclusions","price_valid_until"],"additionalProperties":false},"OfferCatalog":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"accepting_referrals":{"type":"boolean"},"offers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","pattern":"^[a-z0-9][a-z0-9_-]{2,79}$"},"title":{"type":"string","minLength":1,"maxLength":160},"provider":{"type":"string","minLength":1,"maxLength":160},"description":{"type":"string","minLength":1,"maxLength":1000},"price":{"type":"object","properties":{"amount_minor":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"currency":{"type":"string","const":"USD"}},"required":["amount_minor","currency"],"additionalProperties":false},"service_area":{"type":"object","properties":{"country":{"type":"string","const":"US"},"regions":{"minItems":1,"type":"array","items":{"type":"string","minLength":2,"maxLength":80}}},"required":["country","regions"],"additionalProperties":false},"required_inputs":{"type":"array","items":{"type":"string","minLength":1,"maxLength":160}},"exclusions":{"type":"array","items":{"type":"string","minLength":1,"maxLength":300}},"price_valid_until":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","title","provider","description","price","service_area","required_inputs","exclusions","price_valid_until"],"additionalProperties":false}},"message":{"type":"string"}},"required":["accepting_referrals","offers","message"],"additionalProperties":false}}}}