# Runhuman

> Human QA testing via API. Send a URL and test instructions, get structured results from real human testers. Integrates with AI coding agents, CI/CD pipelines, and REST APIs.

Runhuman provides human-in-the-loop QA testing. When you need to verify UI/UX, visual issues, or complex user flows that are hard to automate, call Runhuman to get a real human to test it.

## Quick Start

- [Quick Start Guide](https://runhuman.com/docs/quick-start): Get your first human QA test running in under 5 minutes

## Integration Methods

- [REST API](https://runhuman.com/docs/api): Direct HTTP integration for backend services
- [MCP for AI Agents](https://runhuman.com/docs/mcp): Add Runhuman to Claude Code, Cursor, or VS Code
- [GitHub Actions](https://runhuman.com/docs/github-actions): Human QA testing in CI/CD pipelines
- [CLI Tool](https://runhuman.com/docs/cli): Command-line interface for local development

## Reference

- [API Reference](https://runhuman.com/docs/reference): Complete API specification, error codes, and response formats
- [Cookbook](https://runhuman.com/docs/cookbook): Practical recipes for common testing scenarios

## Key Endpoints

**Synchronous (recommended):** `POST https://runhuman.com/api/run`
- Blocks until test completes (up to 10 minutes)
- Returns structured results matching your outputSchema

**Asynchronous:** `POST https://runhuman.com/api/jobs` then `GET https://runhuman.com/api/job/:jobId`
- Non-blocking, poll for results

## Authentication

All requests require: `Authorization: Bearer YOUR_API_KEY`

Get an API key from your organization's API Keys page at https://runhuman.com/dashboard

## MCP Integration

Add to your AI coding agent with one command:
```
claude mcp add --transport http runhuman https://runhuman.com/mcp --header "Authorization: Bearer YOUR_API_KEY"
```

## Pricing

$0.0085 per second of tester time. Typical test: 2-5 minutes ($1.02-$2.55).

## Optional

- [Full Documentation for Agents](https://runhuman.com/for_agents.md): Complete machine-readable API reference with examples
- [Pricing Details](https://runhuman.com/pricing): Full pricing breakdown