Tool

What it answers

Example question

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?"

Variable

Purpose

SITE_URL

Optional override for the site's own absolute origin. Not required — Vercel derives it automatically.

UPSTASH_REDIS_REST_URL, UPSTASH_REDIS_REST_TOKEN

Upstash Redis credentials backing /api/mcp rate limiting. Unset fails open (no limiting) rather than erroring.

RATELIMIT_MAX_REQUESTS, RATELIMIT_WINDOW_SECONDS

Override the MCP endpoint's rate-limit window.

CHAT_PROVIDER, CHAT_MODEL_ID

Select and pin the chat agent's model provider/id.

GOOGLE_GENERATIVE_AI_API_KEY

Required when CHAT_PROVIDER=google (the default).

ANTHROPIC_API_KEY

Required only when CHAT_PROVIDER=anthropic.

CHAT_SESSION_RATELIMIT_MAX_REQUESTS, CHAT_SESSION_RATELIMIT_WINDOW_SECONDS, CHAT_IP_RATELIMIT_MAX_REQUESTS, CHAT_IP_RATELIMIT_WINDOW_SECONDS, CHAT_AGENT_MAX_STEPS

Chat guardrail tuning — see apps/web/README.md "Chat guardrails".

DATABASE_URL

Neon Postgres connection string for the @hire-me-mcp/core/db module (migrations, ingestion, searchCareer). See packages/core/README.md.

NEON_API_KEY, NEON_PROJECT_ID

Create/delete a throwaway Neon branch for the DB integration test suite only — never used against the main database.