@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

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

Environment Variables

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