langchain-recruitmcp

LangChain integration for RecruitMCP. It loads RecruitMCP's MCP tools (search people and companies, enrich profiles, find email and phone) as LangChain tools for your agents.

Install

pip install langchain-recruitmcp

Set your key

Get a free API key at recruitmcp.com, then:

export RECRUITMCP_KEY=rmcp_live_...

Use

import asyncio
from langchain_recruitmcp import RecruitMCPToolkit

async def main():
    tools = await RecruitMCPToolkit().aget_tools()
    by_name = {t.name: t for t in tools}
    print(await by_name["resolve_location"].ainvoke({"text": "Ghent, Belgium"}))

asyncio.run(main())

With a LangGraph agent:

from langchain.agents import create_agent

agent = create_agent("openai:gpt-4.1-mini", tools=await RecruitMCPToolkit().aget_tools())

Options

The tools you get also depend on your key's scopes: the server only lists tools the key may use.

Credits

resolve_location and search_people with dry_run: true are free. Paid calls show their cost in the response. See recruitmcp.com/docs/mcp.

Development

pip install -e . pytest pytest-asyncio
pytest                                   # unit tests, no network
RECRUITMCP_KEY=... pytest tests/integration_tests   # live, 0 credits

License

MIT