{"name":"Humonix Hue","description":"Hue, the agent of a company’s Humonix workspace: hire it for results, not screens. It answers from the company’s records, and turns work (customer answers, invoice chasing, quotes, dispatch, research, ads changes) into drafts a person approves; a task stays open until a result exists, then completes with a structured result (outcome, summary, evidence, value, cost, next). The company is always your credential’s; nothing is sent, paid or published without a person.","supportedInterfaces":[{"url":"https://humonix-hq.fly.dev/api/a2a","protocolBinding":"JSONRPC","protocolVersion":"1.0"},{"url":"https://humonix-hq.fly.dev/api/a2a","protocolBinding":"JSONRPC","protocolVersion":"0.3"}],"provider":{"organization":"Humonix","url":"https://humonix.com"},"version":"1.0.0","documentationUrl":"https://humonix.com/mcp#a2a","capabilities":{"streaming":true,"pushNotifications":true,"extendedAgentCard":true,"extensions":[{"uri":"https://humonix.com/a2a/ext/result/v1","description":"Every finished task carries an artifact named \"result\": the Humonix result schema (outcome, summary, evidence, value, cost, next), the same as GET /api/v1/results and the MCP tool results_recent.","required":false},{"uri":"https://humonix.com/a2a/ext/platform-version/v1","description":"The Humonix platform version serving this agent (semver + build sha); the changelog names it.","required":false,"params":{"platform_version":"0.1.0+dev","version":"0.1.0","sha":"dev"}}]},"securitySchemes":{"companyKey":{"httpAuthSecurityScheme":{"scheme":"Bearer","bearerFormat":"hxc_…","description":"A company API key an owner makes in the app (Developers). Key scopes: read:tools (or read:*) for reads, use:hue for Ask Hue, write:proposals for drafts. It acts with the role of the person who made it."}},"oauth":{"oauth2SecurityScheme":{"description":"OAuth 2.1 with PKCE (S256) and dynamic client registration: the same sign-in as the MCP server. A person of the company signs in and grants scopes.","flows":{"authorizationCode":{"authorizationUrl":"https://humonix-hq.fly.dev/api/mcp/authorize","tokenUrl":"https://humonix-hq.fly.dev/api/mcp/token","refreshUrl":"https://humonix-hq.fly.dev/api/mcp/token","pkceRequired":true,"scopes":{"data:read":"Read the company’s records and Desks","hue:chat":"Ask Hue (model tokens)","desks:propose":"Add drafts to approval queues, and make reversible changes on the ledger (owners only)"}}},"oauth2MetadataUrl":"https://humonix-hq.fly.dev/.well-known/oauth-authorization-server"}}},"securityRequirements":[{"schemes":{"companyKey":{"list":[]}}},{"schemes":{"oauth":{"list":["data:read"]}}}],"defaultInputModes":["text/plain","application/json"],"defaultOutputModes":["application/json","text/plain"],"skills":[{"id":"ask_hue","name":"Answer a question about the business","description":"Hue answers from the company’s own records (Desks, invoices, jobs, quotes, stock…) within the caller’s role. Answered in the call. Tool: ask_hue (read).","tags":["questions","business","desks"],"examples":["What is late today?","Which invoices should we call about first?"],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[{"schemes":{"companyKey":{"list":[]}}},{"schemes":{"oauth":{"list":["hue:chat"]}}}]},{"id":"answer_customer","name":"Answer a customer’s question","description":"Files the customer’s question at the company’s desk: Hue finds the facts and drafts the answer; a person approves it (or writes it). The task stays open (input-required while a person must act) and completes with the approved answer, ready for you to deliver. Tool: file_desk_request (propose, role needs inbox:create).","tags":["customer service","desk","approval"],"examples":["Can you send me a copy of invoice INV-2026-0042?","{\"text\": \"Is my technician still coming today?\", \"customer\": {\"name\": \"Pat Lake\", \"email\": \"pat@example.com\"}}"],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[{"schemes":{"companyKey":{"list":[]}}},{"schemes":{"oauth":{"list":["desks:propose"]}}}]},{"id":"qualify_inbound","name":"Qualify an inbound lead","description":"Classifies an inbound message (intent, domain, priority, SLA) and routes it to the right person; a quote or a visit request counts as a qualified lead. Completes when the team has answered; a booked visit counts as a meeting booked. Tool: file_desk_request (propose, role needs inbox:create).","tags":["leads","qualification","inbound"],"examples":["{\"text\": \"We need a quote for 3 rooftop units in Laval\", \"customer\": {\"company\": \"Harbour Inn\", \"email\": \"ops@harbour.example\"}}"],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[{"schemes":{"companyKey":{"list":[]}}},{"schemes":{"oauth":{"list":["desks:propose"]}}}]},{"id":"chase_overdue_invoices","name":"Chase overdue invoices","description":"Drafts the payment reminders due today under the company’s reminder plan; an owner approves or skips each. Completes when every reminder is decided, with the amount chased. Tool: propose_invoice_reminders (propose, role needs invoices:edit).","tags":["invoices","collections","approval"],"examples":["Chase what is overdue before month end."],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[{"schemes":{"companyKey":{"list":[]}}},{"schemes":{"oauth":{"list":["desks:propose"]}}}]},{"id":"draft_quote","name":"Draft a quote","description":"Prices items from the company’s price book and saves a quote that waits for an owner’s approval. Completes when it is approved (with its number, total and link) or declined. Tool: propose_quote (propose, role needs quotes:create).","tags":["quotes","pricing","approval"],"examples":["{\"account\": \"Harbour Inn\", \"items\": [{\"sku\": \"RTU-5T\", \"qty\": 3}], \"location\": \"H7T 1C8\"}"],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[{"schemes":{"companyKey":{"list":[]}}},{"schemes":{"oauth":{"list":["desks:propose"]}}}]},{"id":"dispatch_proposal","name":"Propose a day’s dispatch","description":"Hue assigns the open jobs of one day to technicians; a dispatcher approves or declines each line. Completes when every line is decided, with the jobs scheduled. Tool: propose_dispatch (propose, role needs jobs:approve).","tags":["jobs","dispatch","scheduling","approval"],"examples":["{\"day\": \"2026-11-16\"}"],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[{"schemes":{"companyKey":{"list":[]}}},{"schemes":{"oauth":{"list":["desks:propose"]}}}]},{"id":"research","name":"Research job","description":"An account deep-dive, competitor scan, market map, role research, site audit or custom brief. An owner approves the budget (billed at the provider’s list price); completes when the report is accepted, with the report and its sources. Tool: propose_research_job (propose, role needs research:create).","tags":["research","accounts","markets"],"examples":["{\"kind\": \"competitors\", \"inputs\": {\"account\": \"Harbour Inn\", \"domain\": \"harbour.example\"}}"],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[{"schemes":{"companyKey":{"list":[]}}},{"schemes":{"oauth":{"list":["desks:propose"]}}}]},{"id":"ads_proposal","name":"Propose an ads change","description":"One change to the company’s ads (pause, budget, bid, launch, refresh, new campaign), checked against the owner’s caps; an owner decides. Completes when applied or dismissed. Tool: propose_ads_change (propose, role needs ads:create).","tags":["ads","budget","approval"],"examples":["{\"kind\": \"pause_variant\", \"target\": \"v-123\", \"why\": \"CPL 3x the campaign average\"}"],"inputModes":["text/plain","application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[{"schemes":{"companyKey":{"list":[]}}},{"schemes":{"oauth":{"list":["desks:propose"]}}}]},{"id":"order_status","name":"Online order status","description":"Shipping status, tracking and timeline of one online order. For a customer, pass the email or phone they gave: details come back only when it matches the order. Answered in the call. Tool: order_status (read, role needs shop:view).","tags":["orders","e-commerce","shipping"],"examples":["{\"number\": \"#1042\", \"customer_email\": \"pat@example.com\"}"],"inputModes":["application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[{"schemes":{"companyKey":{"list":[]}}},{"schemes":{"oauth":{"list":["data:read"]}}}]},{"id":"run_tool","name":"Run any Humonix tool","description":"Any tool of the public catalog (GET /api/v1/tools) by name, with its arguments: send a data part {\"tool\": \"<name>\", \"arguments\": {…}}. Reads answer in the call; a proposal is tracked like the skills above when Humonix can follow it, otherwise it completes with outcome needs_approval and where to approve it.","tags":["tools","headless"],"examples":["{\"tool\": \"invoices_overdue\", \"arguments\": {\"limit\": 5}}"],"inputModes":["application/json"],"outputModes":["application/json","text/plain"],"securityRequirements":[{"schemes":{"companyKey":{"list":[]}}},{"schemes":{"oauth":{"list":["data:read"]}}}]}]}