{"name":"Hyperion","description":"Agent-friendly curation API for Hyperion unread posts, tags, read state, and HiveSigner vote links.","authentication":{"type":"session_cookie","login_url":"https://www.hyperion.zone/sessions/new","auth_challenge_url":"https://www.hyperion.zone/api/v1/agent/auth_challenges","cookie_name":"_hyperion","instructions":["If you do not already have a Hyperion session cookie, POST /api/v1/agent/auth_challenges before any authenticated call.","Persist cookies from the challenge response and reuse the same cookie jar when redeeming.","For HiveSigner, show hivesigner_login_url to the user and ask them to complete HiveSigner privately in their own browser.","Only ask the user to paste the displayed HYP-* code. Never ask for or accept Hive private keys, HiveSigner passwords, or signing credentials.","POST the pasted code to /api/v1/agent/auth_challenges/{challenge_id}/redeem.","After redeem succeeds, use the _hyperion cookie for HTTP API and MCP requests.","Do not ask the user for Hive private keys. Hyperion only creates HiveSigner vote links; it does not broadcast votes server-side."],"credential_handling":{"agent_must_never_request":["Hive private key","HiveSigner password","posting key","active key","owner key","memo key","signing credential"],"user_only_pastes_to_agent":"HYP-* one-time Hyperion code","user_prompt":"Please open this HiveSigner link in your browser and complete the login there. Do not paste any Hive key, password, or signing credential into this chat. When Hyperion shows a code beginning with HYP-, paste only that code here.","if_hivesigner_requests_credentials":"The user may complete HiveSigner in their own browser, but must never paste keys or passwords into the agent.","agent_role":"Open or present hivesigner_login_url, wait for the user to finish privately, then redeem only the HYP-* code."},"hivesigner_flow":{"start":"POST /api/v1/agent/auth_challenges","user_action":"Open hivesigner_login_url, complete HiveSigner privately in your browser, then copy only the displayed HYP-* code.","redeem":"POST /api/v1/agent/auth_challenges/{challenge_id}/redeem with {\"code\":\"HYP-ABC123\"} using the same cookie jar.","result":"The redeem response sets the _hyperion session cookie.","user_prompt":"Please open this HiveSigner link in your browser and complete the login there. Do not paste any Hive key, password, or signing credential into this chat. When Hyperion shows a code beginning with HYP-, paste only that code here.","credential_handling":"The agent must never ask for or receive Hive private keys, HiveSigner passwords, or signing credentials."},"keychain_flow":{"start":"POST /api/v1/agent/auth_challenges","sign":"Ask Hive Keychain to sign keychain.message with Posting authority.","submit":"POST /api/v1/agent/auth_challenges/{challenge_id}/keychain with account_name, public_key, digest, and signature.","result":"The keychain response sets the _hyperion session cookie."}},"links":{"llms_txt":"https://www.hyperion.zone/llms.txt","openapi":"https://www.hyperion.zone/openapi.json","mcp":"https://www.hyperion.zone/mcp","agent_session":"https://www.hyperion.zone/api/v1/agent/session","agent_digest":"https://www.hyperion.zone/api/v1/agent/digest"},"capabilities":["auth_challenge","session","digest","post","vote_link","mark_read","ignore_tags","unignore_tags","mcp"],"recommended_agent_flow":["GET /.well-known/hyperion-agent.json","GET /api/v1/agent/session","If authenticated is false, run the auth challenge flow.","During auth, ask for only the HYP-* code; never ask for Hive private keys or HiveSigner credentials.","GET /api/v1/agent/digest?limit=10","Present interesting posts and HiveSigner vote links to the user.","Use POST /api/v1/agent/read only after the user asks to mark posts read.","Use POST or DELETE /api/v1/agent/ignored_tags only after the user asks to change ignored tags."],"examples":{"create_auth_challenge":{"method":"POST","url":"https://www.hyperion.zone/api/v1/agent/auth_challenges","store_cookies":true},"redeem_hivesigner_code":{"method":"POST","url":"https://www.hyperion.zone/api/v1/agent/auth_challenges/:challenge_id/redeem","headers":{"Content-Type":"application/json"},"body":{"code":"HYP-ABC123"},"reuse_challenge_cookies":true},"get_digest":{"method":"GET","url":"https://www.hyperion.zone/api/v1/agent/digest?limit=10","send_session_cookie":true},"mcp_tool_call":{"method":"POST","url":"https://www.hyperion.zone/mcp","headers":{"Content-Type":"application/json","MCP-Protocol-Version":"2025-06-18"},"body":{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"hyperion_get_digest","arguments":{"limit":10}}},"send_session_cookie":true}}}