{"ok":true,"name":"GEDCOM Tools","api_version":1,"capabilities":["public-tool-discovery","published-guides","private-gedcom-storage","deterministic-gedcom-analysis","standalone-html-reports"],"endpoints":{"tools":"https://gedcom.tools/api/tools","tool":"https://gedcom.tools/api/tools/{id}","guides":"https://gedcom.tools/api/guides","guide":"https://gedcom.tools/api/guides/{id}","documents":"https://gedcom.tools/api/v1/documents","document":"https://gedcom.tools/api/v1/documents/{documentId}","analyses":"https://gedcom.tools/api/v1/documents/{documentId}/analyses","reports":"https://gedcom.tools/api/v1/documents/{documentId}/reports","report":"https://gedcom.tools/api/v1/reports/{reportId}"},"mcp":{"url":"https://gedcom.tools/mcp","transport":"streamable-http","stateless":true,"tools":["search_tools","get_tool","list_guides","read_guide","list_documents","upload_gedcom","get_document","analyze_gedcom","create_report","get_report","delete_document"]},"hosted":{"authentication":"Authorization: Bearer <vault-token>","onboarding":"https://gedcom.tools/hosted-access","vault":"https://gedcom.tools/vault","limits":{"maxFileBytes":262144,"maxDocuments":10,"maxReportBytes":262144,"maxTokens":8,"tokenTtlDays":30,"maxAnalysesPerDay":60,"maxOperationsPerDay":300,"maxLines":5000,"maxRecords":1000,"maxDepth":64,"maxLineCharacters":4096},"launch_admission_per_day":{"ordinary_requests":10000,"new_vaults":100,"upload_or_compute_requests":1000,"maintenance_requests":1000},"operations":[{"method":"GET","path":"/api/v1/documents","mcp":"list_documents","scope":"read"},{"method":"POST","path":"/api/v1/documents","mcp":"upload_gedcom","scope":"write","body":{"contentBase64":"<base64 of original GEDCOM bytes>","consent":true}},{"method":"GET","path":"/api/v1/documents/{documentId}","mcp":"get_document","scope":"read"},{"method":"POST","path":"/api/v1/documents/{documentId}/analyses","mcp":"analyze_gedcom","scope":"read","body":{"method":"validate_gedcom","details":false,"offset":0,"limit":25}},{"method":"POST","path":"/api/v1/documents/{documentId}/reports","mcp":"create_report","scope":"read write","body":{}},{"method":"GET","path":"/api/v1/reports/{reportId}","mcp":"get_report","scope":"read","returns":"HTML attachment; MCP returns HTML text"},{"method":"DELETE","path":"/api/v1/documents/{documentId}","mcp":"delete_document","scope":"delete"}],"token_management":{"list":"GET /api/v1/tokens","create":"POST /api/v1/tokens","revoke":"DELETE /api/v1/tokens/{tokenId}","rotate_owner":"POST /api/v1/owner-key","delete_vault":"DELETE /api/v1/vault"}},"manifest":"https://gedcom.tools/tools.json","skills":{"directory":"https://www.skills.sh/sliday/genealogy-research","repository":"https://github.com/sliday/genealogy-research","source":"https://github.com/sliday/genealogy-research/blob/main/SKILL.md","guide":"https://gedcom.tools/for-agents/skill"},"privacy":{"accepts_gedcom":true,"executes_tools":true,"calls_models":false,"stores_sessions":false,"stores_documents":true,"retention":"until-owner-deletes","scope":"Discovery remains public. Authenticated hosted operations process and retain files and reports in private Cloudflare storage with explicit upload consent. No training or secondary use. Browser tools remain browser-local; existing model-assisted tools have separate consent and quotas.","origins":"Native clients may omit Origin. Supplied Origin must be https://gedcom.tools or https://www.gedcom.tools. Origin checks are not authentication."},"limits":{"request_bytes":16384,"response_bytes":1048576,"manifest_bytes":524288,"guide_bytes":131072,"query_characters":200,"url_characters":2048,"default_results":10,"max_results":25,"max_offset":1000},"limits_note":"Public discovery uses the limits below. Authenticated upload envelopes allow 400 KiB, with 256 KiB decoded files. Hosted vault quotas and global launch admission apply across REST and MCP. /mcp and /mcp/ accept one JSON-RPC message per POST, with JSON responses and no SSE or MCP session storage."}