Skip to main content
hire-me-mcp

Add me to your AI

This is a live Model Context Protocol (MCP) server — a public, read-only, anonymous endpoint that exposes Marcos Alvarez's real career data (profile, work history, projects and skill evidence) as tools any MCP-compatible AI assistant can call directly. Connect it once, then ask your assistant about his experience the same way you'd ask it to use any other tool — every answer comes back grounded in the same data this site is built from, with citations.

https://hire-me-mcp-web.vercel.app/api/mcp

Connect your client

In Claude, go to Settings (or Customize) → Connectors → "+" → "Add custom connector", paste the URL below, skip Advanced settings (no auth is required), then click Add.

https://hire-me-mcp-web.vercel.app/api/mcp

Available tools

Every tool below is read straight from this server's live registry — if a tool is ever added, removed or renamed, this list changes with it.

  • ping

    Diagnostic tool that returns 'pong'. Use it to verify the MCP connection is working before calling any other tool. Do not use it to check the health or freshness of any career-data source — it has no dependency on career data and always succeeds.

    Ping the hire-me-mcp server to make sure the connection works.

  • get-profile

    Returns Marcos Alvarez's single profile record — name, headline, location, availability and a short bio — as one object, with citations backing it. Use this to answer 'who is this person' or 'what is their current availability/location' at a glance. Do not use it for role-by-role work history (use get-experience), specific project details (use search-projects), or to check whether a particular skill or technology is claimed (use get-skill-evidence). Takes no input. There is no 'no result' outcome in normal operation — this server's dataset always has exactly one profile.

    Who is Marcos Alvarez, and is he currently open to new roles?

  • get-experience

    Returns every entry from Marcos Alvarez's work history matching an optional structured filter — company, technology tags, a YYYY-MM date range, and current/past status — as a list ordered most recent first, each entry with a citation. Use this to answer 'what did they do at company X', 'what did they work on in year Y', or 'what are they doing now'. Called with no filter fields, it returns the full history. Do not use it for the single profile summary (use get-profile), to search project descriptions by keyword (use search-projects), or to check whether one named skill is claimed (use get-skill-evidence). A filter matching no roles returns a successful result with an empty list, not an error.

    What has Marcos worked on since 2022? Walk me through his recent roles.

  • search-projects

    Searches Marcos Alvarez's project portfolio by keyword and/or technology tag and returns ranked matches, each with a relevance score, a matched-field explanation, and a citation. Matching is deterministic keyword/tag search against project names, summaries, bodies and tech tags — there is no semantic or embedding-based understanding of the query today. Use this when asked to find or describe specific projects, e.g. 'show me projects that used React' or 'what did they build with Kubernetes'. Do not use it for a chronological work history (use get-experience) or to check whether a skill is claimed at all, evidence or gap (use get-skill-evidence). A query matching no projects returns a successful result with an empty list, not an error; an empty or whitespace-only query behaves the same way.

    Show me projects where Marcos used TypeScript or Kubernetes.

  • get-skill-evidence

    Looks up a single named skill or technology and reports one of three honest outcomes: 'claimed' (the skill with its supporting evidence), 'not-claimed' (an explicit, acknowledged gap with its own statement and related skills), or 'unknown' (the term matches neither). Use this when asked 'do you know X' or 'have you worked with Y' about one specific technology. Do not use it to browse the full skill list (there is no such tool in this server) or to search project descriptions for a keyword (use search-projects instead), and it is not a substitute for get-experience when the question is about a role or company rather than a single skill. A 'not-claimed' or 'unknown' result is a normal, successful answer, not an error — relay it honestly rather than retrying or hallucinating around it.

    Has Marcos worked with event-driven architectures? Show me the evidence.

  • search-career

    Runs a fuzzy, semantic search over the full text of Marcos Alvarez's career content (experience, projects, skills, writing) and returns ranked excerpts, each with a relevance score and a citation, or an explicit 'no relevant content found' result when nothing clears the similarity threshold. Use this for open-ended, cross-cutting, or conceptual questions a structured lookup can't answer directly — e.g. 'has he worked with event-driven architectures', 'what's his experience with leading teams', 'anything about cost optimization'. Do not use it when the question maps onto a specific, structured lookup the deterministic tools already answer exactly: get-profile for who he is, get-experience for a role/company/date-range work history, search-projects for keyword/tag project search, and get-skill-evidence to check one specific named skill or technology — prefer those first, and fall back to this tool only when they don't fit. This tool is more expensive per call (it embeds the query) and subject to the same more expensive per call (it embeds the query) and subject to the same server-wide rate limit as every other tool here — don't call it repeatedly for the same question.

    What's Marcos's experience with leading engineering teams and mentoring?

See it in action

A short recorded demo isn't available yet — this is a hand-written, illustrative sample transcript of a real question this server can answer, not a screenshot or actual recording of a session.

  • YouHas Marcos worked with event-driven architectures? Show me evidence.
  • ClaudeCalling get-skill-evidence({ term: "event-driven architecture" }) on the hire-me-mcp server… Yes — claimed, with 2 sources: the mcp-gateway-service role (2022–2024) and the search-projects entry for "Order Events Pipeline". Want the details of either?

Troubleshooting and limits

This endpoint is public and requires no authentication. If a client can't connect, double check it supports the MCP Streamable HTTP transport and that the URL above was copied in full. For current rate-limit behavior, see the "Rate limiting" section of the app README.