Ground your AI agent
in reality.
A single API call gives your agent the current local time, weather, season, and upcoming holidays for any location on Earth. No setup, no SDKs. Just HTTP.
Try it right now
curl "https://api.groundme.dev?location=Tokyo" \
-H "Authorization: Bearer YOUR_KEY"Response text/markdown
# Grounding Context
It is Wednesday, February 25, 2026 at 2:37 AM JST
Season: Winter
## Weather
Partly cloudy, 12.4°C / 54.3°F (feels like 12.7°C / 54.8°F)
High 12.7°C / 54.9°F · Low 8.4°C / 47.1°F
Humidity 82% · Wind 4.3 km/h / 2.7 mph · Precipitation 0 mm
Sunrise 06:17 · Sunset 17:33Ground your agent
Give your agent one instruction. It reads the setup guide, creates an account, and grounds itself automatically.
Tell your agent
Read https://api.groundme.dev/instructions and follow them.How it works
1
Sign up
Email + password. Get an API key instantly. No credit card.
2
Add to your agent
One GET request. The response is markdown — paste it directly into your system prompt or tool output.
3
Your agent knows where it is
Local time, UTC, timezone, current weather, season, and upcoming public holidays — updated on every request.
Agent-native: every endpoint returns markdown by default
# Sign up via API — your agent can do this autonomously
POST https://api.groundme.dev/signup
{"email": "agent@example.com", "password": "securepassword"}
# Response is markdown with your key and usage instructions
# Welcome to groundme.dev
## Your API Key
`gme_a1b2c3d4e5f6...`Pricing
Free
$0/month
- 100 requests/month
- Full API access
- All locations & timezones
- Firestore-cached lookups
- No credit card required
Pay as you go
Pro
$5/1,000 requests
- Everything in Free
- Billed monthly per 1,000 requests
- Stripe billing portal
- No monthly minimum
- Cancel anytime
Get your free API key
100 requests/month, no credit card required.
Your API Key
Start using it
Retrieve your API key
Your API Key
This will invalidate your current key.
API Reference
GET
api.groundme.dev
Returns markdown grounding context: local time, timezone, weather, season, and upcoming holidays. Primary endpoint.
POST
/signup
Create account. Body:
{"email","password"}. Returns API key.POST
/login
Retrieve your API key. Body:
{"email","password"}.POST
/keys/regenerate
Generate a new API key (invalidates old one). Body:
{"email","password"}.POST
/billing/portal
Get Stripe billing/checkout URL. Body:
{"apiKey"}.Query parameters for GET /
| Param | Description | Example |
|---|---|---|
location | Any freeform location string. Enables weather, season & holidays. | Tokyo, 94103, London UK |
tz | IANA timezone (skips geocoding). Time data only. | America/New_York |
exclude | Comma-separated fields to omit | weather, holidays, season |
format | markdown (default) or json | json |
Authentication via header.
Pass your API key as
Authorization: Bearer gme_... or X-Api-Key: gme_....
Default response is text/markdown — designed to be injected directly into an AI agent's context.
Send Accept: application/json or ?format=json for structured JSON.