{"schema_version":"yarrow.agent-capabilities.v1","canonical_origin":"https://yarrow.to","guide_url":"/agents","llms_url":"/llms.txt","openapi_url":"/api/agents/openapi.json","availability_semantics":"Configured support, not a live health check. Individual requests may fail or lack a readable body.","capabilities":{"future_archive":{"status":"available","enrollment_enabled":true,"endpoint":"/mcp","dedicated_endpoint":"/mcp/future","protocol_url":"/api/agents/future-archive-protocol","resource_metadata_url":"/.well-known/oauth-protected-resource/mcp","tools":["list_archive_topics","get_archive_topic","list_archive_records","get_archive_record","save_archive_topic","save_archive_record","list_archive_revisions","get_archive_revision"],"authentication":"Use the existing Yarrow Streamable HTTP MCP connector. The host handles human approval of additional Future scopes through OAuth authorization code and S256 PKCE. Default reading grants do not gain these scopes. Never ask the person to paste a token into chat.","scopes":["connection:read","future:archive:read","future:archive:write"],"publication_scopes":["connection:read","future:archive:read","future:archive:write","future:archive:publish"],"authority":"Read all of the owner's archive topics and notes, including private ones; create and edit private records. Public changes require a separate publication grant and the person's instruction for that exact change."},"public_reading":{"status":"available","authentication":"none","entry_url":"/agents"},"reading_curator":{"status":"available","authentication":"none","tools":["find_books_by_taste","sample_passage"],"endpoints":["/api/agents/taste","/api/agents/sample"],"skill_url":"/skills/yarrow-curator/SKILL.md","ranking":"Exact subject/title tokens; default published Archive bodies; optional verified full-Catalog book index.","unavailable_index":"503, never zero results","tags_available":false},"catalog_search":{"status":"available","authentication":"none","endpoint":"/api/catalog/search","pagination":{"all":"page","readable_only":"next_cursor"}},"public_exploration":{"status":"available","authentication":"none","stability":"experimental","base_url":"/api/experiments/feed/explore","operations":["GET /bootstrap","POST /images","POST /passages"],"mcp_tools":["explore"],"references":"Copy catalog-passage and catalog-image refs unchanged. MCP tools build request IDs and never accept URLs.","personal_records":"Pins and saved pairs are not MCP tools. Account records belong to the signed-in person; agent credentials are not accepted on those paths. Records kept only in a browser are not reachable."},"agent_connection":{"status":"available","enrollment_enabled":true,"agent_access_enabled":true,"management_enabled":true,"start_url":"/api/agent-connections/requests","protocol_url":"/api/agents/connection-protocol","approval":"human browser approval with existing Google login","scopes":["connection:read"],"management_url":"/agents/connections"},"conversational_enrollment":{"status":"unsupported","methods":[],"reason":"Verified approval and identity transfer from an external agent conversation is not implemented."},"webmcp":{"status":"unsupported","reason":"No browser tools are registered."},"remote_mcp":{"status":"available","endpoint":"/mcp","authentication":"Public reading and connection(action=capabilities) need no authentication. Private Kept and Future tools use OAuth authorization code with S256 PKCE. Future requires additional human-approved archive scopes on the same connection; publication is separate. The host manages tokens","tools":["books","worlds","stories","open_story_episode","explore","kept_write","kept","connection","set_profile","stories_write","worlds_write","comments_write","archive","archive_write"],"scopes":["connection:read","kept:read","kept:write"],"enrollment_enabled":true,"resource_metadata_url":"/.well-known/oauth-protected-resource/mcp","management_url":"/agents/connections"},"rights_negotiation":{"status":"unsupported","reason":"No rights agreement or payment tools are available."}},"next_steps":[{"action":"search","url":"/api/catalog/search?q=Melville&limit=10&page=1"},{"action":"follow_result","url_template":"/work/{work_id}","instruction":"Follow only reading and source links returned for the selected record."},{"action":"cite","endpoint":"/api/agents/citation","instruction":"Cite through a paragraph citation_action (this endpoint, or MCP get_citation). Quote the returned text exactly and give people reader_url, which opens the Reader at that text, highlighted. quote_not_found means the words are not in the book. Retain Work/Edition identity, author, language, source and locator. Reading access is not reuse permission."}]}