MCP Tools
Reference for the four Profer MCP tools
Profer exposes four tools via the Model Context Protocol.
publish
Publish content for human review. At least one of html, artifact, or messages is required.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
html | string | No | HTML content (shorthand for artifact type "html") |
artifact | object | No | Structured content: { type: "html"|"markdown"|"url"|"embed", content, label? } |
messages | array | No | Initial chat messages: [{ role: "agent"|"user", text }] |
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",
"messages": [{ "role": "agent", "text": "Here's the spec..." }],
"artifact": { "type": "html", "content": "<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 |
artifact | object | No | Updated artifact |
title | string | No | Updated title |
messages | array | No | Updated chat messages (replaces all messages) |
questions | Question[] | No | Updated feedback questions |
webhook_url | string (URL) | No | Updated webhook URL |
At least one field besides id must be provided.
Returns:
{
"id": "PF-K8M3N",
"url": "https://profer.dev/v/PF-K8M3N",
"version": 2
}delete
Delete a page and all its feedback. This action is irreversible.
Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The page ID to delete |
Returns:
{
"ok": true,
"id": "PF-K8M3N"
}