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-onlyRead-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-onlyRead-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.