How to Use the HRBlade MCP in CrewAI

Deploy an autonomous hiring team with HRBlade and CrewAI. Let your agents source, screen, and schedule candidates for you, 24/7.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HRBlade MCP to CrewAI

Create your Vinkius account to connect HRBlade to CrewAI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup HRBlade with CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Delegate Recruiting to a Crew of Agents

This MCP server gives your CrewAI agents the tools they need to run your hiring pipeline. You can create a 'Sourcing Agent' that periodically calls `list_candidates` to find new applicants. It then passes the list of new candidates to a 'Screening Agent' via shared context. The Screening Agent's job is to use `get_candidate_details` for each person to check their qualifications against the job description. If it finds a match, it delegates the next step—scheduling—to a 'Coordinator Agent'.

Run an Autonomous Interview Workflow with CrewAI

Your Coordinator Agent takes the approved candidate list from the Screening Agent. Its task is to use `list_interviews` to find the correct template for the role, then execute `send_interview_invitation` for each candidate. At the same time, you can have a 'Monitoring Agent' that runs in parallel. Its only job is to call `list_interview_responses` every few minutes. When it detects a new submission, it notifies the Coordinator to advance that candidate to the review stage.

Build a Self-Managing Candidate Pipeline

This setup is more than just a script; it's an autonomous system. Your CrewAI team uses shared memory to track every candidate's status. Agents can use tools like `get_candidate_details` to enrich the data as they go. This creates a smart workflow. For instance, if the Coordinator Agent gets overwhelmed with interviews to send, the Sourcing Agent can see this in the shared context and pause its search for new candidates. This is how you build a resilient hiring process using this MCP Server.

Setup guide

Set up HRBlade MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke HRBlade tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="HRBlade Analyst",
    goal="Access and analyze HRBlade data via MCP.",
    backstory="Expert analyst with direct HRBlade access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent HRBlade transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="HRBlade Analyst",
        goal="Access and analyze HRBlade data via MCP.",
        backstory="Expert analyst with direct HRBlade access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent HRBlade transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by HRBlade. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect HRBlade now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about HRBlade MCP in CrewAI

It's simple. When you define an Agent in your Crew, just pass your Vinkius server URL into the `mcps` list. The agent automatically gets access to all the HRBlade tools on that server.

Yes. Define an agent with a specific role, like 'Interview Scheduler', and provide a goal. By giving it access to the HRBlade MCP, it can use tools like `send_interview_invitation` to do its job.

A common pattern is to use a team of three: a Sourcing Agent (`list_candidates`), a Scheduling Agent (`send_interview_invitation`), and a Review Agent (`list_interview_responses`). They can work sequentially to move candidates through the process.

Agents pass information through a shared context. One agent can call `get_candidate_details`, add the result to the context, and a second agent can use that data for its own task without making another API call.

The MCP server handling HRBlade tools processes candidate names, contact details, and video links inside a secure, single-use Vinkius sandbox. Connections are always encrypted, and the server is stateless, so it doesn't hold onto your data.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript