# talogen.dev — Developer & AI Agent Resources

> Machine-readable access to Tal Ogen's portfolio: a read-only REST API, an OpenAPI 3.1 spec, an MCP server with a human-contact tool, and no authentication anywhere.

## Quickstart

- `GET https://talogen.dev/api/v1` — endpoint directory
- `GET https://talogen.dev/api/v1/profile` — profile (headline, summary, contact, skills, strengths)
- `GET https://talogen.dev/api/v1/projects` — project summaries (`?tag=`, `?flagship=true`)
- `GET https://talogen.dev/api/v1/projects/{id}` — full problem → solution → result detail
- `GET https://talogen.dev/api/v1/agents` — autonomous-agent summaries
- `GET https://talogen.dev/api/v1/candidate` — hiring facts (availability, target roles, location)

OpenAPI spec: https://talogen.dev/openapi.json (operationIds, typed schemas, documented errors).
Errors are JSON: `{"error": {"code", "message", "hint"}}` — a 404 on an unknown id lists all valid ids.

## MCP server

Endpoint: https://talogen.dev/mcp (streamable HTTP, stateless, no auth).
Discovery: https://talogen.dev/.well-known/mcp (GET → manifest, POST → handshake).
Server card: https://talogen.dev/.well-known/mcp/server-card.json
Tools: get_profile, list_projects, list_agents, get_project, contact_recruiter (the only write action — delivers a message to a human; requires reply_to).

## Authentication

None — no API keys, no OAuth, no registration. Walkthrough: https://talogen.dev/auth.md. You will never receive a 401 or 403.

## Rate limits & sandbox

No enforced quota; responses are CDN-edge-cached. Reads are side-effect-free, so the live API is its own sandbox. Don't test contact_recruiter — it delivers real messages and is rate-limited upstream.

## Versioning

/api/v1 is stable. Breaking changes ship as /api/v2 with ≥90 days of overlap, announced via RFC 8594 Sunset headers.

## Discovery surfaces

- https://talogen.dev/llms.txt — site overview with when-to-use guidance
- https://talogen.dev/.well-known/agent.json — all entry points
- https://talogen.dev/.well-known/ard.json — Agentic Resource Discovery catalog
- https://talogen.dev/.well-known/agent-skills/index.json — agent skills index
- https://talogen.dev/.well-known/api-catalog — RFC 9727 API catalog
- Source: https://github.com/TALOGEN777/general-portfolio (AGENTS.md for coding agents)