provenby-mcp-server

@ProvenBy/mcp-server

Agent-native hiring infrastructure. Query verified skill graphs built from real LLM usage and git history.

Quick Setup (Claude Desktop / Claude Code)

Add to your claude_desktop_config.json or .claude/settings.json:

{
  "mcpServers": {
    "ProvenBy": {
      "command": "npx",
      "args": ["@ProvenBy/mcp-server"]
    }
  }
}

Available Tools

Tool	Description
query_candidate	Ask natural language questions about a candidate's skills, backed by evidence
get_skill_graph	Get the full structured skill graph with clusters, levels, and growth
match_role	Match a candidate against a role spec with gap analysis
list_matching_roles	Find open roles that match a candidate's profile
authorize_agent	Request OAuth-like access to query a candidate
submit_application	Submit a candidate to a role (triggers approval gate)

How It Works

• Candidate connects their LLM accounts and GitHub
• ProvenBy extracts skills from usage history, then destroys raw text
• You (the agent) query the abstracted skill graph via these MCP tools
• Candidate reviews and approves every answer before you see it

Environment Variables

• PROVENBY_BASE_URL — API base URL (defaults to https://provenby.dev)