---
title: Developers — machine-readable portfolio
description: Every machine-readable surface of rubenmarcus.dev — MCP server, REST API, OpenAPI, discovery manifests, agent skills, content negotiation.
canonical: https://www.rubenmarcus.dev/developers
last-updated: 2026-08-27
---

# Developers — machine-readable portfolio

Everything here is public, unauthenticated, and documented.

## MCP server

`POST https://www.rubenmarcus.dev/api/mcp` — Streamable HTTP JSON-RPC. No authentication.

- Server card: https://www.rubenmarcus.dev/.well-known/mcp
- Registry format: https://www.rubenmarcus.dev/.well-known/mcp/server.json
- Official MCP Registry: `io.github.rubenmarcus/portfolio`
- Tools: `get_resume`, `get_services`, `check_availability`, `book_intro`

## REST API

- OpenAPI 3.1: https://www.rubenmarcus.dev/openapi.json
- https://www.rubenmarcus.dev/api/resume.json — structured resume
- https://www.rubenmarcus.dev/api/resume.txt — plain-text resume
- https://www.rubenmarcus.dev/api/health — health probe
- https://www.rubenmarcus.dev/api/stats — public telemetry
- https://www.rubenmarcus.dev/api/hire — project briefs (POST, Idempotency-Key supported)
- https://www.rubenmarcus.dev/api/subscribe — newsletter (POST)

All endpoints answer typed JSON errors, send RateLimit headers, accept CORS from any origin.

## Discovery manifests

- https://www.rubenmarcus.dev/.well-known/api-catalog — RFC 9727
- https://www.rubenmarcus.dev/.well-known/ard.json — ARD manifest
- https://www.rubenmarcus.dev/.well-known/agent-skills/index.json — Agent Skills index
- https://www.rubenmarcus.dev/llms.txt · /llms-full.txt · /ai-index.json · /docs.json

## Content negotiation

Every page answers `Accept: text/markdown` with a Markdown twin. Terminal user agents get the plain-text resume on any page route.

## Auth

Nothing requires credentials. An OAuth discovery shim exists for MCP clients that insist on the handshake; it auto-approves. See https://www.rubenmarcus.dev/auth.md