MCP Tools
Reference for the three Profer MCP tools
MCP Tools
Profer exposes three tools via the Model Context Protocol.
publish
Publish an HTML artifact for human review.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
html | string | Yes | The HTML content to publish |
title | string | No | Page title |
questions | Question[] | No | Structured feedback questions |
webhook_url | string (URL) | No | URL to POST when feedback is received |
Returns:
{
"id": "PF-K8M3N",
"url": "https://profer.dev/v/PF-K8M3N"
}get
Retrieve a published page and all feedback.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The page ID (e.g., "PF-K8M3N") |
Returns:
{
"id": "PF-K8M3N",
"title": "Auth Migration Spec",
"html": "<h1>...</h1>",
"questions": [...],
"version": 1,
"status": "approved",
"feedback": [
{
"answers": { "q1": "yes", "q2": "Option A" },
"reviewer": "Alice",
"source": "page",
"created_at": "2024-01-15T10:30:00Z"
}
]
}update
Update a previously published page. Increments the version number. Existing feedback is preserved.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The page ID to update |
html | string | No | Updated HTML content |
title | string | No | Updated title |
questions | Question[] | No | Updated feedback questions |
webhook_url | string (URL) | No | Updated webhook URL |
At least one of html, title, questions, or webhook_url must be provided.
Returns:
{
"id": "PF-K8M3N",
"url": "https://profer.dev/v/PF-K8M3N",
"version": 2
}