{"service":"nexus-scout","description":"Read-only Cypher gateway to the Pubky social graph.","start_here":"https://nexus-scout.pubky.app/llms.txt","links":{"guide":"https://nexus-scout.pubky.app/llms.txt","schema":"https://nexus-scout.pubky.app/v1/schema"},"endpoints":{"GET /v1/query":"Run read-only Cypher via the query string. Same operation as the POST, for callers that cannot send a body.","POST /v1/query":"Run read-only Cypher.","GET /v1/schema":"Node labels, relationship types, and example queries.","GET /llms.txt":"Usage guide: recipes, limits, and error recovery."},"example_request":{"method":"POST","path":"/v1/query","headers":{"content-type":"application/json"},"body":{"cypher":"MATCH (u:User)<-[f:FOLLOWS]-() RETURN u.name AS name, count(f) AS followers ORDER BY followers DESC LIMIT 10","params":{}}},"example_request_get":"https://nexus-scout.pubky.app/v1/query?cypher=MATCH%20%28u%3AUser%29%3C-%5Bf%3AFOLLOWS%5D-%28%29%20RETURN%20u.name%20AS%20name%2C%20count%28f%29%20AS%20followers%20ORDER%20BY%20followers%20DESC%20LIMIT%2010","limits":{"default_limit":25,"max_result_rows":100,"max_result_bytes":1048576,"max_path_depth":5,"max_query_length":2000,"max_param_count":32,"max_param_bytes":8192,"max_body_bytes":65536},"notes":["A query with no LIMIT returns up to 25 rows; the ceiling is 100. Page past the ceiling with SKIP/LIMIT. `truncated` only fires when the gateway cut rows, so a query whose own LIMIT returns exactly that many rows is not flagged as truncated; `notes` says so instead, and a count() is the way to the true total.","Read-only: writes, CALL, and admin clauses are rejected. Errors carry a machine-readable code plus a hint describing the fix.","The JSON error envelope covers /v1/query application errors. An oversized body (413) and a request timeout (504) are answered by the outer layers as plain text."]}