# Kyle Romero (kgromero.com)

> Kyle Romero (kgromero.com) is a free MCP server for productivity. Personal MCP server that answers questions about one developer's resume and portfolio. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI
- **Website:** https://kgromero.com/api-docs
- **Repository:** https://github.com/romero927/kgromero-mcp
- **MCP Registry name:** io.github.romero927/kgromero-mcp
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

This is a single-person portfolio exposed as MCP tools, so an assistant can answer questions about Kyle Romero's career, skills, side projects and documents instead of a visitor reading the site. The tools cover profile, contact details, employer-by-employer experience with full highlights and tech stack, a title timeline including promotions, education, skills by category, interests and places lived or visited.

It can also read published documents: PDF text, diagrams and slides as images, and PDF pages rendered as images, up to five per call. A keyword search spans everything, and an assess_job_fit prompt compares the resume with a pasted job posting.

The hosted endpoint is https://kgromero.com/mcp, read-only with no sign-in, or `uvx kgromero-mcp` runs it locally over stdio. Data comes from the live site and is cached for an hour, with a bundled snapshot as fallback; the same data is available as JSON from the site's REST endpoints.

## Features

- **Experience details:** List employers and read full highlights and tech stack for a role.
- **Career timeline:** Every title held, including promotions.
- **Document reading:** Reads PDF text and returns diagrams or PDF pages as images.
- **Job-fit prompt:** assess_job_fit compares the resume to a job description.
- **Keyword search:** Search across all resume and site data.
- **Local or hosted:** Use the hosted URL or run the PyPI package over stdio.

## Good for

- Ask what the developer has built with AWS
- Check fit against a job description
- Read architecture diagrams from a past project
- Summarize leadership experience for a hiring decision

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http kgromero-mcp https://kgromero.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://kgromero.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "kgromero-mcp": {
      "url": "https://kgromero.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "kgromero-mcp": {
      "type": "http",
      "url": "https://kgromero.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "kgromero-mcp": {
      "serverUrl": "https://kgromero.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "kgromero-mcp": {
      "type": "http",
      "url": "https://kgromero.com/mcp"
    }
  }
}
```

## Tools

- `get_profile`: Title, summary, location, current role and years of experience.
- `get_contact`: Email, phone and profile links.
- `list_experience`: One entry per employer with dates and length.
- `get_experience`: Full highlights and tech stack for a role.
- `get_career_timeline`: Every title held, including promotions.
- `get_education`: Degrees.
- `get_skills`: Skills by category and where they were used.
- `list_side_projects`: Personal projects with GitHub links.
- `list_documents`: Resume downloads and portfolio documents.
- `get_document`: Reads a document as PDF text or images.
- `get_interests`: Hobbies and favorite tech news sites.
- `get_travel`: Places lived and visited.
- `search`: Keyword search across all content.

## FAQ

### Do I need to sign in?

No. The hosted server is read-only with no sign-in.

### Can I run it offline?

Yes. Setting KGROMERO_OFFLINE=1 uses the bundled snapshot instead of the network.

### How fresh is the data?

It is fetched from the live site and cached for an hour.

### Is there a REST API too?

Yes, /api/resume returns JSON Resume format and /api/site.json returns the rest of the home page data.

### Is Kyle Romero (kgromero.com) free?

Yes. Kyle Romero (kgromero.com) is free to use.

### How do I add Kyle Romero (kgromero.com) to Claude Code?

Run this command in your terminal: claude mcp add --transport http kgromero-mcp https://kgromero.com/mcp

### What are the best alternatives to Kyle Romero (kgromero.com)?

The closest alternatives to Kyle Romero (kgromero.com) are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/kyle-romero-kgromero-com
