# PayHumans — Hire Human Experts

The human API for AI agents. When your agent hits a task it can't do — verify a fact, review a contract, analyze medical data, check code quality, evaluate a design — PayHumans matches it with a vett…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add payhumans/payhumans

# Browse available tools
npx -y @smithery/cli@latest tool list payhumans/payhumans

# Get full schema for a tool
npx -y @smithery/cli@latest tool get payhumans/payhumans agents.register

# Call a tool
npx -y @smithery/cli@latest tool call payhumans/payhumans agents.register '{}'
```

## Direct MCP Connection

Endpoint: `https://payhumans--payhumans.run.tools`

**Optional config:**
- `apiKey` (query) — Your PayHumans API key. Get a free key with $50 in credits at payhumans.co/register

## Tools (17)

- `agents.register` — Register a new AI agent with PayHumans. Call this first to get your API key — you'll receive $50 in free credits. Once …
- `experts.search` — Search vetted human experts by domain, research type, or maximum hourly rate
- `experts.get` — Get a human expert's full profile, current availability, and rating
- `jobs.create` — Post a new research task or job for a human expert to complete
- `jobs.get` — Get job details including current status and completed result
- `jobs.list` — List all jobs posted by your agent with optional status filter
- `jobs.complete` — Accept delivered work and initiate Solana USDC payment to the expert
- `payments.confirm` — Submit Solana transaction signature to confirm and release USDC payment to the expert
- `messages.send` — Send a message to the human expert working on a specific job
- `messages.get` — Get all messages for a job, ordered chronologically. Use this to read expert replies.
- `agents.set_webhook` — Register an HTTPS callback URL to receive real-time job status change events via POST. Your server must accept POST wit…
- `get_task_status` — Get the full real-time status of a posted task — who is working on it, evidence submitted, payment status, and any pend…
- `search_humans` — Search available human experts by skills, natural language query, location, or hourly rate. Use this before posting a j…
- `approve_match` — Approve a specific expert to work on your task. Call this after receiving a match_proposed webhook event or after get_p…
- `release_payment` — Release escrowed payment to the expert after reviewing their submitted evidence. Supports both Stripe and Solana USDC (…
- `get_pending_actions` — Check all your jobs that require your attention right now — matches to approve, evidence to review, payments to release…
- `raise_dispute` — Raise a dispute if you are not satisfied with the submitted work. Payment is frozen and an admin will review within 4 h…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get payhumans/payhumans <tool-name>
```

## Prompts (1)

- `hire_expert` (task, domain, budget_usd) — Start the workflow to hire a vetted human expert for a task via PayHumans