{
  "schema_version": "1.0",
  "name": "NRP research agent discovery",
  "description": "A safe starting point for agents working with MGI NRP research materials. These URLs describe services; they do not grant access.",
  "access": {
    "sign_in_url": "/nrp-login.html",
    "browser_session": "The paper and QC site require an active NRP browser session. Do not ask a user to paste a password, browser cookie, bearer token, storage key, or connection string into an agent or prompt.",
    "agent_token": "The Organelles bootstrap endpoint issues a time-limited, read-only agent token in a Markdown guide after browser-session authentication. Send that token only in the X-NRP-Agent-Token header to the listed Organelles API endpoints."
  },
  "services": [
    {
      "id": "nrp-organelles-paper",
      "title": "NRP Organelles Paper",
      "entry_url": "/NRP/NRPOrganelles/",
      "purpose": "Searchable paper text, figure recipes, feature dictionaries, and released organelle-imaging datasets.",
      "start_here": {
        "method": "GET",
        "url": "/api/agent/bootstrap",
        "authentication": "Active NRP browser session",
        "response": "A no-store Markdown guide containing a 30-day, read-only agent capability. The guide is the only place the token is delivered."
      },
      "agent_endpoints": [
        {
          "method": "GET",
          "url": "/api/agent/manifest",
          "authentication": "X-NRP-Agent-Token",
          "purpose": "Resource catalog and released dataset catalog. Retrieve this before selecting a paper resource or dataset."
        },
        {
          "method": "GET or HEAD",
          "url": "/api/agent/file?path={manifest-paper-resource-path}",
          "authentication": "X-NRP-Agent-Token",
          "purpose": "Read one allowlisted paper resource named by the manifest."
        },
        {
          "method": "GET",
          "url": "/api/agent/data?name={manifest-dataset-name}",
          "authentication": "X-NRP-Agent-Token",
          "purpose": "Get the credential-free download URL for one released imaging dataset named by the manifest."
        }
      ],
      "retrieval_policy": "Retrieve only the resources needed for the question; do not mirror the paper or datasets automatically."
    },
    {
      "id": "nrp-quality-control",
      "title": "NRP Quality Control",
      "entry_url": "/NRP/QC/",
      "purpose": "Gated, fixed QC reports with published summary data and release-specific local-analysis guides.",
      "access": "Use an active NRP browser session. QC is not currently a token-based query API.",
      "published_resource_url_template": "/NRP/QC/{published-path}",
      "release_downloads": [
        {
          "id": "fiw141-p9-d21-markers",
          "method": "GET",
          "url": "/NRP/QC/download/fiw141-p9-d21-markers",
          "authentication": "Active NRP browser session",
          "purpose": "Download the fixed FIW141 P9 Day 21 marker release. Give the downloaded local file path to a local analysis agent."
        }
      ],
      "agent_note": "Read the release's AGENT_GUIDE.md after downloading it. Do not transfer browser-session credentials to an agent."
    }
  ],
  "security": {
    "never_publish_here": [
      "Passwords, browser cookies, bearer tokens, storage keys, connection strings, or private blob URLs",
      "Unpublished data paths or internal laboratory file-system paths"
    ],
    "important": "This discovery document is intentionally public metadata, not an authorization mechanism. Every protected endpoint still verifies its required credential."
  }
}