Situational awareness for AI agents: timezone, holiday, business calendar, and platform status checks before acting.
What it does
AgentUtil Context is a lightweight API that gives AI agents situational awareness before they take actions. It checks timezones, public holidays (across 11 countries), business calendar events, and live platform status (GitHub, AWS, Stripe, etc.) to help agents avoid mistakes like sending marketing emails on Christmas Day or deploying code during an outage.
The primary endpoint, POST /v1/check, accepts a description of an intended action along with timezone, country, platform, and date parameters. It returns risk factors, clear signals, a risk level, and a human-readable summary — all in under 50ms according to the provider. Additional endpoints include /v1/time for quick business-hours and holiday lookups, /v1/platform for platform status checks, and GET /v1/calendar for upcoming holiday listings by country.
Pricing uses the x402 protocol with USDC on Base. The /v1/check endpoint costs $0.003 per request, /v1/time costs $0.001, and /v1/platform costs $0.002. The /v1/calendar endpoint is free. A free tier of 10 queries per day per IP is available with no signup required. The service provides OpenAPI, agent-service.json, and agent.json discovery documents for automated agent integration.
Capabilities
Use cases
- —Checking whether it's appropriate to send a marketing email blast given the recipient's timezone and local holidays
- —Verifying platform status (GitHub, AWS, Stripe) before triggering an automated deployment
- —Determining if a date falls on a public holiday or weekend in a specific country before scheduling a meeting
- —Providing autonomous agents with go/no-go signals before executing time-sensitive workflows
- —Retrieving upcoming holiday calendars for workforce or campaign planning across multiple countries
Fit
Best for
- —Autonomous AI agents that need pre-action safety checks
- —Workflow automation systems that operate across multiple timezones and countries
- —DevOps pipelines that should avoid deploying during platform outages
- —Marketing automation that needs to respect holidays and business hours
Not for
- —Detailed historical holiday data or academic calendar research
- —Real-time infrastructure monitoring dashboards (this is a point-in-time check, not a stream)
- —Countries outside the supported 11-country set
Quick start
curl -X POST https://context.agentutil.net/v1/check \
-H "Content-Type: application/json" \
-d '{
"action": "send_marketing_email",
"description": "Send promotional blast to 50k subscribers",
"timezone": "America/New_York",
"country": "US",
"date": "2026-12-25"
}'Example
Request
{
"date": "2026-12-25",
"action": "send_marketing_email",
"country": "US",
"platform": "aws",
"timezone": "America/New_York",
"description": "Send promotional blast to 50k subscribers"
}Response
{
"date": "2026-12-25",
"summary": "Christmas Day in the US — not recommended for marketing email blasts.",
"holidays": [
{
"date": "2026-12-25",
"name": "Christmas Day",
"type": "public",
"business_impact": "high"
}
],
"risk_level": "high",
"clear_factors": [
"platform_operational"
],
"timezone_info": {
"timezone": "America/New_York",
"local_time": "2026-12-25T10:00:00-05:00",
"is_business_hours": false
},
"active_factors": [
"public_holiday",
"outside_business_hours"
],
"business_events": [],
"platform_status": {
"status": "operational",
"platform": "aws"
}
}Endpoint
Quality
Full OpenAPI 3.1 schema with four endpoints, clear pricing, and a working landing page. The probe returned HTTP 200 on POST (free tier served the request) rather than a 402 challenge, so x402 gating is confirmed only via documentation. No dedicated docs page exists. Response schema is present but loosely typed (e.g., timezone_info is just 'object'). Example response is inferred from the schema, not captured live.
Warnings
- —No 402 challenge was captured during probing — the free tier (10 req/day per IP) served the request directly, so x402 payment gating could not be independently verified
- —The /docs, /api, /pricing, and /README paths all return 404 — documentation is limited to the landing page and OpenAPI spec
- —Response example is inferred from the OpenAPI schema, not from a captured live response
- —The list of supported 11 countries is mentioned but not enumerated in available materials
Citations
- —Situational awareness for AI agents: timezone, holiday, business calendar, and platform status checks across 11 countrieshttps://context.agentutil.net
- —/v1/check costs $0.003, /v1/time costs $0.001, /v1/platform costs $0.002, /v1/calendar is freehttps://context.agentutil.net
- —Free tier: 10 queries/day per IP, no signup required; paid via x402 protocol (USDC on Base)https://context.agentutil.net
- —Pure data lookup, <50ms response timehttps://context.agentutil.net
- —OpenAPI spec describes four endpoints: /v1/check, /v1/time, /v1/platform, /v1/calendarhttps://context.agentutil.net/openapi.json