---
title: "Public API for agents"
description: "Read-only JSON API for AI agents: pricing, services, contact options and blog posts. No authentication. OpenAPI 3.1 at /openapi.json."
canonical: https://www.anthonyhunts.com/developers
last-updated: 2026-09-24
---
# Public API for agents

> Read-only JSON API for AI agents: pricing, services, contact options and blog posts. No authentication. OpenAPI 3.1 at /openapi.json.

## Endpoints

- `GET https://www.anthonyhunts.com/api/v1/pricing` — plans and add-ons with prices in USD
- `GET https://www.anthonyhunts.com/api/v1/capabilities` — services offered, with a URL for each
- `GET https://www.anthonyhunts.com/api/v1/contact` — email, phone, WhatsApp and booking link
- `GET https://www.anthonyhunts.com/api/v1/posts?limit=20&cursor=&lang=es` — blog posts with cursor pagination (`next_cursor`)
- Any public page as Markdown: send `Accept: text/markdown` or append `.md`

- `POST https://www.anthonyhunts.com/api/v1/batch` — up to 20 GET paths in one request
- `POST https://www.anthonyhunts.com/ask` — NLWeb natural-language search; `"streaming": true` for SSE
- Docs MCP server: https://www.anthonyhunts.com/api/mcp/docs (search_docs, get_page)
- Agent kit (skills, Agent Plugin, AGENTS.md, CLI): https://github.com/anthonyhunts/shaart-agent-kit
- CLI and SDK on npm: `npx anthony-hunt` (https://www.npmjs.com/package/anthony-hunt) and `shaart-agency` (https://www.npmjs.com/package/shaart-agency)

## Errors

RFC 9457 `application/problem+json` with a stable `code`: `not_found`, `invalid_limit`, `invalid_cursor`, `invalid_lang`, `method_not_allowed`, `internal_error`.

## Versioning

Major version in the path (`/api/v1`). Breaking changes ship as `/api/v2`; v1 stays available for at least 6 months after that.

## Deprecation policy

Before a version or endpoint is retired, its responses carry `Deprecation` (RFC 9745) and `Sunset` (RFC 8594) headers at least 6 months ahead. Nothing is deprecated today.

## MCP server

Read-only, Streamable HTTP, no authentication: https://www.anthonyhunts.com/api/mcp. Tools: get_pricing, list_services, get_contact_options, list_posts. Server card: https://www.anthonyhunts.com/.well-known/mcp/server-card.json. Listed on Smithery: https://smithery.ai/servers/anthonyhunts01/shaart-agency

## Authentication

None. See https://www.anthonyhunts.com/auth.md. Booking and payment are done by a person: hand the user https://www.anthonyhunts.com/agenda.