From bd2f1f0565b2fd0f3dc81f89b8a0ab19b27a2442 Mon Sep 17 00:00:00 2001 From: chrisjleal <184772742+chrisjleal@users.noreply.github.com> Date: Mon, 26 Oct 2026 04:20:22 -0500 Subject: [PATCH] Lead the docs with what an agent gets, in the words buyers search The docs home now says what Proofable does for an agent (a permission for its job, approvals, signed proof) and the free tier, and the first card is giving an agent a permission. The navbar's main button is Start free, with Sign in beside it. Page titles use the search terms: AI agent security, Agent security benchmarks, Agent permissions, AI agent audit trail, and Set up Proofable in Claude, Cursor, Codex or VS Code; sidebar labels are unchanged. README and package descriptions match. Co-Authored-By: Claude Opus 5.5 --- README.md | 2 +- agents/agent-delegation.mdx | 6 +++--- agents/index.mdx | 2 +- connections.mdx | 2 +- docs.json | 5 +++-- evidence.mdx | 2 +- index.mdx | 20 +++++++++++--------- mcp/setup.mdx | 4 ++-- package.json | 2 +- security.mdx | 3 ++- use-cases/prove-what-happened.mdx | 4 ++-- 11 files changed, 28 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index 6251e8a..465fc5c 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # Proofable Docs -Give AI agents identity, scoped access, and proof of what they did. Add verification and reusable proof to your app. +Put AI agents on real work without handing over your keys. These are the docs for Proofable: agent permissions, approvals, signed proof, and human and domain checks you can reuse in your app. Published site: [docs.proofable.me](https://docs.proofable.me) diff --git a/agents/agent-delegation.mdx b/agents/agent-delegation.mdx index 9c8f93d..a36916f 100644 --- a/agents/agent-delegation.mdx +++ b/agents/agent-delegation.mdx @@ -1,7 +1,7 @@ --- -title: Agent authority -sidebarTitle: Authority -description: "Grant an agent specific allowed actions, a per-payment spend cap, and an expiry date. Revoke or narrow its authority at any time." +title: Agent permissions +sidebarTitle: Permissions +description: "Grant an AI agent specific allowed actions, a per-payment spend cap and an expiry date. Narrow or revoke it at any time." icon: handshake --- diff --git a/agents/index.mdx b/agents/index.mdx index 70222a3..a2fefbd 100644 --- a/agents/index.mdx +++ b/agents/index.mdx @@ -1,7 +1,7 @@ --- title: "Agents" sidebarTitle: "Agents" -description: "Give each agent its own identity and limits. The controls stay with the agent across models, tools, runtimes, and MCP." +description: "Give each AI agent its own identity and a permission: the tools it can use, what it can spend, and when access ends. It goes with the agent into every client." icon: robot "og:image": "/images/og-default.png" "twitter:image": "/images/og-default.png" diff --git a/connections.mdx b/connections.mdx index d3b3b71..cdb537f 100644 --- a/connections.mdx +++ b/connections.mdx @@ -1,7 +1,7 @@ --- title: "Connect" sidebarTitle: "Connections" -description: "Your context and control, anywhere." +description: "Link an app once. Your agents use it under their permission and never see the credentials." icon: plug --- diff --git a/docs.json b/docs.json index 89cd43c..9beaeef 100644 --- a/docs.json +++ b/docs.json @@ -59,10 +59,11 @@ } }, "navbar": { + "links": [{ "label": "Sign in", "href": "https://proofable.me/verify?intent=login" }], "primary": { "type": "button", - "label": "Sign in", - "href": "https://proofable.me/verify?intent=login" + "label": "Start free", + "href": "https://proofable.me/connect" } }, "navigation": { diff --git a/evidence.mdx b/evidence.mdx index d6cfeed..fc9a4a0 100644 --- a/evidence.mdx +++ b/evidence.mdx @@ -1,5 +1,5 @@ --- -title: "Evidence" +title: "Agent security benchmarks" sidebarTitle: "Evidence" description: "How much agent time and spend Proofable saves, and what it stops, measured against the same work done without it." icon: certificate diff --git a/index.mdx b/index.mdx index fc3ed33..783dafb 100644 --- a/index.mdx +++ b/index.mdx @@ -1,24 +1,26 @@ --- -title: "Get Started" +title: "Get started with Proofable" sidebarTitle: "Get Started" -description: "Set limits on what AI agents can do, verify people and accounts, and keep proof of what happened." -"og:title": "Grant access with proof your app can check again" -"twitter:title": "Grant access with proof your app can check again" +description: "Connect Proofable to Claude, Cursor, Codex or VS Code with one command, give an agent a permission, and check its signed proof." +"og:title": "Put AI agents on real work without handing over your keys" +"twitter:title": "Put AI agents on real work without handing over your keys" icon: book "og:image": "/images/og-default.png" "twitter:image": "/images/og-default.png" --- -Proofable lets people, businesses, and AI agents prove something once and reuse the proof anywhere. Each agent gets a scoped permission instead of your keys, every action is checked before it runs, and every run leaves a signed proof anyone can verify offline. +Proofable puts AI agents on real work without your keys. Each agent gets a permission for its job: the tools it can use, what it can spend on each payment, and when its access ends. Every action is checked before it runs, risky steps can wait for your approval, and every run leaves a signed proof anyone can verify offline. -Add it to your AI tool, or build it into your product. +People can also prove once that they are human or own a domain, and reuse that proof at every later check. + +Start in your AI tool, or build it into your product. Free with 500 credits a month. - Add Proofable to any MCP client. + One connection for Claude, Cursor, Codex and VS Code. - - Check the proof before your server grants access. + + Its tools, its spend cap, its end date. Nothing else runs. Run a hosted check and keep the proof. diff --git a/mcp/setup.mdx b/mcp/setup.mdx index 1b6e185..d62e86f 100644 --- a/mcp/setup.mdx +++ b/mcp/setup.mdx @@ -1,7 +1,7 @@ --- -title: "Setup" +title: "Set up Proofable in Claude, Cursor, Codex or VS Code" sidebarTitle: "Setup" -description: "Connect Proofable to an MCP client, sign in, and start with your current profile and proofs." +description: "Add the Proofable MCP server to your client with one command, sign in, and start with your profile and the proofs you can reuse." icon: plug --- diff --git a/package.json b/package.json index cc8283f..e5a1f29 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "@proofable/docs", "private": true, - "description": "Docs for verification, gates, proofs, agents, and MCP.", + "description": "Docs for Proofable: AI agent permissions, approvals, signed proof, verification and MCP.", "license": "Apache-2.0", "type": "module", "engines": { diff --git a/security.mdx b/security.mdx index 83ace2c..ab60ae4 100644 --- a/security.mdx +++ b/security.mdx @@ -1,5 +1,6 @@ --- -title: "Security" +title: "AI agent security" +sidebarTitle: "Security" description: "AI agent security and governance. An agent cannot act beyond what you allowed, and a proof never exposes the data behind it." icon: lock --- diff --git a/use-cases/prove-what-happened.mdx b/use-cases/prove-what-happened.mdx index 5e4c96a..0c1e69a 100644 --- a/use-cases/prove-what-happened.mdx +++ b/use-cases/prove-what-happened.mdx @@ -1,7 +1,7 @@ --- -title: "Prove what happened" +title: "AI agent audit trail" sidebarTitle: "Prove what happened" -description: "Keep a record of who acted and what was allowed." +description: "Every permission, check and agent action becomes a signed proof of who acted, what was allowed and what happened, without exposing the data behind it." icon: receipt ---