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

aeoagent-skillsai-agentsastroclaudegsapllms-txtmcpmcp-servermodel-context-protocolportfoliosveltethreejswebgl
Stars
23★
Forks
4
Language
Astro
License
MIT
Created
2025-05-23
Last push
2026-08-17