# Fortune Fog

> Free interactive fortune cookie PWA by PlatphormNews at fortune.platphormnews.com. Swipe animated fog to reveal motivational, philosophical, and life-goal fortunes across six categories: adventure, skill, experience, wisdom, chaos, and principle. Fortunes available in English, Spanish, and French. Public JSON REST API and MCP endpoint available. No account or login required.

## About

Fortune Fog is a Progressive Web App (PWA) published by [PlatphormNews](https://platphormnews.com) at [fortune.platphormnews.com](https://fortune.platphormnews.com). It delivers original fortune cookie-style quotes aligned to life goals. The app is free, installable, works offline, and has no ads or tracking.

## Fortune Categories

- **adventure** — fortunes about travel, exploration, and pushing beyond comfort zones
- **skill** — fortunes about mastery, learning, craft, and deliberate practice
- **experience** — fortunes about lived moments, relationships, and personal milestones
- **wisdom** — fortunes delivering philosophical insights and timeless truths
- **chaos** — fortunes from unexpected angles — subversive, irreverent, and unpredictable
- **principle** — fortunes grounded in core values, ethics, and guiding beliefs

## API

All endpoints return JSON. No authentication required. CORS is open (`*`).

- `GET /api/fortune` — random fortune; optional `?category=` and `?locale=en|es|fr`
- `GET /api/fortune/{id}` — fortune by UUID or slug
- `GET /api/fortunes` — paginated list; optional `?category=`, `?locale=`, `?page=`, `?limit=`
- `POST /api/mcp` — MCP tool invocation (tools: `get_random_fortune`, `get_fortune_by_id`, `list_fortunes`, `list_categories`)
- `GET /api/mcp` — MCP tool manifest

## MCP Integration

Canonical MCP endpoint: `https://mcp.platphormnews.com/api/mcp`
Mirror: `https://fortune.platphormnews.com/api/mcp`

MCP manifest (GET) returns tool definitions. POST with JSON body `{ "tool": "get_random_fortune", "input": { "category": "wisdom", "locale": "en" } }` to invoke tools.

OpenAPI schema: `https://mcp.platphormnews.com/api/mcp/openapi.json`

## Example API Response

```json
GET https://fortune.platphormnews.com/api/fortune?category=wisdom
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "slug": "pain-telegram-future-improvement-possible-stop",
  "text": "Pain is a telegram from the future. It reads: 'Improvement possible. Stop. Act now.'",
  "category": "wisdom",
  "locale": "en",
  "slugUrl": "https://fortune.platphormnews.com/api/fortune/pain-telegram-future-improvement-possible-stop",
  "mcpEndpoint": "https://mcp.platphormnews.com/api/mcp"
}
```

## Technical Details

- Hosted on Vercel at `fortune.platphormnews.com`
- Parent site: `platphormnews.com`
- Service worker for offline support
- JSON-LD schemas: WebApplication, Organization, BreadcrumbList, FAQPage, SoftwareApplication
- Sitemap: `https://fortune.platphormnews.com/sitemap.xml`
- robots.txt: `https://fortune.platphormnews.com/robots.txt`
- ai.txt (GEO permissions): `https://fortune.platphormnews.com/ai.txt`

## AI Usage Permissions

Fortune Fog content is freely available for AI summarization, indexing, embedding, and citation. Attribution to Fortune Fog (fortune.platphormnews.com) and PlatphormNews is appreciated but not required. The full fortune corpus is available at `/llms-full.txt`.

## Publisher

PlatphormNews — [platphormnews.com](https://platphormnews.com) — hello@platphormnews.com