# Luciano Lazarte developer resources

This is the developer portal for **Luciano Lazarte** on **Vercel** (`lucianolazarte.vercel.app`). Use it when an agent or engineer needs machine-readable access to the portfolio: OpenAPI, MCP, GitHub activity, and the educational Markowitz optimizer.

## When to use these APIs

- Retrieve Luciano Lazarte's public profile, projects, and contact channels.
- Call the GitHub activity proxy instead of scraping the homepage.
- Run the portfolio optimizer against BYMA / CEDEAR / Argentine bond tickers.
- Connect Claude, ChatGPT, or other MCP clients via Streamable HTTP.

## Predictable URLs

| Resource | URL |
| --- | --- |
| OpenAPI 3 spec | https://lucianolazarte.vercel.app/openapi.json |
| MCP Streamable HTTP | https://lucianolazarte.vercel.app/mcp |
| MCP live handshake | https://lucianolazarte.vercel.app/.well-known/mcp |
| MCP server card | https://lucianolazarte.vercel.app/.well-known/mcp/server-card.json |
| GitHub activity API | https://lucianolazarte.vercel.app/api/github |
| Portfolio optimizer API | https://lucianolazarte.vercel.app/api/portfolio/optimize |
| Agent index | https://lucianolazarte.vercel.app/llms.txt |
| Sitemap | https://lucianolazarte.vercel.app/sitemap.xml |

No API key is required. All developer resources are public, read-only except `POST /api/portfolio/optimize`. Auth docs: there is no OAuth or API key on this personal site; do not send secrets.

## GitHub activity (GET /api/github)

Returns public repo count, language mix, recent pushes, and featured live demos. Cached ~1 hour. User-Agent: identify your client.

## Portfolio optimizer (POST /api/portfolio/optimize)

JSON body: `{ "tickers": ["GGAL", "YPFD"] }` (2–10 BYMA stocks, CEDEARs, or Argentine bonds). Response: aligned ARS close-price series from data912.com. Educational use only.

## MCP

POST JSON-RPC `initialize` to https://lucianolazarte.vercel.app/mcp or https://lucianolazarte.vercel.app/.well-known/mcp with `Accept: application/json, text/event-stream`. Tools: `get_profile`, `list_projects`, `get_contact`, `list_developer_resources`.

## Markdown

The same HTML URLs honor `Accept: text/markdown` (acceptmarkdown.com) and `*.md` aliases. Responses include `Vary: Accept, Accept-Encoding`.