# energypod.io

Published weekly energy-industry digests plus per-episode summaries and
transcripts. Two interchangeable agent-facing surfaces over the same data —
pick ONE (they're alternatives, not complementary):

- REST API — GET endpoints under /api/v1/. For scripts and plain HTTP
  clients. Docs: /api
- MCP server — POST /mcp, JSON-RPC. For MCP-capable agents; tools are
  discovered at runtime. Docs: /mcp/docs

Access is ANONYMOUS by default, rate-limited per client IP. A Bearer
`epk_…` API key (mint one via POST /signup with JSON, or on your Account
page) or an OAuth token raises the quota. Zero-identity key: POST /key
(empty JSON body, no email/name/password — a few per IP per day).
MCP clients can also connect via
OAuth 2.1: metadata at /.well-known/oauth-protected-resource and
/.well-known/oauth-authorization-server, dynamic client registration at
POST /register, PKCE (S256) required. Heads-up: if a plain python
requests/httpx call gets Cloudflare error 1010, send a browser-like
User-Agent header. Public, unauthenticated indexes: /llms.txt,
/ai-catalog.json, /.well-known/openapi.json, /server.json (MCP registry
descriptor).

Server card: GET /mcp (JSON; HTML for browsers) or /mcp.json — endpoint,
protocol versions, tool list, auth summary, and copy-paste install snippets
(Claude Code, Cursor, VS Code, Grok, ChatGPT). ChatGPT: Settings → Apps &
Connectors → Developer mode → Create → paste https://energypod.io/mcp, no
authentication.

## REST endpoints (base: https://energypod.io/api/v1)

- GET /digests — newest-first list of published editions
- GET /digests/<YYYY-MM-DD>[?region=na|emea|apac|latam][&lang=<code>] — full briefing
  markdown + metadata for that region's view (a generated per-region edition
  when one exists, else the master filtered to the region) in that language
  when a translation exists (`lang` in the payload echoes what was served);
  the payload's `regions` array lists what the edition offers
- GET /digests/<YYYY-MM-DD>/episodes[?region=…][&lang=…] — that edition's referenced
  episodes for the region's reading list, titles localized when available
- GET /episodes/<eid>[?digest=<YYYY-MM-DD>][&lang=<code>] — title + show + summary +
  transcript (localized when translations exist)
- GET /search?q=<text>[&type=&show=&period=&region=&topic=] — typo-tolerant search over
  digests + episodes + people + companies + channels; the optional filters (one result
  kind, one feed key, past week/month/year, episode region/topic tags) match the site's
  search overlay

## MCP tools (POST https://energypod.io/mcp)

- list_digests — same as GET /digests
- get_digest(slug, region?, lang?) — same as GET /digests/<slug>
- list_digest_episodes(slug, region?, lang?) — same as GET /digests/<slug>/episodes
- get_episode(eid, digest?, lang?) — same as GET /episodes/<eid>
- search(q) — same as GET /search?q=…