# actualjob

> The first product that takes action FOR your AI agent. Analyzes Gmail headers + Calendar events and generates an evidence-based job description in 15 seconds for 8¢.

## Endpoints

- REST gateway: https://api.actual-job.com (27 jd_* tools)
- MCP server: https://mcp.actual-job.com (HTTP/SSE transport)
- Stdio MCP: `npx @actualjob/mcp-server`
- CLI: `npx @actualjob/cli`

## Install

- npm: `@actualjob/cli@latest`, `@actualjob/mcp-server@latest`
- MCP config snippet: https://actual-job.com/install/mcp

## Documentation

- Operational rules: https://actual-job.com/AGENTS.md
- MCP Server Card: https://actual-job.com/.well-known/mcp-server-card.json
- Source: https://github.com/capitalthought/actualjob/blob/main/tools.json

## Auth

Agent tokens are bearer tokens prefixed `agent_` and minted via `jd_issue_agent_token` after the user grants consent. Tokens carry per-scope grants; mismatched scope returns `agent_scope_denied` (HTTP 403).

## First call

Always call `jd_prep_check` first. It validates OAuth credentials, quota headroom, and consent state, returning `{ ok, checks, blocking_issues }`. Do not retry blocked operations.