For agents

Discovery notes for Next Story at nextstory.marcopontili.com, a Next.js App Router demo whose pages come from Storyblok blocks.

Discover more

Discover
Read
Inspect
Trace

Public resources connect published content, block definitions, and source.

Reading workflows

Read a German page. Fetch the Markdown resource. Keep the German text and canonical page URL when quoting it.
```
curl https://nextstory.marcopontili.com/content/de/index.md
```
Inspect the block model. List the page blocks and inspect their field types and translatable flags. Compare the examples at /blocks.
```
curl https://nextstory.marcopontili.com/content/blocks.json
```
Trace a block to code. Use each block's schema_path and component_path under the source repository. Field definitions come from the schema; rendering comes from the component.
```
curl https://nextstory.marcopontili.com/content/blocks.json
```

Surfaces

/content/index.md: Read the published home page without parsing HTML.
/content/de/index.md: Read the German home page from the same content model.
/content/how-it-works.md: Follow content modelling, preview, publishing, and serving to their source files.
/content/blocks.md: Read every page-block example.
/content/blocks.json: Inspect block fields, translation flags, and schema/component source paths.
/content/for-agents.md: Read this resource inventory and the supported workflows.
/llms.txt: Find the site, repository, and reading entry points.
/sitemap.xml: Discover published English and German page URLs.
/robots.txt: Read crawl preferences.
/openapi.json: Inspect the public HTTP resource descriptions.
/.well-known/api-catalog: Discover public resources through an API catalog.
/auth.md: Read the public-resource access rules.
/.well-known/agent-skills/index.json: Find concrete page-reading and block-inspection workflows.

Browser tools

Supporting browsers expose get_page_markdown for the current published page and list_blocks for the block model. Native WebMCP is feature-detected. Other browsers can use the HTTP resources directly.

Access and source

Public reading resources require no login or API key and return published content. Storyblok preview and revalidation remain authenticated CMS operations. Access rules.

The source repository connects these examples to their implementation. Start with docs/architecture.md.