MCP server
Tone, readability, AI-slop and semantic SEO analysis right in Cursor, Claude Desktop and other MCP clients. Same token, same budgets.
"url": "https://app.pennao.com/api/mcp"
A REST API described with OpenAPI, webhooks signed with HMAC and an MCP server. Everything you do in the dashboard, you can do from code.
In Settings → API tokens choose scopes and projects. The token starts with psk_live_ and is shown only once.
Send a brief with an Idempotency-Key header. The 202 response holds a ticket and links to the status, content and events.
When it is done, Pennao sends article.completed with the quality score, cost and a link to the content.
order.sh
curl -X POST "$PENNAO_URL/v1/articles" \
-H "Authorization: Bearer $PENNAO_TOKEN" \
-H "Idempotency-Key: battery-2026-11-17" \
-H "Content-Type: application/json" \
-d '{
"projectId": "prj_01K7…",
"brief": {
"title": "Is a home battery worth it with solar?",
"keywords": { "primary": "home battery with solar" },
"intent": "commercial"
},
"settings": { "languages": ["en", "de", "nl"], "includeFaq": true }
}'
# 202 Accepted
{ "ticket": "art_01K7…", "status": "queued" }
GET /v1/articles/art_01K7…
{
"ticket": "art_01K7…",
"status": "completed",
"languages": ["en", "de", "nl"],
"qualityScore": 91,
"costUsd": 0.11,
"links": {
"content": "…/v1/articles/art_01K7…/content",
"events": "…/v1/articles/art_01K7…/events"
}
}
hooks.js
import { createHmac, timingSafeEqual } from 'node:crypto';
// Pennao-Signature: t=<unix time>,v1=<hex HMAC-SHA256 of "t.body">
export function verify(body, header, secret, toleranceSec = 300) {
const parts = (header ?? '').split(',').map((p) => p.split('='));
const t = parts.find(([k]) => k === 't')?.[1];
if (!t || Math.abs(Date.now() / 1000 - Number(t)) > toleranceSec) return false;
const expected = createHmac('sha256', secret).update(`${t}.${body}`).digest();
return parts.some(([k, v]) =>
k === 'v1' && /^[0-9a-f]{64}$/.test(v) && timingSafeEqual(expected, Buffer.from(v, 'hex')),
);
}
Errors in application/problem+json, cursor pagination and rate limits returned as 429 with Retry-After. The full list is in the interactive reference.
/v1/articles
new order, 202 response with a ticket
/v1/articles/{ticket}
status, stage, progress, cost and quality score
/v1/articles/{ticket}/events
live progress (Server-Sent Events)
/v1/articles/{ticket}/content
Markdown, HTML or JSON in the chosen language
/v1/articles/{ticket}/approve-plan
approve the plan before writing
/v1/articles/{ticket}/translations
new language versions of a finished text
/v1/validate
quality check of any text
/v1/webhooks
new webhook with a signing secret
Every delivery carries a Pennao-Signature header with an HMAC-SHA256 signature and a timestamp. Anything other than 2xx within 10 seconds means a retry: up to 8 attempts with a growing delay.
article.completedthe article and its translations are readyarticle.failedthe order ended with an errorarticle.plan_readythe plan is waiting for approvalarticle.cancelledthe order was cancelledarticle.revision_readya passage revision is readyideas.generatednew ideas reached a projectproject.profile_readythe agent finished analyzing a siteseo.report_readyan SEO report is readyTone, readability, AI-slop and semantic SEO analysis right in Cursor, Claude Desktop and other MCP clients. Same token, same budgets.
"url": "https://app.pennao.com/api/mcp"
Quality checks for text written outside Pennao: LanguageTool, the AI-slop filter, an SEO linter, links and JSON-LD. Results as JSON or a Markdown report.
POST /v1/validate
A machine-readable description of every endpoint. Generate a client in your language or import it into Postman and Insomnia.
GET /api/openapi.json
A token’s permissions are the intersection of its scopes and the role of the person who created it. Limit a token to selected projects, set an expiry date and revoke it at any time.
articles:readstatuses, content, versions, events and validationarticles:writenew orders, cancel, retry, approve the planprojects:read / writeprojects, site profiles and settingsideas:read / writetopic ideas and strategieswebhooks:read / writewebhooks and delivery historyskills:runtext analysis: tone, readability, AI-slop, semantic SEOCreate an account, add a model key and create an API token. Examples in curl, Node.js, Python and PHP are in the documentation.