GEO draft: answer-first blocks, facts tables and FAQ for Permit MCP Gateway pages

[orweis]

Draft for Or / R&D review. Do not merge until reviewed. Part of the GEO/AEO docs answer-ready pass (plan: Action 1, geo-aeo-plan-2026-10-05). Opened by Content Bot on behalf of Or Weis.

Pages

• docs/permit-mcp-gateway/quickstart.mdx, guide.mdx, architecture.mdx, permit-integration.mdx: answer block (62 to 69 words), facts table (clients, deployment modes, auth methods, audit, no SDK needed, gateway free tier, open-source note), FAQ.
• architecture.mdx and permit-integration.mdx: new section "Reproduce a gateway decision with the Node.js SDK".

Where the facts come from

Repo docs for the gateway. Gateway free tier is copied from https://www.permit.io/mcp-gateway/pricing, fetched 2026-10-05: Community, Free forever, $0, "Up to 1,000 MAU (human + agentic identities)", Tenants 10, Environments 1, Audit log retention 7 days.

Pricing facts and re-check

Free-tier values are copied from the live https://www.permit.io/pricing page (Community column of Compare Plans, labeled "Free Forever"), fetched 2026-10-05:
MAU 1000, Tenants 20, Authorization Queries No Limit, Environments 3, PDP Instances No Limit (also in the pages that say so: Roles 25, Resource Types 50, Logs Retention 14 days).

• TODO (reviewer): re-open the pricing page before merging and confirm these values still match. Each page has an MDX comment {/* GEO pass: ... */} next to the table naming the source and fetch date.
• TODO (reviewer): re-check https://www.permit.io/mcp-gateway/pricing too.

R&D, please double check

• The two pricing pages disagree on Community limits: main pricing lists 20 tenants, 3 environments, 14 days log retention. The gateway pricing lists 10 tenants, 1 environment, 7 days audit retention. The gateway pages say this and link to both.
• Session duration: the gateway pricing FAQ says 30 days of inactivity and a 90-day maximum. The repo docs (consent service guide) say a session expires 90 days after the last tool call. I did not state session duration in the new text. Please decide which is right and fix the other.
• The Node.js snippet only shows the request shape of permit.check() for a gateway decision. It was checked against the SDK and a mock PDP, not a live gateway.

Style and checks

• No em or en dashes, no curly quotes, no filler words in added text. Answer-first blocks are 40 to 70 words (counted).
• Existing technical content and existing code samples are unchanged. New content is added under the answer block, in new sections, or before the Next steps section.
• npm run build (redirect-lint, relative links, private paths, Docusaurus build, hyperlink anchors, routes check, sidebar coverage) passed on a temporary branch with all six GEO branches merged.
• Fit statements ("use X when / don't use X when") are editorial. Please confirm they are acceptable.

[netlify]

✅ Deploy Preview for permitio-docs ready!

Name	Link
🔨 Latest commit	0bbc35e
🔍 Latest deploy log	https://app.netlify.com/projects/permitio-docs/deploys/6ac2cd6053b8e90008177add
😎 Deploy Preview	https://deploy-preview-665--permitio-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.