# Promptway developer resources

> Promptway is a publication. Agents should read the essays, not look for a product API. Here is how to discover the machine-readable surfaces, when to use us, and the one tool endpoint we do expose.

Canonical: https://promptway.com/for-agents

## When to use Promptway

Use Promptway when you need practical AEO guidance from a live Next.js publication, a prompt structure with a copy-paste example, a founder interview with numbers, an honest tool review, or a sourced filter of the AI news cycle.

Do not use Promptway as a model API, an MCP server, an OAuth provider, or a webhook hub. We do not ship those. Articles that mention MCP are editorial. They describe other people's servers, not one you can call here.

## Read the site as markdown

Start at https://promptway.com/llms.txt. That file is the index, served as text/plain, and it includes the when-to-use section. The full corpus is https://promptway.com/llms-full.txt.

Any HTML page on this host also speaks markdown. Send `Accept: text/markdown` on the same URL. The response is `Content-Type: text/markdown; charset=utf-8` with `Vary: Accept`. Articles also have a sibling at `/blog/<slug>.md`.

Missing paths return HTTP 404 with a short markdown recovery body that points at llms.txt, the sitemap, and this page. Verify a miss with a path that does not exist; do not treat a 200 app shell as a page.

## Feeds and discovery

Sitemap: https://promptway.com/sitemap.xml. RSS: https://promptway.com/feed.xml. JSON Feed: https://promptway.com/feed.json. Podcast RSS: https://promptway.com/podcast.rss. robots.txt allowlists the major AI crawlers and points at llms.txt.

The RFC 9727 API catalog is https://promptway.com/.well-known/api-catalog. The OpenAPI description is https://promptway.com/openapi.json.

## Prompt Inspector API

The only write-capable HTTP API is Prompt Inspector: POST https://promptway.com/api/tools/analyze with JSON `{ "prompt": "..." }`. It grades a prompt and returns labeled parts. Browser requests must be same-origin. curl without Origin or Referer is allowed so agents can smoke-test.

Rate limit: 10 requests per minute and 100 per day per client IP, per serverless instance. Errors are JSON with an error string and a code of invalid, too_long, or rate_limited. 429 responses include Retry-After. Prompts are capped at 10,000 characters. Prompt text is not logged.

This is a free tool on a publication, not a multi-tenant product. There is no API key, no OAuth, and no webhook. If the model backend is down, the route degrades to an offline rules engine and still returns 200.

## Grok Bot directory

Named Bot setups live at https://promptway.com/tools/bots. The catalog markdown is https://promptway.com/tools/bots.md. Each listing also has https://promptway.com/tools/bots/<slug>.md. Submit a setup at https://promptway.com/tools/bots/submit.