English Français العربية

Kyle Romero (kgromero.com)

Official registry Other

Ask about Kyle Romero's experience, skills, projects, and portfolio from kgromero.com.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http kyle-romero-kgromero-com 'https://kgromero.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "kyle-romero-kgromero-com": {
            "type": "http",
            "url": "https://kgromero.com/mcp"
        }
    }
}
PYPI package kgromero-mcp
Claude Code 
claude mcp add kyle-romero-kgromero-com -- uvx kgromero-mcp==0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "kyle-romero-kgromero-com": {
            "command": "uvx",
            "args": [
                "kgromero-mcp==0.1.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. kgromero-mcp
  2. Use it
  3. How it works
  4. Tools
  5. Run it locally
  6. Deployment
  7. Releasing
  8. Development

kgromero-mcp

An MCP server for kgromero.com. It lets AI assistants (Claude, Cursor, etc.) answer questions about Kyle Romero's experience, skills, projects, and portfolio from the content on the site.

Use it

The server is hosted at https://kgromero.com/mcp (Streamable HTTP, read-only, no sign-in).

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

In Claude (web/desktop): Settings → Connectors → Add custom connector → paste the URL. In Cursor and other clients:

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

Or run it locally from PyPI over stdio:

uvx kgromero-mcp
{ "mcpServers": { "kgromero": { "command": "uvx", "args": ["kgromero-mcp"] } } }

It's also listed in the MCP Registry as io.github.romero927/kgromero-mcp.

How it works

Data comes from the live site and is cached for an hour:

  • https://kgromero.com/api/resume: resume in JSON Resume format
  • https://kgromero.com/api/site.json: the rest of the home page (title timeline, skill categories, side projects, documents, interests, travel)
  • https://kgromero.com/kgromero.md: resume as Markdown

If the site can't be reached, the server uses the copies bundled in src/kgromero_mcp/snapshot/.

Tools

ToolWhat it returns
get_profileName, title, summary, about, location, current role, years of experience
get_contactEmail, phone, LinkedIn/GitHub/Keyoxide, vCard link
list_experienceOne entry per employer with dates and length
get_experience(company_or_id)Full highlights and tech stack for a role
get_career_timelineEvery title held, including promotions
get_educationDegrees
get_skills(filter?)Skills by category, and tech used on the job with where and how recently
list_side_projectsPersonal projects with GitHub links
list_documents(group?)Resume downloads plus the portfolio (diagrams, write-ups, lab reports) by employer
get_interestsHobbies and favorite tech news sites
get_travel(lived_only?)Places lived and visited
search(query)Keyword search across all of the above

Resources: resume://kgromero/json, resume://kgromero/markdown, resume://kgromero/site

Prompt: assess_job_fit(job_description): compares the resume to a job posting.

Run it locally

python3 -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/kgromero-mcp            # stdio (for local clients)
.venv/bin/kgromero-mcp --http     # Streamable HTTP at http://127.0.0.1:8000/mcp
Claude Code
claude mcp add kgromero -- /path/to/kgromero-mcp/.venv/bin/kgromero-mcp
Claude Desktop / other clients
{
  "mcpServers": {
    "kgromero": { "command": "/path/to/kgromero-mcp/.venv/bin/kgromero-mcp" }
  }
}
Settings
Env varDefaultPurpose
KGROMERO_SITE_URLhttps://kgromero.comPoint at another deployment, e.g. http://localhost:5173
KGROMERO_OFFLINEunsetSet to 1 to skip the network and use the bundled snapshot

Deployment

Runs on Fly.io as the kgromero-mcp app (Dockerfile, fly.toml). The machine stops when idle and starts on the next request. kgromero.com/mcp forwards to https://kgromero-mcp.fly.dev/mcp through a route in the site repo (src/routes/mcp/+server.js).

fly deploy --remote-only

Releasing

  1. Bump the version in pyproject.toml and in both places in server.json.
  2. Commit, then git tag vX.Y.Z && git push origin vX.Y.Z.

.github/workflows/publish.yml checks the versions match the tag, runs the tests, publishes to PyPI, and then updates the MCP Registry listing. PyPI uses trusted publishing (GitHub environment pypi) and the registry uses GitHub OIDC, so no secrets are stored.

Development

.venv/bin/pytest

Tests run offline against the snapshot. To refresh it after editing the site:

curl -s https://kgromero.com/api/resume    > src/kgromero_mcp/snapshot/kgromero.json
curl -s https://kgromero.com/api/site.json > src/kgromero_mcp/snapshot/site.json
curl -s https://kgromero.com/kgromero.md   > src/kgromero_mcp/snapshot/kgromero.md

Frequently asked questions

What is Kyle Romero (kgromero.com)?

Ask about Kyle Romero's experience, skills, projects, and portfolio from kgromero.com.

How do I install Kyle Romero (kgromero.com)?

It runs as a remote server. In Claude Code: claude mcp add --transport http kyle-romero-kgromero-com 'https://kgromero.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Kyle Romero (kgromero.com) need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Kyle Romero (kgromero.com) open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Kyle Romero (kgromero.com)?

It is published by romero927. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.