---
title: Alex Greenshpun Developer Portal
description: Public read-only REST API, OpenAPI, MCP, A2A, NLWeb, WebMCP, and discovery.
canonical: https://alexgreenshpun.com/developers
last-updated: 2026-08-31
---

# Alex Greenshpun Developer Portal

The API exposes Alex Greenshpun's public professional profile and project
catalog. It is static and read-only. No account, API key, OAuth flow, payment, or
sandbox is needed because no operation can modify data.

## First call

    curl https://alexgreenshpun.com/api/v1/profile
    curl "https://alexgreenshpun.com/api/v1/search?q=agent+memory"

REST successes use JSON. REST errors include error.code, error.message, and
error.resolution. Mutation methods return HTTP 405.

## REST and OpenAPI

- API index: https://alexgreenshpun.com/api/v1
- OpenAPI 3.1.1: https://alexgreenshpun.com/openapi.json
- Profile: https://alexgreenshpun.com/api/v1/profile
- Projects: https://alexgreenshpun.com/api/v1/projects
- Search: https://alexgreenshpun.com/api/v1/search?q=security
- Health: https://alexgreenshpun.com/api/v1/health

List endpoints use an opaque nextCursor. Pass it back unchanged in cursor.

## MCP

Streamable HTTP endpoint: https://alexgreenshpun.com/mcp

The MCP server supports protocol 2026-07-28 and legacy 2025 clients. Tools:

- get_profile
- list_projects
- get_project
- search_site

All tools declare readOnlyHint and accept strict JSON Schemas. The server also
publishes profile, project, and developer-guide resources.

## NLWeb, A2A, and WebMCP

- NLWeb 0.55: https://alexgreenshpun.com/ask
- A2A endpoint: https://alexgreenshpun.com/a2a
- A2A card: https://alexgreenshpun.com/.well-known/agent-card.json
- WebMCP: four read-only tools are registered by /webmcp.js on the homepage

NLWeb accepts JSON and streams start, result, and complete events when requested.

## Authentication and safety

Authentication is intentionally absent. The service has no database, accepts no
uploads, and has no mutation route. Inputs are bounded. Unknown routes, methods,
tools, resources, and malformed payloads return typed errors without internal
details.

- Authentication policy: https://alexgreenshpun.com/auth.md
- Versioning and deprecation policy: https://alexgreenshpun.com/deprecation.md

## Discovery

- ARD 0.91: https://alexgreenshpun.com/.well-known/ard.json
- RFC 9727 API catalog: https://alexgreenshpun.com/.well-known/api-catalog
- MCP server card: https://alexgreenshpun.com/.well-known/mcp/server-card.json
- Agent skills: https://alexgreenshpun.com/.well-known/agent-skills/index.json
- Agent guide: https://alexgreenshpun.com/agents.md
- Schema Map: https://alexgreenshpun.com/schema-map.xml
- API llms.txt: https://alexgreenshpun.com/api/llms.txt
- Developer llms.txt: https://alexgreenshpun.com/developers/llms.txt