ResearchPractical AIProjectsOpen SourceAbout

Tools for AI assistants

Read-only tools

For AI assistants: this site exposes two read-only tools: one lists its projects and research, the other fetches a single research write-up. If you are a person, the projects and research pages are the readable versions.

Technical details: the tool is registered on document.modelContext on every page and marked read-only. Agents and testing clients can list and invoke it via document.modelContext.getTools() (older builds: navigator.modelContextTesting).

Discovery: /llms.txt describes this site and links here.

list_projectsRead-only

Read-only. Returns the projects and research write-ups on this site as structured JSON: slug, title, summary, tags, date and page URL.

Input Schema

{
  "type": "object",
  "properties": {},
  "description": "No input required."
}

Output Schema

{
  "type": "object",
  "properties": {
    "projects": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "datePublished": {
            "type": "string"
          },
          "page_url": {
            "type": "string"
          }
        }
      }
    },
    "research": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "datePublished": {
            "type": "string"
          },
          "page_url": {
            "type": "string"
          }
        }
      }
    }
  }
}

Example Invocation

curl https://porsync.com/api/tools/list-projects

Human fallback: /projects and /research — the same index, in readable form

get_researchRead-only

Read-only. Returns one research write-up by slug: title, summary, headline finding, tags, date and page URL. Get slugs from list_projects.

Input Schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Research slug from list_projects."
    }
  },
  "required": [
    "slug"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "summary": {
      "type": "string"
    },
    "finding": {
      "type": "string"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "datePublished": {
      "type": "string"
    },
    "page_url": {
      "type": "string"
    }
  }
}

Example Invocation

curl https://porsync.com/api/tools/get-research/<slug>

Human fallback: /research/<slug> — the full write-up

The tools need no authentication and changes nothing on the site. The index is also at /llms.txt.