Ground your AI agent
in reality.

One HTTP call. Your agent gets the current local time, weather, season, and upcoming holidays for any location on Earth. No setup, no SDKs.

Get free API key See how it works
Live demo
GET https://api.groundme.dev?location=New+York 
Click a location above to run a live API call.

Ground your agent in one line

Tell your agent to read the setup instructions and it will configure itself autonomously — sign up, store the key, and call the API on every session.

Paste into any agent's system prompt or config file 
Read https://api.groundme.dev/agent-instructions and follow them.

How it works

1

Sign up

Email + password. Get an API key instantly. No credit card required.

2

Call the API

One GET request with your key and a location. The response is markdown — paste it directly into your system prompt or tool output.

3

Your agent knows where it is

Local time, UTC offset, timezone, current weather, season, and upcoming public holidays — refreshed on every call.

Request
# Any city, ZIP code, or IANA timezone
curl "https://api.groundme.dev?location=Tokyo" \
  -H "Authorization: Bearer gme_..."
Response text/markdown
# Grounding Context

It is Tuesday, February 24, 2026 at 8:42 PM JST
Season: Winter

## Weather
Partly cloudy, 6°C / 42.8°F (feels like 3°C / 37.4°F)
High 9°C / 48.2°F · Low 2°C / 35.6°F
Humidity 68% · Wind 14 km/h / 8.7 mph
Sunrise 06:21 · Sunset 17:43

## Upcoming Public Holidays
- 2026-03-20: Spring Equinox Day
- 2026-04-29: Showa Day
- 2026-05-03: Constitution Day

Use with your agent

Add one block to your config file and every future session starts grounded. Works with any tool that reads an instructions file.

Add to AGENTS.md at the root of your project 
## Grounding

At the start of every session, call:

  GET https://api.groundme.dev?location=YOUR_LOCATION
  Authorization: Bearer YOUR_KEY

Inject the response into your context as grounding for the
current date, time, weather, and upcoming holidays.
Add to .cursorrules or .cursor/rules 
At the start of every session, call:

  GET https://api.groundme.dev?location=YOUR_LOCATION
  Authorization: Bearer YOUR_KEY

Use the markdown response as grounding context for the
current date, time, weather, and upcoming holidays.
Paste into any system prompt 
At the start of every conversation, fetch your grounding context:

  GET https://api.groundme.dev?location=YOUR_LOCATION
  Authorization: Bearer YOUR_KEY

Inject the response verbatim. It contains the current local
time, weather, season, and upcoming public holidays.

Replace YOUR_LOCATION with any city, address, or ZIP code. Replace YOUR_KEY with your gme_... API key. Get your key →

Pricing

Free
$0/month
  • 100 requests/month
  • Full API access
  • All locations & timezones
  • No credit card required
Get started free
Pro
$4/month
  • 10,000 requests/month
  • Everything in Free
  • Flat rate — no surprises
  • Stripe billing portal
  • Cancel anytime
Get started

Get your free API key

100 requests/month, no credit card required.

Retrieve your API key

API Reference

GET
https://api.groundme.dev/
Returns grounding context: local time, timezone, weather, season, and upcoming holidays.
curl
curl "https://api.groundme.dev?location=London+UK" \
  -H "Authorization: Bearer gme_..."
Response 
# Grounding Context

It is Tuesday, Feb 24, 2026 at 3:42 PM GMT
Season: Winter

## Weather
Overcast, 8°C / 46.4°F (feels like 5°C / 41°F)
High 10°C / 50°F · Low 4°C / 39.2°F
Humidity 81% · Wind 22 km/h / 13.7 mph
Sunrise 07:08 · Sunset 17:32

## Upcoming Public Holidays
- 2026-04-03: Good Friday
- 2026-04-06: Easter Monday
- 2026-05-04: Early May Bank Holiday
{
  "datetime": {
    "local": "2026-02-24T15:42:00",
    "utc": "2026-02-24T15:42:00Z",
    "timezone": "Europe/London",
    "displayLocal": "Tuesday, February 24, 2026 at 3:42 PM GMT",
    "utcOffset": "+00:00"
  },
  "season": "Winter",
  "weather": {
    "description": "Overcast",
    "tempC": 8,
    "tempF": 46.4,
    "feelsLikeC": 5,
    "feelsLikeF": 41,
    "highC": 10,
    "highF": 50,
    "lowC": 4,
    "lowF": 39.2,
    "humidity": 81,
    "windKph": 22,
    "windMph": 13.7,
    "precipMm": 0.2,
    "sunrise": "07:08",
    "sunset": "17:32"
  },
  "holidays": [
    { "date": "2026-04-03", "name": "Good Friday" },
    { "date": "2026-04-06", "name": "Easter Monday" },
    { "date": "2026-05-04", "name": "Early May Bank Holiday" }
  ],
  "requestsRemaining": 94
}
POST
/signup
Create an account. Returns your API key.
curl -X POST https://api.groundme.dev/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"yourpassword"}'
POST
/login
Retrieve your API key.
curl -X POST https://api.groundme.dev/login \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"yourpassword"}'
POST
/keys/regenerate
Generate a new API key (invalidates the old one).
curl -X POST https://api.groundme.dev/keys/regenerate \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"yourpassword"}'
POST
/billing/portal
Get a Stripe checkout or billing portal URL.
curl -X POST https://api.groundme.dev/billing/portal \
  -H "Authorization: Bearer gme_..."

Query parameters for GET /

ParamDescriptionExample
location Any freeform location string. Enables weather, season & holidays. Use + or %20 for spaces. Tokyo, 94103, London+UK
tz IANA timezone string (skips geocoding). Returns time data only — no weather, season, or holidays. America/New_York
exclude Comma-separated fields to omit from the response. weather, holidays, season
format markdown (default) or json. Also accepts Accept: application/json header. json

?location= vs ?tz=

Feature?location=?tz=
Local time✓✓
Season✓—
Weather✓—
Public holidays✓—
Authentication. Pass your API key as Authorization: Bearer gme_... or X-Api-Key: gme_.... The default response is text/markdown — designed to be injected directly into an agent's context window. Add ?format=json or Accept: application/json for structured JSON. Weather data is cached for 30 minutes; holiday data is cached for the full calendar year.