feat: make the site discoverable and callable by AI agents

next.config.mjs

@@ -1,6 +1,16 @@
 /** @type {import('next').NextConfig} */
 const isProd = process.env.NODE_ENV === 'production';
 
+const agentDiscoveryLinks = [
+  '</.well-known/api-catalog>; rel="api-catalog"; type="application/linkset+json"',
+  '</openapi.json>; rel="service-desc"; type="application/vnd.oai.openapi+json"',
+  '</ai>; rel="service-doc"; type="text/html"',
+  '</llms.txt>; rel="describedby"; type="text/plain"',
+  '</.well-known/mcp/server-card.json>; rel="service-desc"; type="application/json"',
+  '</.well-known/agent-card.json>; rel="service-desc"; type="application/json"',
+  '</.well-known/agent-skills/index.json>; rel="describedby"; type="application/json"',
+].join(', ');
+
 const nextConfig = {
   poweredByHeader: false,
   async redirects() {
@@ -57,7 +67,7 @@ const nextConfig = {
           {
             key: 'Permissions-Policy',
             value:
-              'accelerometer=(), camera=(), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), payment=(), usb=(), browsing-topics=()',
+              'accelerometer=(), camera=(), geolocation=(), gyroscope=(), magnetometer=(), microphone=(), payment=(), usb=(), browsing-topics=(), tools=(self)',
           },
           {
             key: 'Cross-Origin-Opener-Policy',
@@ -71,6 +81,18 @@ const nextConfig = {
             key: 'X-Frame-Options',
             value: 'SAMEORIGIN',
           },
+          {
+            key: 'Content-Signal',
+            value: 'ai-train=yes, search=yes, ai-input=yes',
+          },
+          {
+            key: 'X-Robots-Tag',
+            value: 'all',
+          },
+          {
+            key: 'Link',
+            value: agentDiscoveryLinks,
+          },
         ],
       },
       {
@@ -97,7 +119,7 @@ const nextConfig = {
       },
     ];
   },
-  transpilePackages: ["framer-motion"],
+  transpilePackages: ['framer-motion'],
   // swcMinify has been removed in Next.js 15
   images: {
     formats: ['image/avif', 'image/webp'],

public/.well-known/agent-card.json

@@ -0,0 +1,83 @@
+{
+  "name": "Yourself to Science Catalogue Agent",
+  "description": "Searches and explains the open Yourself to Science catalogue of clinical trials, biobanks, registries, and biological or digital data donation opportunities.",
+  "supportedInterfaces": [
+    {
+      "url": "https://yourselftoscience.org/api/a2a",
+      "protocolBinding": "JSONRPC",
+      "protocolVersion": "1.0"
+    }
+  ],
+  "provider": {
+    "organization": "Yourself to Science",
+    "url": "https://yourselftoscience.org"
+  },
+  "iconUrl": "https://yourselftoscience.org/logo-tm.svg",
+  "version": "1.0.0",
+  "documentationUrl": "https://yourselftoscience.org/ai",
+  "capabilities": {
+    "streaming": false,
+    "pushNotifications": false,
+    "extendedAgentCard": false
+  },
+  "securitySchemes": {},
+  "securityRequirements": [],
+  "defaultInputModes": [
+    "text/plain",
+    "application/json"
+  ],
+  "defaultOutputModes": [
+    "text/plain",
+    "application/json"
+  ],
+  "skills": [
+    {
+      "id": "search-research-opportunities",
+      "name": "Search Research Opportunities",
+      "description": "Find relevant catalogue entries using free text and criteria such as country, data type, compensation, and organization category.",
+      "tags": [
+        "research participation",
+        "clinical trials",
+        "biobanks",
+        "data donation",
+        "open science"
+      ],
+      "examples": [
+        "Find projects available in Italy that accept genetic data.",
+        "Show paid research-participation opportunities.",
+        "Which non-profit biobanks accept participants worldwide?"
+      ],
+      "inputModes": [
+        "text/plain",
+        "application/json"
+      ],
+      "outputModes": [
+        "text/plain",
+        "application/json"
+      ]
+    },
+    {
+      "id": "explain-catalogue-resource",
+      "name": "Explain Catalogue Resource",
+      "description": "Return and summarize the structured details of one Yourself to Science catalogue resource by ID or slug.",
+      "tags": [
+        "resource details",
+        "eligibility context",
+        "scientific programmes",
+        "citations"
+      ],
+      "examples": [
+        "Explain this Yourself to Science resource and what data it accepts.",
+        "Return the full record for a catalogue slug."
+      ],
+      "inputModes": [
+        "text/plain",
+        "application/json"
+      ],
+      "outputModes": [
+        "text/plain",
+        "application/json"
+      ]
+    }
+  ]
+}

public/.well-known/agent-skills/index.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://schemas.agentskills.io/discovery/0.2.0/schema.json",
+  "skills": [
+    {
+      "name": "yourself-to-science-catalogue",
+      "type": "skill-md",
+      "description": "Search and interpret the Yourself to Science open catalogue of clinical trials, biobanks, registries, and biological or digital data donation opportunities.",
+      "url": "/.well-known/agent-skills/yourself-to-science-catalogue/SKILL.md",
+      "digest": "sha256:691844baa700dd09862306b6c9d0c4f4b7bdbe926d383e0c723f2d68f35541b4"
+    }
+  ]
+}

public/.well-known/agent-skills/yourself-to-science-catalogue/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: yourself-to-science-catalogue
+description: Search and interpret the Yourself to Science open catalogue of clinical trials, biobanks, registries, and biological or digital data donation opportunities.
+---
+
+# Yourself to Science Catalogue
+
+Use this skill when a user wants to find, compare, or understand ways to contribute data, samples, time, or participation to scientific research.
+
+## Preferred access
+
+1. Use the public MCP server at `https://mcp.yourselftoscience.org/mcp` when MCP is available.
+2. Otherwise use `https://yourselftoscience.org/resources.json` for the complete CC0 dataset.
+3. Use `https://yourselftoscience.org/openapi.json` for the machine-readable API description.
+4. Use `https://yourselftoscience.org/llms.txt` for a compact documentation index.
+
+## Search procedure
+
+- Extract the user's requested country, data type, compensation preference, and organization category.
+- Treat records with no country restriction as worldwide unless the record explicitly excludes the user's country.
+- Distinguish donation, payment, and mixed compensation.
+- Return the strongest matches first and include each canonical Yourself to Science resource URL.
+- Preserve uncertainty when programme eligibility, availability, or enrolment status is not explicit in the catalogue.
+- Never claim that a listing is medical advice, guaranteed eligibility, or currently recruiting unless the source record states it.
+
+## Useful MCP tools
+
+- `search_resources`: faceted catalogue search.
+- `get_resource`: full record by ID or slug.
+- `list_data_types`: available contribution data types.
+- `list_countries`: represented availability regions.
+- `get_stats`: catalogue-wide summary.
+- `search` and `fetch`: citation-oriented retrieval.
+
+## Licensing
+
+The dataset is dedicated to the public domain under CC0 1.0. Website prose and source code have separate licences; inspect the relevant licence page before republishing them.

public/.well-known/api-catalog

@@ -0,0 +1,66 @@
+{
+  "linkset": [
+    {
+      "anchor": "https://yourselftoscience.org/",
+      "service-desc": [
+        {
+          "href": "https://yourselftoscience.org/openapi.json",
+          "type": "application/vnd.oai.openapi+json"
+        },
+        {
+          "href": "https://yourselftoscience.org/.well-known/mcp/server-card.json",
+          "type": "application/json"
+        },
+        {
+          "href": "https://yourselftoscience.org/.well-known/agent-card.json",
+          "type": "application/json"
+        }
+      ],
+      "service-doc": [
+        {
+          "href": "https://yourselftoscience.org/ai",
+          "type": "text/html"
+        },
+        {
+          "href": "https://yourselftoscience.org/llms.txt",
+          "type": "text/plain"
+        }
+      ],
+      "status": [
+        {
+          "href": "https://yourselftoscience.org/api/health",
+          "type": "application/json"
+        }
+      ],
+      "describedby": [
+        {
+          "href": "https://yourselftoscience.org/.well-known/agent-skills/index.json",
+          "type": "application/json"
+        },
+        {
+          "href": "https://yourselftoscience.org/datapackage.json",
+          "type": "application/json"
+        },
+        {
+          "href": "https://yourselftoscience.org/void.ttl",
+          "type": "text/turtle"
+        }
+      ]
+    },
+    {
+      "anchor": "https://mcp.yourselftoscience.org/mcp",
+      "service-desc": [
+        {
+          "href": "https://yourselftoscience.org/.well-known/mcp/server-card.json",
+          "type": "application/json"
+        }
+      ],
+      "service-doc": [
+        {
+          "href": "https://yourselftoscience.org/ai",
+          "type": "text/html"
+        }
+      ]
+    }
+  ]
+}

public/.well-known/mcp.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "org.yourselftoscience/catalogue",
+  "title": "Yourself to Science",
+  "description": "Search an open CC0 catalogue of clinical trials, biobanks, registries, and biological or digital data donation programs.",
+  "repository": {
+    "url": "https://github.com/yourselftoscience/yourselftoscience.org",
+    "source": "github"
+  },
+  "version": "1.0.0",
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://mcp.yourselftoscience.org/mcp"
+    }
+  ]
+}