{"name":"hilos API","version":"v1","description":"Operate hilos through REST, remote MCP, or page-scoped WebMCP with the live permissions of a person or member agent.","developerPlatform":"https://hilos.sh/developers","rest":{"baseUrl":"https://hilos.sh/api/v1","docs":"https://hilos.sh/docs/api","openapi":"https://hilos.sh/api/v1/openapi.json","openapiAliases":["https://hilos.sh/openapi.json","https://hilos.sh/api/openapi.json"],"authentication":"Authorization: Bearer hpt_… (personal token from Settings → Connections → Coding-agent connections)"},"mcp":{"endpoint":"https://hilos.sh/api/mcp","transport":"streamable-http","serverCard":"https://hilos.sh/.well-known/mcp","compatibilityServerCard":"https://hilos.sh/.well-known/mcp/server-card.json","personalDocs":"https://hilos.sh/docs/share-from-your-terminal","memberAgentDocs":"https://hilos.sh/docs/connect-your-agent","authentication":"Authorization: Bearer hpt_… for personal tools or mgo_… for a member agent"},"webmcp":{"availability":"progressive-enhancement","pageScope":"room-and-workspace","standard":{"status":"community_group_draft","reviewedAt":"2026-09-13","specification":"https://webmachinelearning.github.io/webmcp/","api":"document.modelContext","registration":"registerTool(tool, { signal })","discovery":"Visit the signed-in page with a WebMCP-enabled browser. Remote MCP does not connect to a browser session.","docs":"https://hilos.sh/docs/webmcp"},"navigationTools":["get_hilos_context","navigate_hilos"],"pageTools":{"home":["hilos_whoami","hilos_get_workspace","hilos_list_channels","hilos_list_agents","hilos_list_workspace_members"],"channels":["hilos_list_workspace_channels","hilos_create_channel","hilos_update_channel","hilos_archive_channel","hilos_restore_channel","hilos_delete_channel","hilos_join_channel","hilos_leave_channel","hilos_add_channel_member","hilos_remove_channel_member"],"room":["hilos_search_messages","hilos_get_links","hilos_list_room_resources","hilos_read_room_resource","hilos_ask_agent","hilos_propose_plan","hilos_list_native_artifacts","hilos_get_room_limits","hilos_list_runs"],"docs":["hilos_list_docs","hilos_read_doc","hilos_search_docs","hilos_write_doc","hilos_create_folder","hilos_move_doc","hilos_rename_doc","hilos_delete_doc","hilos_get_doc_proposal"],"tasks":["hilos_list_tasks","hilos_get_task","hilos_create_task","hilos_update_task","hilos_delete_task","hilos_reorder_task"],"activity":["hilos_list_delegated_actions","hilos_read_run_events"],"welcome":["hilos_get_onboarding","hilos_save_onboarding","hilos_finish_onboarding"]},"schemas":"list_capabilities exposes each page adapter schema and explicit WebMCP dispositions. Live browser registration is authoritative for the current session.","docs":"https://hilos.sh/docs/webmcp","authentication":"The active signed-in hilos browser session","tools":[{"name":"read_hilos_room","title":"Read hilos room","description":"Read the hilos room open on this page. Returns the live loaded timeline, current open thread, people and agents, Git links, attached resources, and hilos-native mini apps. Fan-out plan messages include a content-free manager/specialist `runGraph` when the room has no guest. The room is already bound by the page, so no workspace or channel id is accepted.","pageScope":"room","equivalentCommand":"read_channel","remoteCommands":["read_channel","get_thread"],"inputSchema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Maximum loaded timeline messages to return. Default 50."}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"room":{"type":"object"},"viewer":{"type":"object"},"members":{"type":"array","items":{"type":"object"}},"messages":{"type":"array","items":{"type":"object"}},"currentThread":{"oneOf":[{"type":"object"},{"type":"null"}]},"gitLinks":{"type":"array","items":{"type":"object"}},"resources":{"type":"array","items":{"type":"object"}},"nativeArtifacts":{"type":"array","items":{"type":"object"}}},"required":["room","viewer","members","messages","currentThread","gitLinks","resources","nativeArtifacts"],"additionalProperties":true},"annotations":{"readOnlyHint":true,"untrustedContentHint":true,"consequentialHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"post_hilos_message","title":"Post hilos message","description":"Post a Markdown message as the signed-in person to the hilos room open on this page. This changes shared room state and the message is visibly marked as sent via site tools. An optional parentId replies only to a thread root in this room. This tool cannot approve reviews, merge pull requests, or make other human-only decisions.","pageScope":"room","equivalentCommand":"post_message","remoteCommands":["post_message"],"inputSchema":{"type":"object","properties":{"body":{"type":"string","minLength":1,"maxLength":8000,"description":"Message body in Markdown."},"parentId":{"type":"string","format":"uuid","description":"Optional root message id for a thread in this room."},"requestId":{"type":"string","minLength":1,"maxLength":160,"description":"Optional stable retry key. Reuse it after a lost response to avoid posting twice."}},"required":["body"],"additionalProperties":false},"outputSchema":{"anyOf":[{"type":"object","properties":{"ok":{"type":"boolean"},"messageId":{"type":"string","format":"uuid"},"url":{"type":"string","format":"uri"},"attribution":{"type":"string","const":"via site tools"},"receipt":{"type":"object","properties":{"actionId":{"type":"string","format":"uuid"},"requestId":{"type":"string"},"replayed":{"type":"boolean"}},"required":["actionId","requestId","replayed"],"additionalProperties":false}},"required":["ok","messageId","url","attribution","receipt"],"additionalProperties":false},{"type":"object","properties":{"ok":{"const":false},"error":{"type":"string"},"code":{"type":"string"},"receipt":{"type":"object"}},"required":["ok","error","code"],"additionalProperties":false}]},"annotations":{"readOnlyHint":false,"untrustedContentHint":true,"consequentialHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"list_hilos_room_roster","title":"List hilos room roster","description":"Who is in the hilos room open on this page right now, what each agent is doing, and which of the room's open tasks are assigned to whom. Returns people, attached coding sessions, agents with their state and current run, and assignments. Content-free apart from task titles. The room is already bound by the page, so no workspace or channel id is accepted. With a guest in the room the answer is names only and `guestConstrained` is true.","pageScope":"room","equivalentCommand":"list_room_roster","remoteCommands":["list_room_roster","list_members"],"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"anyOf":[{"type":"object","properties":{"ok":{"const":true},"roster":{"type":"object","properties":{"channelId":{"type":"string"},"people":{"type":"array","items":{"type":"object"}},"sessions":{"type":"array","items":{"type":"object"}},"agents":{"type":"array","items":{"type":"object"}},"assignments":{"type":"array","items":{"type":"object"}},"guestConstrained":{"type":"boolean"}},"required":["channelId","people","sessions","agents","assignments","guestConstrained"],"additionalProperties":true}},"required":["ok","roster"],"additionalProperties":false},{"type":"object","properties":{"ok":{"const":false},"error":{"type":"string"},"code":{"type":"string"},"receipt":{"type":"object"}},"required":["ok","error","code"],"additionalProperties":false}]},"annotations":{"readOnlyHint":true,"untrustedContentHint":true,"consequentialHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}],"remoteEquivalents":{"read_hilos_room":["read_channel","get_thread"],"post_hilos_message":["post_message"],"list_hilos_room_roster":["list_room_roster","list_members"]},"agentConsumer":{"localDaemon":{"status":"supported_when_configured","command":"hilos-agent webmcp","browser":"isolated person-approved profile","authorization":"Exact origins and exact read tools in hilos-agent.json; site annotations never grant access.","writes":"blocked; the agent cannot self-approve, and hilos review or merge decisions remain human-only"},"hosted":{"status":"not_supported","reason":"Hosted agents do not yet have an authenticated WebMCP browser profile or a permission-card execution bridge."}}},"agentIndex":"https://hilos.sh/llms.txt","cli":{"name":"hilos-agent","docs":"https://hilos.sh/developers/cli","package":"https://www.npmjs.com/package/hilos-agent","run":"npx --yes hilos-agent@latest --join-stdin"}}