Published 2026-09-21 · Tested 2026-08-20

Inkeep

C+

Inkeep received 8 PASS votes and passed 4 of five agent surface checks. The clearest finding came from the verify an agent webhook trigger task.

Panel: GPT 5.6 Sol, Opus 5, DeepSeek v4F Battery: v1 Read as markdown (opens in a new tab)

Three AI models, GPT 5.6 Sol, Claude Opus 5, and DeepSeek v4 Flash, each read Inkeep’s public documentation independently and attempted five first-hour developer jobs: launch the first agent, find the exact limits, recover a stopped agent, verify an agent webhook trigger, use the TypeScript SDK.

No accounts, API calls, or code execution were used. Every verdict came from public pages and every published quotation passed a live verification check. Preflight substitutions: T3: Transfer-limit or generation-step recovery replaces HTTP 429.

Freshness

How rechecks work
Tested
Quotes verified
Surface rechecked

No change since the test.

5 of 5 quoted passages still appear on the live pages.

Inkeep Fumadocs · published
C+

78.8% · 63/80 · AI Agent Readiness Score · reading 30 pts · surface 50 pts

llms.txt PASS
llms-full.txt PASS
markdown mirror PASS
MCP server FAIL
docs AI PASS
Task GPT 5.6 SolOpus 5DeepSeek v4F Consensus
Launch the first agent PASSPASSPASS PASS
Find the exact limits PASSPARTIALPASS PASS
Recover a stopped agent PARTIALPASSPASS PASS
Verify an agent webhook trigger PARTIALPARTIALPASS PARTIAL
Use the TypeScript SDK PARTIALPARTIALPARTIAL PARTIAL

docs platform: Fumadocs (unscored) · verified 2026-08-20

What to fix first

These 3 fixes could add up to 15 points to the AI Agent Readiness Score. The list ranks each fix by the points it would add. How the ranking works

  1. 1
    +10 points MCP server check failed

    Found: Candidate endpoints returned HTTP 404 and no valid MCP response.

    Fix: Run a public MCP server for the docs that answers a JSON-RPC initialize call and offers a docs search tool.

    Evidence: docs.inkeep.com/mcp (opens in a new tab)

  2. 2
    +3 points Use the TypeScript SDK PARTIAL

    Found: The SDK agent example does not say where it goes in the quickstart project. Opus 5 also found pages register agents on project() under two different keys.

    Fix: Show the minimal agent inside the quickstart project with its run steps, and register agents with one project() key everywhere.

    Evidence: docs.inkeep.com/typescript-sdk/agent-settings (opens in a new tab)

  3. 3

    Found: The SDK webhooks page omits the signature encoding, prefix, and signed bytes, and its endpoints differ from the API reference.

    Fix: Document the X-Signature-256 encoding, prefix, and signed bytes, and use identical endpoint paths in the SDK guide and API reference.

    Evidence: docs.inkeep.com/typescript-sdk/triggers/webhooks (opens in a new tab)

What the docs get right

  • Launch the first agent: 3 PASS votes. The quickstart orders prerequisites, scaffolding, setup, startup, login, and the Activities Planner chat on one page.
  • Find the exact limits: 2 PASS votes. The runtime guide states both the configured stream lifetime and its default value.
  • 4 of 5 agent surface checks. Present: llms.txt, llms-full.txt, markdown mirrors, docs AI. Missing: an MCP server.

Launch the first agent

PASS

PASS consensus from 3 PASS.

The quickstart orders prerequisites, scaffolding, setup, startup, login, and the Activities Planner chat on one page. One page carries the whole path: three named prerequisites with version floors, then five numbered steps from npx @inkeep/create-agents my-agents through pnpm setup-dev, pnpm dev, login, and chatting with the Activities Planner agent, with no branch to choose. The quickstart provides a complete 5-step path from zero to chatting with the Activities Planner agent, with prerequisites, exact commands, and expected outcomes.

Find the exact limits

PASS

PASS consensus from 2 PASS, 1 PARTIAL.

Defaults are 10 transfers, 12 steps, 30-second function tools, 60-second MCP tools, and 10-minute streams; both caps are 1000. Every requested value is inline as a code comment (transfers default 10 / max 1000, generation steps default 12 / max 1000, function tool 30sec, MCP tool 1min, stream lifetime 10min) and Open Source versus Enterprise is a nine-table matrix on /pricing, but the same page prints two different names for the transfer-count variable and then tells the reader the real values live in monorepo TypeScript files it never reproduces. All limits are documented with explicit environment variable names, default values, maximum ceilings, and the configuration hierarchy for agent-specific overrides via stopWhen.

Recover a stopped agent

PASS

PASS consensus from 2 PASS, 1 PARTIAL.

The docs cover diagnosis and configuration changes, but they omit one complete restart and retry sequence. An "Agent Stopped Unexpectedly" section names both failure modes, gives three diagnosis steps against the Traces timeline and its clickable error cards, gives three fixes including raising the limit, and links to the exact stopWhen syntax and to per-service logs in the pnpm dev terminal. The docs cover trace inspection (SigNoz and Visual Builder), limit adjustment (stopWhen and env vars), and durable execution mode for crash recovery, though the recovery path is spread across multiple pages.

Verify an agent webhook trigger

PARTIAL

PARTIAL consensus from 1 PASS, 2 PARTIAL.

Definition, pushing, verification, and tracking are documented, but signature formatting is missing and invocation endpoints conflict. Defining the trigger, pushing it, and reading invocation status are all fully specified, but the SDK page's webhook path and its invocations curl both disagree with the generated API reference, and the signature encoding, prefix, and signed byte range are never stated, so a valid test signature cannot be constructed from the docs. The docs cover the full webhook trigger lifecycle: create, configure signing secret, receive POST, validate payload, inspect invocation status. The HMAC verification is handled by Inkeep's framework.

Use the TypeScript SDK

PARTIAL

PARTIAL consensus from 3 PARTIAL.

The SDK defines both entities, but a minimal local run requires combining agent, project, and CLI pages. The fact-finder tutorial builds sub-agent, agent, tool, and project registration inside the quickstart's src/projects layout and ends at inkeep push plus the Visual Builder "Try it" button, but Project Management registers the same thing under subAgents on project() while this page uses agents, and the minimal agent() example on Agents & Sub Agents omits both name and defaultSubAgent that every working example includes. The SDK example shows a complete agent and sub-agent definition, but the docs do not explicitly show how to integrate this example into the scaffolded quickstart project, the user must infer the integration path from the fact-finder tutorial and push-pull documentation.

The receipt

The framework automatically verifies HMAC-SHA256 signatures in the X-Signature-256 header.

Definition, pushing, verification, and tracking are documented, but signature formatting is missing and invocation endpoints conflict.

Agent surface notes

Candidate endpoints returned HTTP 404 and no valid MCP response.

The live docs load a public Ask AI widget inside an open Shadow DOM. The control opens an AI assistant panel that invites users to ask about Inkeep.

Show the score

AI Agent Readiness Score 78.8%, grade C+

Paste this into a readme:

[![AI Agent Readiness Score 78.8%](https://docsforagents.com/badge/inkeep.svg)](https://docsforagents.com/reports/inkeep-docs-ai-agent-readiness/)

Method note

This is a reading test of public documentation, not an execution test. No accounts were created and no API calls were run. The AI Agent Readiness Score counts fifteen reading votes at PASS 2, PARTIAL 1, and FAIL 0, for 30 possible points. Five agent surface checks add 10 points each. The total is 80. Consensus chips show each row majority and do not affect scoring. The panel split on 3 of five tasks. Quotes shown here were re-fetched and confirmed verbatim on 2026-08-20.

Read the full methodology

Put another docs site through the battery.

Nominate a docs site