How osherai/bullhorn-mcp-python works
Bullhorn MCP exposes read-only CRM lookup tools to MCP-compatible assistants. The workflow runs from a client tool request through a registered server tool, which obtains a configured API client and returns formatted results. Tool stages cover job and candidate lists, individual records, Lucene searches, and SQL-like queries. Internally, configuration feeds OAuth/session management, while the REST client uses that session to call Bullhorn. Source excerpts support the core calls; broader entity coverage is documented in the README.
Main entry points: server.py MCP server · client.py REST client · auth.py OAuth sessions · config.py Environment config
Components 12
MCP interface
- MCP server
src/bullhorn_mcp/server.py - Job tools
src/bullhorn_mcp/server.py - Candidate tools
src/bullhorn_mcp/server.py - Record lookup
src/bullhorn_mcp/server.py - Lucene search
src/bullhorn_mcp/server.py - WHERE query
src/bullhorn_mcp/server.py
Configuration and auth
- Environment config
src/bullhorn_mcp/config.py - OAuth sessions
src/bullhorn_mcp/auth.py
CRM access
- REST client
src/bullhorn_mcp/client.py
Other components
- MCP-compatible assistant
- Bullhorn OAuth
- Bullhorn REST API
Connections 18
- MCP-compatible assistant → MCP server: sends tool requests
README.md - MCP server → Job tools: registers tools
src/bullhorn_mcp/server.py - MCP server → Candidate tools: registers tools
src/bullhorn_mcp/server.py - MCP server → Record lookup: registers tools
src/bullhorn_mcp/server.py - MCP server → Lucene search: registers tool
src/bullhorn_mcp/server.py - MCP server → WHERE query: registers tool
src/bullhorn_mcp/server.py - MCP server → Environment config: loads settings
src/bullhorn_mcp/server.py - MCP server → OAuth sessions: creates auth
src/bullhorn_mcp/server.py - MCP server → REST client: creates client
src/bullhorn_mcp/server.py - Job tools → REST client: searches jobs
src/bullhorn_mcp/server.py - Candidate tools → REST client: searches candidates
src/bullhorn_mcp/server.py - Record lookup → REST client: gets records
src/bullhorn_mcp/server.py - Lucene search → REST client: searches entities
src/bullhorn_mcp/server.py - WHERE query → REST client: queries entities
src/bullhorn_mcp/server.py - REST client → OAuth sessions: reads session
src/bullhorn_mcp/client.py - OAuth sessions → Environment config: uses credentials
src/bullhorn_mcp/auth.py - OAuth sessions → Bullhorn OAuth: authenticates and refreshes
src/bullhorn_mcp/auth.py - REST client → Bullhorn REST API: requests CRM data
src/bullhorn_mcp/client.py