io.github.rubenmarcus/portfolio MCP Server

This Model Context Protocol (MCP) server provides a public portfolio interface focused on resume information and related details. It supports use cases such as resume reading, services and availability discovery, project evidence access, and introductions. The server is available under the slug io-github-rubenmarcus-portfolio and exposes 4 tools.

🛠️ Key Features

Public portfolio MCP for resume, services, availability, project evidence, and introductions
Exposes 4 tools
Includes an agent-readable approach so AI agents can access content without rendering the page

🚀 Use Cases

Retrieve resume content
Find services and current availability
Review project evidence
Access introductions

⚡ Developer Benefits

Built for the Model Context Protocol (mcp, model-context-protocol)
Topics include mcp-server and ai-agents, indicating agent integration focus

⚠️ Limitations

Limited to what the portfolio content covers (resume, services, availability, project evidence, introductions)

📚 Tech Stack (as described)

Astro 5 (islands, content collections, i18n EN/PT)
Svelte 5 (runes) for interactive components
Three.js

{ "type": "object", "properties": { "name": { "type": "string", "description": "Contact person's name" }, "contact": { "type": "string", "description": "Email or Telegram handle" }, "brief": { "type": "string", "description": "What they want to build" }, "budget": { "type": "string", "description": "Optional budget range" }, "agent": { "type": "string", "description": "Calling agent (claude, chatgpt, kimi...)" } }, "required": [ "name", "contact", "brief" ] }

Features

Hero with an AI-generated, auto-rigged 3D character that types at a desk and dissolves through render states (contour isolines → wireframe → scanline point cloud → ASCII) driven by scroll

Live HUD telemetry fed by GitHub/npм stats, degrading gracefully offline

Bilingual blog (EN + PT mirrors) with generated particle-art covers, copy-button code blocks, view counter (optional Supabase)

/api/mcp — a hand-rolled JSON-RPC 2.0 MCP server (tools/list, tools/call) exposing resume data and a book_intro tool

/api/hire — contact endpoint with field caps + honeypot, relayed via formsubmit.co

llms.txt, robots.txt with AI-crawler rules, RSS (EN/PT), sitemap with hreflang, JSON-LD — built for answer engines, not just search

Edge middleware easter egg: curl rubenmarcus.dev returns a plain-text resume

Bottom-right audio deck (YouTube IFrame API) persisted across page transitions

Visual QA gauntlet (scripts/visual-gauntlet.mjs) that screenshots every page on desktop + mobile and captures console errors

Project structure

code

src/
  components/        # Svelte/Astro components (hero, deck, cards, lab demos)
  content/           # blog (EN) + blog-pt collections, zod-validated
  layouts/           # BaseLayout: SEO, OG, JSON-LD, analytics, audio deck
  lib/               # data (projects, agents, tools), three/, motion/, assets/
  pages/
    api/             # hire.ts, mcp.ts, resume.json.ts, resume.txt.ts
    pt/              # PT mirrors of every page
    work/            # case studies
  middleware.ts      # edge: curl user-agent → text resume
scripts/             # asset generators (OpenRouter) + text-gate + visual gauntlet
public/art/          # generated covers, logos, frames
qa/                  # gauntlet shots + scoring log

Install

Tools (4)

get_resumeget_servicescheck_availabilitybook_intro

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://www.rubenmarcus.dev/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "portfolio": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.rubenmarcus.dev/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Ruben Marcus — Agent-Ready Portfolio

io.github.rubenmarcus/portfolio MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

📚 Tech Stack (as described)

Topics

get_resume

get_services

check_availability

book_intro

rubenmarcus.dev

Stack

Features

Getting started

Environment variables

Project structure

License

Install

Remote endpoint

Related servers

name	string	required	Contact person's name
contact	string	required	Email or Telegram handle
brief	string	required	What they want to build
budget	string	optional	Optional budget range
agent	string	optional	Calling agent (claude, chatgpt, kimi...)