{"version":"1","provider":{"name":"Rykloud","url":"https://rykloud.com","products":[{"name":"Rykloud","url":"https://rykloud.com","what":"The AI front office for small businesses: sites, inbox, customers, payments, files, environments"},{"name":"Rykon AI","url":"https://rykon.ai","what":"AI staff with rules, approvals and a record; MCP at https://mcp.rykon.ai/mcp (a person signs in)"},{"name":"Rykon Mail","url":"https://rykonmail.com","what":"Business email; its own API at https://app.rykonmail.com/api/v1 (keys made by a person)"}]},"agent_onboarding":{"url":"https://rykloud.com/agent-signup.md","format":"text/markdown","intended_for":["ai_agents","coding_assistants","autonomous_tools"]},"documentation":{"llms_txt":"https://rykloud.com/llms.txt","openapi":"https://api.rykloud.com/v1/public/openapi.json","reference":"https://rykloud.com/docs/api","start_page":"https://rykloud.com/agents","cli":"https://rykloud.com/help/command-line/install-the-cli"},"signup":{"type":"api_guided","browser_signup_url":"https://app.rykloud.com","api_base":"https://api.rykloud.com","entrypoints":[{"name":"agents.challenge","method":"POST","url":"https://api.rykloud.com/v1/agents/challenges","auth":"none","summary":"A challenge to solve (sign-up) and a proof of work (sign-up and delegation)"},{"name":"agents.signup","method":"POST","url":"https://api.rykloud.com/v1/agents/signups","auth":"none","summary":"Sign up: the answer, the proof of work, a mailbox you can read and the terms; a code is mailed"},{"name":"agents.signupResend","method":"POST","url":"https://api.rykloud.com/v1/agents/signups/{signupId}/resend","auth":"signup","summary":"A new code by mail (three at most, a minute apart)"},{"name":"agents.signupVerify","method":"POST","url":"https://api.rykloud.com/v1/agents/signups/{signupId}/verify","auth":"signup","summary":"The mailed code for your agent, its sandbox organisation, its first key (shown once) and the claim link"},{"name":"agents.delegationStart","method":"POST","url":"https://api.rykloud.com/v1/agents/delegations","auth":"none","summary":"Ask an existing person for a key that acts for them (device code: they approve one screen)"},{"name":"agents.delegationToken","method":"POST","url":"https://api.rykloud.com/v1/agents/delegations/token","auth":"none","summary":"Poll for the key: authorization_pending, slow_down, access_denied, expired_token, or the key once"},{"name":"agents.me","method":"GET","url":"https://api.rykloud.com/v1/agents/me","auth":"agent","summary":"Who this key is, who it acts for and what it may do"},{"name":"agents.claimLink","method":"POST","url":"https://api.rykloud.com/v1/agents/me/claim-link","auth":"agent","summary":"A fresh claim link to give your person (the last one stops working)"},{"name":"agents.sitePreview","method":"POST","url":"https://api.rykloud.com/v1/agents/me/sites/previews","auth":"agent","summary":"Compose a site from a template, never made: an hour's preview link"}],"challenge":{"kinds":["arithmetic","sequence","extract"],"answered_by":"reading: no solver needed","proof_of_work":"sha256(prefix + nonce) with the asked leading zero bits"},"email_verification":{"required":true,"how":"An 8 letter code is mailed. Send it with the signupSecret as the bearer: the mail alone is useless to anyone else, and opening the link spends nothing.","subject":"Your Rykloud agent sign-in code","no_mailbox":"Use delegation instead: your person approves one screen and you get a key that acts for them."},"terms":{"version":"2026-11-05","terms":"https://rykloud.com/terms","acceptable_use":"https://rykloud.com/acceptable-use","privacy":"https://rykloud.com/privacy","accept_with":"\"acceptTerms\": true and \"termsVersion\""},"sandbox":{"description":"Until a verified person claims it, a new agent works in a sandbox organisation of its own.","keys":3,"site_previews_per_day":10,"requests_per_minute":60,"claim_within_days":14,"never":["environments or anything paid","setting up products","inviting people","domains","billing","sending mail to anyone"],"allowed":["agents.me","agents.keys","agents.keyCreate","agents.keyRotate","agents.keyRevokeOwn","agents.claimLink","agents.siteTemplates","agents.sitePreview","organisations.list","organisations.get","organisations.checklist","organisations.connections","environments.catalogue","status.get","pricing.public"]},"claim":{"how":"Give your person the claim URL. They open it signed in to their Rykon account and claim you; the usual limits then apply (one free trial per verified person)."}},"delegation":{"type":"device_code","rfc":"RFC 8628","start":"https://api.rykloud.com/v1/agents/delegations","token":"https://api.rykloud.com/v1/agents/delegations/token","verification_uri":"https://app.rykloud.com/app/agents/approve","what_the_person_chooses":["organisation","read or write","expiry (90 days at most)","monthly spend cap","IP allow-list"]},"keys":{"format":"rka_ followed by 43 characters","header":"Authorization: Bearer rka_...","shown":"once","stored":"SHA-256 only","rotate":"https://api.rykloud.com/v1/agents/me/keys/{keyId}/rotate","revoke":"https://api.rykloud.com/v1/agents/me/keys/{keyId}/revoke","never_an_agent":["session.current","session.signOut","session.list","session.revoke","organisations.dismissNudge","organisations.restoreNudge","organisations.removeMember","organisations.invite","organisations.revokeInvitation","invitations.mine","invitations.accept","organisations.create","organisations.setRole","organisations.leave","organisations.resendInvitation","organisations.offerOwnership","organisations.cancelOwnershipOffer","organisations.ownershipOffers","organisations.acceptOwnership","organisations.declineOwnership","organisations.requestClosure","organisations.cancelClosure","organisations.closed","organisations.transferProduct","productTransfers.mine","productTransfers.get","productTransfers.accept","productTransfers.decline","productTransfers.withdraw","projects.grant","projects.revoke","projects.transfer","environments.destroy","environments.grant","environments.revoke","settings.vpnKey","settings.vpnRevoke","settings.restore","resources.credentials","secrets.reveal","notifications.list","notifications.read","notifications.preferences","notifications.setPreferences","terms.current","billing.limits","billing.setTeam","organisations.revokeMailGrant","terminal.setSettings","terminal.requestApproval","terminal.decideApproval","previews.setSetting","agents.list","agents.revoke","agents.keyRevoke","agents.keyUpdate","agents.keyActivity","agents.mine"],"within_spend_cap":["environments.approve","environments.approveUpdate","settings.apply","settings.linkAccept","changes.apply","changes.approve"]},"fast_path":{"description":"Try things now: no account, no key. Rate limited per address.","demo_endpoints":[{"name":"site_templates","method":"GET","url":"https://rykloud.com/api/agents/demo/templates","note":"The site template library with live demos; ?q= to search"},{"name":"ask_docs","method":"POST","url":"https://rykloud.com/api/agents/demo/ask","note":"A question about Rykloud answered from the help centre and API reference: {\"question\": \"...\"}"},{"name":"pricing","method":"GET","url":"https://api.rykloud.com/v1/public/pricing","note":"The public price list"},{"name":"openapi","method":"GET","url":"https://api.rykloud.com/v1/public/openapi.json","note":"The whole API"},{"name":"status","method":"GET","url":"https://api.rykloud.com/v1/status","note":"Is Rykloud up"}],"next_step":"For your own sandbox, follow https://rykloud.com/agent-signup.md"},"mcp":{"url":"https://api.rykloud.com/v1/public/agents/mcp","transport":"streamable-http (stateless JSON-RPC)","tools":["rykloud_signup_challenge","rykloud_signup_start","rykloud_signup_verify","rykloud_delegation_start","rykloud_delegation_poll","rykloud_whoami","rykloud_site_templates","rykloud_site_preview","rykloud_claim_link"]},"abuse":{"contact":"support@rykloud.com","rule":"Generous for real use, strict on abuse: limits by address, mailbox and mail domain; throwaway mailboxes refused."}}