# PayTransparency

> PayTransparency checks job postings against every US pay-transparency law (states and cities, plus the EU directive) and reports what's missing: the pay range, benefits, or other required disclosures, with the statutory fine exposure. Agents can look up the laws for free, and sign up, check postings and pay with no human in the loop.

## Connect

- MCP server (Streamable HTTP): https://www.paytransparency.app/mcp. The law tools and `signup` need no key; reconnect with `Authorization: Bearer <api_key>` for the rest.
- REST API: https://www.paytransparency.app/api/v1. OpenAPI at https://www.paytransparency.app/openapi.json
- Guide: https://www.paytransparency.app/docs/agents

## Flow

1. Free: GET /api/v1/laws-for-employer?employee_count=120&states=CA,NY tells you which laws apply.
2. POST /api/v1/signup {email, company_name?, employee_count?} returns api_key and a 14-day trial. The person at email gets a link to claim the account.
3. POST /api/v1/check {text or url, states?} for each posting. report.overallCompliant says whether it passes; report.stateResults says what each law needs.
4. Fix what it flags and check again.

## Pricing and payment

One plan: $99 per 30 days, unlimited checks (120 an hour per key), 14-day free trial with no card. GET /api/v1/billing lists the ways to pay that are on:
- Machine Payments Protocol: POST /api/v1/companies/{company_id}/pay answers 402; pay with any MPP client. Each payment adds 30 days.
- A Stripe Checkout link for a person: POST /api/v1/billing/checkout ($99/month subscription).

## Endpoints

- GET /api/v1/laws: Every pay-transparency law in the catalog, or one jurisdiction with ?state=CA. CC BY 4.0. (no key)
- GET /api/v1/laws-for-employer: The laws an employer of this size must follow where it hires: in effect now and upcoming, with a summary. (no key)
- POST /api/v1/signup: Create an account with a 14-day trial. Returns an API key (shown once). The person at email is sent a link to claim the account. (no key)
- POST /api/v1/check: Check one job posting against every law that applies where it can be filled. Returns the report: overallCompliant, each law's result and the fine exposure. 120 an hour per key.
- GET /api/v1/me: The account this key acts for, whether it's claimed, access dates and limits.
- PATCH /api/v1/me: Change the employer's name or headcount.
- POST /api/v1/claim: Email the owner a fresh link to claim the account in the dashboard.
- GET /api/v1/keys: List active API keys.
- POST /api/v1/keys: Create a key (returned once). Up to 5 active.
- DELETE /api/v1/keys/{key_id}: Revoke a key.
- GET /api/v1/billing: Trial and paid-through dates, and every way to pay that's switched on.
- POST /api/v1/billing/checkout: A Stripe Checkout link for a person to subscribe at $99/month.
- POST /api/v1/companies/{company_id}/pay: Machine Payments Protocol: answers 402 with a challenge; pay it with an MPP client to buy 30 days for $99.00. No API key. (no key)

## Limits and terms

120 requests a minute and 120 checks an hour per key. 5 signups a day per network, 3 per email. Posting text up to 50,000 characters. The law data is CC BY 4.0: credit PayTransparency with a link. Results summarize each statute and agency guidance; they aren't legal advice.