{"service":"nexus-scout","description":"Read-only Cypher gateway to the Pubky social graph.","start_here":"/llms.txt","endpoints":{"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":{}}},"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: reconcile against a count().","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."]}