# HirePulse agent gateway

Four data tools: tech stack, open jobs, hiring intent and Google Ads. No account, no API key. 5 successful free calls per day per IP, shared by all four tools; then $0.01 USDC per successful result over x402 v2 on Base (eip155:8453). Results with a status other than "ok" are free and do not use a free call.

## POST /v1/tech-stack ($0.01 per result)
MCP tool: detect_website_tech_stack
Use before qualifying or writing to a company: shows which ad pixels, analytics, marketing tools, CMS, e-commerce platform, hosting and payment providers a website runs (Meta, Google Ads, LinkedIn and TikTok pixels, GA4, Google Tag Manager and more), plus email provider, DMARC policy and SPF senders from DNS. Fast and cheap: reads the home page HTML, headers, cookies and up to two public Google Tag Manager containers, without a headless browser. One domain per call. 5 free calls per day per IP, then $0.01 USDC per result via x402 on Base. Blocked, unreachable or nonexistent sites, and pages with no detected technology (no_signals), are never charged. Built for AI SDR and B2B lead-enrichment agents.
Body: {"domain":"example.com"}

## POST /v1/ats-jobs ($0.01 per result)
MCP tool: get_company_open_jobs
Use to check whether a company is hiring right now and for which roles: live open jobs from its public Greenhouse, Lever, Ashby, Workable, Recruitee or SmartRecruiters board, with titles, departments, locations, remote flag, salary when published and technology keywords. Up to 300 jobs per call. For monitoring, send known_job_ids from an earlier call to get new and closed job IDs; diff_only returns only new jobs. confidence high means the company website links to the board; unverified means only the board name matches the domain. 5 free calls per day per IP, then $0.01 USDC per result via x402 on Base. No board found, no open jobs, or a board that is down is never charged.
Body: {"domain":"linear.app"}

## POST /v1/company-intent ($0.01 per result)
MCP tool: get_company_hiring_intent
Use to rank or prioritize accounts before outreach: turns a company domain into a hiring-based buying-intent summary from its public job board (Greenhouse, Lever, Ashby, Workable, Recruitee, SmartRecruiters): intent_score 0-100, hiring_status (hypergrowth, active_hiring, steady), open roles, roles posted in the last 30 days, hiring by function (sales, engineering, data/AI...), technologies the company is hiring for (cloud, data/AI, databases, observability, Salesforce) and notable senior or go-to-market roles. Compact output instead of the full job list. 5 free calls per day per IP, shared with the other tools, then $0.01 USDC per result via x402 on Base. No job board found, no open jobs, or a generic name-only match is never charged.
Body: {"domain":"linear.app"}

## POST /v1/google-ads ($0.01 per result)
MCP tool: get_google_ads_by_domain
Use to see whether a company spends on Google Ads and what it advertises: advertisers and ads for a domain from the public Google Ads Transparency Center, the Google estimate of how many ads it runs, up to 40 ads with format (text, image, video), first and last shown dates, preview links and Transparency Center links. Optional region filter (US, GB, CA, AU, DE, FR, ES, IT, NL, IL, IN, BR, MX, JP, SG, AE). For competitor research, ad-spend signals and sales personalization. 5 free calls per day per IP, shared with the other tools, then $0.01 USDC per result via x402 on Base. Domains with no ads are never charged.
Body: {"domain":"monday.com"}

## POST /v1/company-profile ($0.03 per result)
MCP tool: get_company_profile
One call for a full company research profile before outreach: runs tech stack, hiring intent and Google Ads for a domain in parallel and returns the three sections together, with a short list of plain-language signals. $0.03 USDC per result via x402 on Base: one request instead of three. Charged only when at least two of the three sections have data; otherwise nothing is charged and the answer says which single tool has data. Counts as one of the 5 free daily calls.
Body: {"domain":"ramp.com"}

ats-jobs also accepts known_job_ids and diff_only. Use next_poll_after: calling again earlier is usually wasted.
Successful answers include next_steps: optional follow-up calls on the same domain with the exact body.

## Usage headers on every answer
X-Usage-Free-Remaining, X-Usage-Free-Limit, X-Usage-Free-Resets-At, X-Usage-Price-Micro-Usd, X-Usage-Charged-Micro-Usd.

## Retries
Idempotency-Key is optional. Without it, the same input on the same day returns the stored result and is never charged twice.

## Errors
RFC 9457 problem JSON with code and hint. List: GET /errors

## MCP
Streamable HTTP endpoint: POST /mcp. Tools: detect_website_tech_stack, get_company_open_jobs, get_company_hiring_intent, get_google_ads_by_domain, get_company_profile. MCP calls use the 5 free daily calls per IP. After that, MCP calls can be paid inside MCP with x402: the tool returns isError with the x402 PaymentRequired terms in structuredContent; repeat the same tools/call with params._meta["x402/payment"] set to the signed payment payload (the @x402/mcp client does this automatically). The receipt comes back in result._meta["x402/payment-response"]. Paid calls also work over plain HTTP with x402.

This service does not call Apify.

## Service URLs
Base URL: https://hirepulse-gateway.hirepulse-commerce-sandbox.workers.dev
POST https://hirepulse-gateway.hirepulse-commerce-sandbox.workers.dev/v1/tech-stack
POST https://hirepulse-gateway.hirepulse-commerce-sandbox.workers.dev/v1/ats-jobs
POST https://hirepulse-gateway.hirepulse-commerce-sandbox.workers.dev/v1/company-intent
POST https://hirepulse-gateway.hirepulse-commerce-sandbox.workers.dev/v1/google-ads
POST https://hirepulse-gateway.hirepulse-commerce-sandbox.workers.dev/v1/company-profile
MCP: https://hirepulse-gateway.hirepulse-commerce-sandbox.workers.dev/mcp
Catalog: https://hirepulse-gateway.hirepulse-commerce-sandbox.workers.dev/v1/catalog
OpenAPI: https://hirepulse-gateway.hirepulse-commerce-sandbox.workers.dev/openapi.json
Payments: https://hirepulse-gateway.hirepulse-commerce-sandbox.workers.dev/.well-known/x402.json