# Bullhorn MCP for AI Agents AI Agent Connect > Bullhorn MCP connects your Bullhorn ATS and CRM to any AI agent. You can manage candidates, job orders, and client contacts through natural conversation. It allows your agent to retrieve, create, update, and delete entities and corporate notes directly, removing the need to navigate complex ATS menus manually. ## Overview - **Category:** human-resources - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_LgGCtOxXzAnTxXvMqzqt1nPFIeJLoOPUa37B9McU/ai-agent-connect - **Tags:** recruitment, ats, candidate-tracking, crm, staffing ## Description Bullhorn is the primary way to manage your recruitment pipeline without the usual friction of a heavy ATS interface. Instead of digging through layers of menus to find a candidate or update a job order, you can just tell your AI agent what needs to happen. It handles the data heavy lifting by interacting with your Bullhorn account to create records, fetch notes, and manage associations. You can pull all the notes for a specific corporation or grab a list of contacts in one go. Because Vinkius hosts this connection, you get a way to turn your ATS into a conversational workspace where your agent acts as a dedicated recruiting assistant. You don't have to worry about remembering where specific data is stored or navigating complex navigation bars. If you need to know a candidate's status or want to create a new job order, the agent does the clicking for you. It can even help you manage your Data Hub records, making it easier to keep your custom data organized. This means you spend less time on data entry and more time actually talking to candidates and closing deals. It's a practical way to put your ATS data into a format that actually works with how you think and speak. ## Tools ### upsert_data_hub_records Add or update records within the Bullhorn Data Hub. This is a great way to manage your custom data sets. ### create_entity Create a new record like a candidate or job order. You can pass the data as a JSON string to add it to your account. ### create_event_subscription Set up a new event subscription. This lets you listen for specific actions happening in your Bullhorn account. ### delete_entity Remove a specific record from your Bullhorn account. Use this when you need to clear out old or incorrect data. ### delete_event_subscription Remove an existing event subscription from your account. Use this to clean up your active listeners. ### find_data_hub_records Search for specific records inside the Bullhorn Data Hub. You can provide specific criteria to filter your results. ### get_all_corp_notes Retrieve every note associated with a specific ClientCorporation. This is perfect for getting a full history of client communications. ### get_associations Get the IDs for associated entities for multiple parent records. It helps you see how different records are linked together. ### get_entities Fetch several Bullhorn records at once using their unique IDs. This is faster than looking them up one by one. ### get_entitlements See what permissions your current user has within the system. It helps you check access levels quickly. ### get_entity Get all the details for a single record like a Candidate or JobOrder. You just need to provide the ID and the fields you want to see. ### get_events Pull and consume events from your active subscription queue. Note that this will remove the events from the queue once you read them. ### get_to_many Find all the related records for a specific parent entity. It is great for pulling all contacts for a specific corporation. ### update_entity Update the information on an existing Bullhorn record. Just provide the fields you want to change and the record ID. ## Prompt Examples **Prompt:** ``` Find candidate 12345 and show me their email. ``` **Response:** ``` I've pulled the details for candidate 12345: | Field | Detail | | :--- | :--- | | **First Name** | John | | **Last Name** | Doe | | **Email** | john.doe@example.com | Would you like me to update anything else on this profile? ``` **Prompt:** ``` Show me all the notes for corporation 98765. ``` **Response:** ``` I found 2 notes for ClientCorporation 98765: * **Discussed contract renewal terms.** (Action: Client Call) * **Follow-up scheduled for next Tuesday.** (Action: Email) Is there anything specific from these notes you'd like me to summarize? ``` **Prompt:** ``` Update candidate 12345's status to Placed. ``` **Response:** ``` Done! I've updated the status for candidate 12345 to **Placed**. I've also made a note of this update in their record. ``` ## Capabilities ### Create new records Create a new candidate, job order, or client contact in your Bullhorn account using a JSON string. ### Fetch corporate notes Retrieve every note associated with a specific ClientCorporation to see the full communication history. ### Manage associations Get the IDs for associated entities for multiple parent records to see how your data is linked. ### Update entity data Modify the details of an existing Bullhorn record like a job order or candidate profile with a simple command. ### Manage Data Hub records Find or update records within the Bullhorn Data Hub to keep your custom data sets organized. ## Use Cases ### Quick candidate lookups during calls A recruiter is on a call and needs to see a candidate's history. They ask the agent to pull the profile using `get_entity` and see the last few notes. ### Summarizing client history for meetings An HR manager wants to see every interaction with a specific client. They ask the agent to use `get_all_corp_notes` to summarize the history before a meeting. ### Dictating new job orders An operations lead needs to create a new job order quickly. They dictate the details to the agent, which then uses `create_entity` to put it in Bullhorn. ### Mapping client contact networks A recruiter wants to see all contacts for a new client corporation. The agent uses `get_to_many` to list everyone associated with that company. ## Benefits - Stop tab-switching between your ATS and your workspace by using `get_entity` to pull candidate details instantly. This keeps your focus on the conversation rather than the software. - Update candidate statuses in seconds with `update_entity` instead of navigating complex menus. It makes moving people through your pipeline much faster during live calls. - Pull full conversation histories for clients using `get_all_corp_notes` to stay informed during calls. You won't have to scroll through old threads to find what was last said. - Handle complex relationships easily with `get_to_many` to see all contacts for a corporation. This gives you a complete view of your client network without manual searching. - Keep your Data Hub clean and current by using `upsert_data_hub_records` for bulk updates. It removes the pain of manual data entry for your custom tracking fields. ## How It Works The bottom line is you get a conversational interface for your entire Bullhorn ATS. 1. Subscribe to this Connector on the Vinkius Marketplace. 2. Enter your Bullhorn REST URL and your REST Token in the configuration. 3. Ask your agent to find candidates, update job orders, or pull corporate notes. ## Frequently Asked Questions **Can Bullhorn MCP update candidate statuses?** Yes, you can tell your agent to update the status of any candidate record. It will find the correct entity and apply the changes for you automatically. **How do I use Bullhorn MCP to see corporate notes?** You can ask your agent to retrieve all notes for a specific client corporation. It will pull the entire communication history so you can review it quickly. **Does Bullhorn MCP work with my current ATS data?** Yes, it connects directly to your existing Bullhorn account. It can read and write to the data you already have in your ATS and CRM. **Can I create new job orders with Bullhorn MCP?** Absolutely. You can describe a new job order to your agent, and it will use the Connector to create that new entity in your Bullhorn account for you. **Is Bullhorn MCP good for HR managers?** It's a great tool for HR managers who need to keep client contact lists accurate and quickly pull up corporate histories without clicking through multiple menus. **How do I connect Bullhorn MCP to Claude?** Once you subscribe on Vinkius, you'll get the connection details. You then add those to your Claude configuration to start managing your recruitment data. **Can I retrieve a single candidate or job order details using this integration?** Yes! Use the `get_entity` tool by specifying the entity type (e.g., 'Candidate' or 'JobOrder'), the target ID, and the fields you want to return. **How do I fetch all notes associated with a specific ClientCorporation?** You can use the `get_all_corp_notes` tool. Provide the `client_corp_id` and the fields you want to retrieve to get a complete history of notes. **Is it possible to update an existing candidate's information?** Yes, you can use the `update_entity` tool. Pass the entity type, the target ID, and a JSON string containing the updated fields in the `data` parameter.