HireSquire for AI Agents

Quick Start

HireSquire provides multiple ways to integrate with AI agents. Choose the method that best fits your workflow:

Command Line Interface (CLI)

The HireSquire CLI is the fastest way to integrate with CLI-capable agents like OpenClaw, Claude Code, OpenCode, and Codex. View on npm → | GitHub →

Skill File

Copy and paste this into your AI agent's system prompt. It teaches the agent how to use HireSquire with the async polling pattern.

# HireSquire Agent Skills

You have access to the HireSquire API for AI-powered candidate screening.

## Authentication
All requests require: Authorization: Bearer YOUR_API_TOKEN

## Async Workflow (CRITICAL)
1. POST /api/v1/jobs with resumes → get job_id
2. Poll GET /api/v1/jobs/{job_id} until status="completed"  
3. GET /api/v1/jobs/{job_id}/results

## Endpoints
- POST /api/v1/jobs - Submit screening
- GET /api/v1/jobs/{id} - Check status  
- GET /api/v1/jobs/{id}/results - Get results

See: https://hiresquireai.com/skill.md

View full skill.md →

OpenAI GPT Plugin

Import HireSquire directly into OpenAI Custom GPTs with 1 click. The plugin provides:

• Automatic OpenAPI schema discovery
• User authentication via Bearer token
• Full access to all API endpoints

LangChain Python SDK

Install via pip and use in LangChain agents with @tool decorators. View on PyPI → | GitHub →

Usage

from hiresquire import get_hiresquire_tools
from langchain.agents import AgentExecutor

tools = get_hiresquire_tools()

# Use in your LangChain agent
agent = create_openai_functions_agent(llm, tools)
executor = AgentExecutor(agent=agent, tools=tools)

View full SDK source →

Model Context Protocol (MCP)

The HireSquire MCP server provides JSON-RPC 2.0 endpoints for AI agents like Claude Code, OpenCode, and Codex. This protocol enables native tool calling without HTTP REST overhead. Source Code (GitHub) →

Endpoint

Available Tools

Example Request

{
  "jsonrpc": "2.0",
  "method": "create_screening",
  "params": {
    "title": "Senior PHP Developer",
    "description": "Looking for experienced PHP developer...",
    "resumes": [
      {"filename": "john.pdf", "content": "John Doe\n5 years PHP..."}
    ]
  },
  "id": 1
}

{
  "mcpServers": {
    "hiresquire": {
      "command": "npx",
      "args": ["-y", "hiresquire-cli", "mcp"]
    }
  }
}

Calendar & Meeting Integrations

Automate interview scheduling by connecting calendar and meeting tools.

Advanced: API Integrations (Optional)

For automatic status updates when candidates book:

Supported Tools

CLI Commands (For Agents)

# Connect calendar tools
hiresquire calendar:connect calendly --token YOUR_TOKEN
hiresquire calendar:connect calcom --token YOUR_TOKEN

# List connections
hiresquire calendar:list

# Schedule interview (after screening)
hiresquire interviews:schedule --job 123 --candidate 456 --time "2026-04-28 10:00"

REST API Endpoints

GET|POST|DELETE /api/v1/calendar/connections

GET /api/v1/calendar/slots?provider=calendly&date=2026-04-27

POST /api/v1/interviews
{
  "job_id": 123,
  "candidate_id": 456,
  "scheduled_at": "2026-04-28T10:00:00Z"
}

Python SDK Methods

from hiresquire import HireSquire

client = HireSquire("TOKEN")

# Connect calendar
client.calendar.connect(
    provider="calendly",
    api_key="YOUR_TOKEN"
)

# Or connect Cal.com
client.calendar.connect(
    provider="calcom",
    api_key="YOUR_API_KEY"
)

# Get available slots
slots = client.calendar.get_slots(
    provider="calendly",
    date="2026-04-27"
)

# Create interview
interview = client.calendar.create_interview(
    job_id=123,
    candidate_id=456,
    scheduled_at="2026-04-28T10:00:00Z"
)

User-Specific Setup

Advanced Features

Additional endpoints for enhanced agent workflows:

Agent API Keys with Spend Controls

Create dedicated API keys for AI agents with built-in spend limits. Perfect for controlling costs while allowing agents to operate autonomously.

{
  "name": "My Agent",
  "monthly_spend_limit": 100,
  "daily_spend_limit": 10,
  "lifetime_spend_limit": null
}

Spend Limit Options

Agent Key Endpoints

{
  "event": "agent_key.threshold_reached",
  "key_id": 1,
  "key_name": "My Agent",
  "usage": 80,
  "limit": 100,
  "remaining": 20
}

Prepaid Credits for Agents

Purchase prepaid credits for pay-as-you-go agent usage. No subscription required.

Credit API Endpoints

Advanced Tutorials & Case Studies

REST API Reference

For detailed API documentation including all endpoints, request/response formats, and webhooks: