{"contract":"forge.server-history/v1","contract_version":"1.0.0","endpoint":"https://theagentforge.io/api/v1/history/{server}","mcp":{"endpoint":"https://theagentforge.io/mcp/requests","tool":"forge_server_history"},"openapi":"https://theagentforge.io/openapi.json","auth":"none","rate_limit":{"per_address_per_minute":60},"cache":{"max_age_s":900,"etag":"strong, sha256 of the body; If-None-Match gives 304"},"sections":["install_outcomes","definitions","changes"],"paging":{"default_limit":100,"max_limit":200,"next":"each section's next URL, null on the last page"},"families":{"top500_nightly":"The House tester's nightly run of the 500 most-downloaded no-setup npm MCP servers in the official MCP Registry; one row per server per UTC night.","weekly_sweep":"The House tester's weekly sweep of every no-setup npm and PyPI server, a seventh a day; one row per server per UTC day it was tested.","backfill":"The tool-history backfill (ADR 0134): each stable version published since 2025-09-01, installed once in the same sandbox; date is the UTC day we ran it, published_at the registry's publish date."},"origins":{"post":"Filed by the House run itself.","kv_copy":"Copied unchanged from the run's stored copy (nights before 5 Nov 2026).","nightly":"Seen by the House tester's nightly or sweep run; first_seen is the first time we saw it, not a publish date.","carried":"Carried over from the definition sets stored before 5 Nov 2026; first_seen is when we stored it.","backfill":"Installed by the backfill; first_seen and published_at are the registry's publish date, observed_at is when we ran it."},"versioning":"minor versions only add fields; removing or renaming a field is a new contract (v2) at a new path","public_tier":"hashes, counts, dates and rule ids; no tool text","consumer_script":"scripts/examples/history-consumer.mjs"}