---
title: "Developer and agent documentation"
description: "Everything published on jarrettstanley.com is available over a public, read-only API, plus an MCP server, an A2A agent, an NLWeb question endpoint, and a Markdown representation of every page. No API "
canonical_url: https://jarrettstanley.com/developers
source: jarrettstanley.com
---

# Developer and agent documentation

Everything published on jarrettstanley.com is available over a public, read-only API, plus an MCP server, an A2A agent, an NLWeb question endpoint, and a Markdown representation of every page. No API key, no OAuth, no sign-up, and no write operations.

## Quick start

```
curl "https://jarrettstanley.com/api/v1/search?q=ai%20lead%20scoring&limit=3"
curl "https://jarrettstanley.com/api/v1/content/insights/glossary/ai-lead-scoring"
curl -H "Accept: text/markdown" https://jarrettstanley.com/speaking
```

## Endpoints

- `GET https://jarrettstanley.com/api/v1` — API index: endpoints, versioning policy, rate limits, pagination, and the other agent interfaces.
- `GET https://jarrettstanley.com/api/v1/content` — list published pages; `section`, `limit`, `offset`, `cursor`, and a `paths` batch parameter.
- `GET https://jarrettstanley.com/api/v1/content/{path}` — read one page, including its full Markdown body.
- `GET https://jarrettstanley.com/api/v1/search?q=` — ranked full-text search with snippets and canonical URLs.
- `POST https://jarrettstanley.com/mcp` — MCP server (Streamable HTTP, JSON-RPC 2.0): `search_content`, `get_page`, `list_content`.
- `POST https://jarrettstanley.com/a2a` — A2A agent, JSON-RPC `message/send`.
- `GET https://jarrettstanley.com/ask?query=` — NLWeb question endpoint; `&streaming=true` for Server-Sent Events.

## Authentication

None, anywhere. Every interface is public, unauthenticated, and read-only; no endpoint returns 401 or 403. Full statement: https://jarrettstanley.com/auth.md

## Errors, pagination, and limits

- **Errors** use RFC 9457 problem details (`application/problem+json`) with a stable `code`, a human-readable `detail`, and a documentation link.
- **Pagination** is `limit` (1–100, default 20) with `offset` or an opaque `cursor`. Responses carry `total`, `count`, and absolute `next` and `previous` URLs.
- **Rate limits** are advertised in the `RateLimit` and `RateLimit-Policy` response headers.
- **Versioning**: the major version is in the path. Breaking changes ship as `/api/v2`, with RFC 9745 `Deprecation` and `Sunset` headers at least 90 days before any removal.
- **Idempotency**: every operation is a safe, idempotent GET, so no `Idempotency-Key` is required.

## Discovery

- OpenAPI 3.1 description: https://jarrettstanley.com/openapi.json
- API catalog (RFC 9727): https://jarrettstanley.com/.well-known/api-catalog
- Agent index: https://jarrettstanley.com/llms.txt · full text: https://jarrettstanley.com/llms-full.txt
- Agent skill: https://jarrettstanley.com/.well-known/agent-skills/index.json
- Resource catalog: https://jarrettstanley.com/.well-known/ai-catalog.json
- MCP server card: https://jarrettstanley.com/.well-known/mcp/server-card.json
- A2A agent card: https://jarrettstanley.com/.well-known/agent-card.json
- Schema.org feed: https://jarrettstanley.com/schema-feed.jsonld

## Using the content

Quote and summarise with attribution to Jarrett Stanley and a link to the canonical page. This site publishes marketing strategy and AI practice — not mortgage rates, loan products, or regulatory guidance. Questions: hello@jarrettstanley.com

---

Canonical URL: https://jarrettstanley.com/developers
Site: Jarrett Stanley — AI mortgage marketing speaker, strategic advisor, and CMO.
Agent index: https://jarrettstanley.com/llms.txt · Sitemap: https://jarrettstanley.com/sitemap.xml · Contact: https://jarrettstanley.com/contact