# EQ Outcome API and MCP server

EQ runs fixed-price staffing and recruiting outcomes. Internal routing is automatic and never part of the public contract.

## Endpoints

- API base: https://api.eq.app/v1
- MCP Streamable HTTP: https://api.eq.app/mcp
- OpenAPI: https://api.eq.app/v1/openapi.json
- Human documentation: https://eq.app/developers

## Access

1. POST https://api.eq.app/v1/access/requests with {"email":"you@company.com"}.
2. Enter the eight-digit code by POSTing {"code":"12345678"} to /access/requests/{id}/verify.
3. Store the returned eq_ key. It is shown once.

The verification response reports the account's current developer trial balance and daily limits. Paid account limits are returned by GET https://api.eq.app/v1/usage.

## Run an outcome

POST https://api.eq.app/v1/runs
Authorization: Bearer eq_YOUR_KEY
Idempotency-Key: your-stable-request-id
Content-Type: application/json

{"capability_id":"resume-summary","input":{"text":"resume text"}}

Use GET https://api.eq.app/v1/runs/{id} for durable status, output, evidence, Worker Usage, and recovery details.

## Capabilities

- candidate-search-query ($4 Worker Usage): Turn a job description into structured search criteria and a Boolean sourcing query.
- resume-summary ($3 Worker Usage): Create a factual, submission-ready recruiter summary from resume text.
- candidate-job-match ($2 Worker Usage): Score a candidate against a role using evidence from the supplied material.
- candidate-outreach-draft ($2 Worker Usage): Draft short, specific outreach for a passive candidate and a real role.
- staffing-inbox-triage ($1 Worker Usage): Classify an inbound staffing email by intent, urgency, and next action.
- interview-scorecard ($2 Worker Usage): Turn an interview transcript into an evidence-based scorecard.
- job-posting-draft ($2 Worker Usage): Turn rough role-intake notes into a polished, compliant job posting.
- timesheet-validation ($3 Worker Usage): Validate submitted hours against schedule and payroll rules.

## Billing

Packs: $50 Worker Usage, $100 Worker Usage, $500 Worker Usage. Purchased Worker Usage remains valid for 12 months. POST /orders creates a hosted checkout URL; a person must authorize payment. Poll GET /orders/{id} for fulfillment.

## Reliability and safety

- Send an Idempotency-Key for every run.
- Follow Retry-After and rate-limit headers.
- Paid checkout and consequential external actions require user authorization.
- Output is retained for 24 hours, then purged while non-content usage metadata remains.
- Do not place credentials in outcome input.