rubenmarcus/portfolio
View on GitHub ↗Agent-ready portfolio of Ruben Marcus, AI Fullstack Engineer. A cinematic WebGL site for humans and a protocol surface for agents: a remote MCP server (io.github.rubenmarcus/portfolio, on the official MCP Registry), a public Agent Skill, llms.txt and a plain-text resume over curl. Built with Astro 5, Svelte 5, Three.js and GSAP.
23 ★4 forksAstroUpdated 18d ago
What you need to know
Agent-ready personal portfolio site (Astro 5 + Svelte 5 + Three.js) that also runs a hand-rolled JSON-RPC 2.0 MCP server at /api/mcp, exposing resume data and a book_intro tool so AI agents can learn about the author and book a call without rendering the page.
Install
Connect any MCP client to the live /api/mcp JSON-RPC 2.0 endpoint (tools/list + tools/call) on rubenmarcus.dev. To run locally: pnpm install && pnpm dev; production build is pnpm build && pnpm preview.
Usage
- •Agents query resume/project data and call book_intro through the /api/mcp endpoint.
- •GET /api/hire is the human-facing contact endpoint (field caps + honeypot, relayed via formsubmit.co).
- •Easy AI discovery: llms.txt, AI-crawler rules in robots.txt, RSS (EN/PT), hreflang sitemap, JSON-LD.
- •curl rubenmarcus.dev returns a plain-text resume via an edge middleware easter egg.
Key features
- ✓Bilingual blog (EN/PT mirrors) with generated particle-art covers, copy-button code blocks, optional Supabase view counter.
- ✓Cinematic 3D hero with an auto-rigged character that dissolves through contour/wireframe/scanline point-cloud/ASCII render states.
- ✓Live HUD telemetry from GitHub/npm stats with graceful offline degradation.
- ✓Visual QA gauntlet screenshots every page on desktop + mobile and captures console errors.
- ✓Deployed on Vercel with edge middleware and Analytics; MIT licensed.
Best for
AI agents (and humans) looking up a portfolio author's resume and booking an intro call through MCP.
Caveats
- ⚠The MCP surface is intentionally small — resume data plus book_intro; it is a personal portfolio, not a general-purpose server.
- ⚠Optional features degrade gracefully without env vars (OPENROUTER_API_KEY only powers asset-generation scripts).
Platforms: Remote · Web
Reviewed 2026-08-18
Topics
- Stars
- 23★
- Forks
- 4
- Language
- Astro
- License
- MIT
- Created
- 2025-05-23
- Last push
- 2026-08-17