Nicholas Adamou developer resources

nicholasadamou developer resources — versioned content API, OpenAPI, MCP server, official CLI, and Markdown negotiation for agents and developers working with Nicholas Adamou's site. Public surfaces are read-only and require no API key.

Start here

  • llms.txt

    Site map for AI agents — when to use this site, page index, and developer links.

  • OpenAPI

    OpenAPI 3.1 description of the public /api/v1 Nicholas Adamou content API.

  • API catalog

    RFC 9727 linkset pointing agents at the OpenAPI document.

  • MCP server

    Streamable HTTP MCP endpoint exposing search, notes, projects, and docs as tools.

  • MCP registry manifest

    server.json for MCP registries and remote clients.

  • MCP server card

    Server card (also /.well-known/mcp and /.well-known/mcp/server-card.json).

  • AI Catalog

    Domain-level MCP discovery entry point.

  • Sitemap

    Full list of indexable URLs.

  • robots.txt

    Crawler access rules.

Public content API

Stable REST operations use URL path versioning under /api/v1.

  • GET /api/v1/search?q={query}
  • GET /api/v1/notes
  • GET /api/v1/notes/{slug}
  • GET /api/v1/projects

Legacy GET /api/search remains as a deprecated alias with Deprecation and Sunset headers.

Structured errors

Public /api/v1 errors use RFC 9457 application/problem+json with a stable code, detail, and resolution hint.

invalid_query · 400
Pass the documented query parameter (for example q).
note_not_found · 404
List notes or search, then retry with a valid slug.
method_not_allowed · 405
Use GET on read-only endpoints.
api_route_not_found · 404
Recover via OpenAPI or the API catalog.
internal_error · 500
Retry shortly; do not invent alternate endpoints.

Versioning and deprecation

Stable REST operations use a major version in the URL, beginning with /api/v1. Backward-compatible fields may be added within v1; breaking changes require a new major path. Deprecations are signaled with RFC 9745 Deprecation and Link headers. A dated Sunset header is announced at least 90 days before removal.

CLI

Official npm package nicholasadamou:

npx nicholasadamou search <query>
npx nicholasadamou notes
npx nicholasadamou note <slug>
npx nicholasadamou projects
npx nicholasadamou docs

Add --json for the unchanged API response and structured problem+json errors.

MCP server

Connect a Streamable HTTP MCP client to https://nicholasadamou.com/mcp. Tools: nicholasadamou_search, nicholasadamou_list_notes, nicholasadamou_get_note, nicholasadamou_list_projects, nicholasadamou_get_developer_docs.

Content as Markdown

Request any of these pages with Accept: text/markdown (see acceptmarkdown.com). Responses use Content-Type: text/markdown; charset=utf-8 and Vary: Accept.

HomeAboutProjectsNotesContactPrivacy

Open-source and writing

  • Projects — open-source projects and developer tools built by Nicholas Adamou.
  • Notes — technical writing on software engineering, architecture, and developer tools.
  • GitHub — source repositories.

Authentication and writes

The documented JSON API, CLI, and MCP tools are public and read-only. They require no API key or OAuth flow and do not provide writes, webhooks, or event subscriptions.