# 🌐 PlatPhorm News — llms-full.txt
# 📚 Extended machine-readable context document (llmstxt.org)
# 🗓️ Last updated: 2026-03-07
# 🏗️ Version: 1.5.0

> 🚀 PlatPhorm News is a real-time, open-source-spirit news aggregation, **live games arena**, and **AI-powered platform network**.
> 🛠️ Built with SvelteKit 2 / Svelte 5 (runes), Tailwind CSS v4, deployed on Vercel.
> 🔗 Root domain: https://www.platphormnews.com
> 🎮 Games Platform: https://games.platphormnews.com
> 🤖 MCP Server: https://mcp.platphormnews.com (v2.0.0, 30 tools, Redis-backed)
> 🏘️ Community hub: https://ph3ar.com
> 👤 Created by Michael Barbine — Michael@Barbineworldwide.com — @BigNerdLoLz

---

## 🏗️ Architecture

- **Framework:** SvelteKit 2 + Svelte 5 (runes: `$state`, `$derived`, `$props`, `$effect`)
- **Styling:** Tailwind CSS v4 (LCARS-inspired dark design system — gold #c9a84c/#d4a84a/#e0c07a, purple #7a5ec7/#b088ff)
- **Hosting:** Vercel (adapter-vercel, nodejs22.x, iad1 region)
- **Analytics:** @vercel/analytics (privacy-first, no PII)
- **Data Sources:**
  - 📰 Hacker News Firebase API (stories, comments, users)
  - 🎮 Games API at games.platphormnews.com (catalog, servers, players, matches, leaderboards)
  - 🤖 MCP Platform API at mcp.platphormnews.com (network stats, tools, resources)
  - 🏈 Sports API at sports.platphormnews.com (scores, news, stats)
  - 😀 Emoji API at emoji.platphormnews.com (emoji search and library)
  - 📅 Calendar API at calendar.platphormnews.com (events, scheduling)
  - 📰 AltNews API at altnews.platphormnews.com (alternative news)
  - 🎨 ASCII API at ascii.platphormnews.com (art generation)
  - 👗 Fashion API at fashion.platphormnews.com (trends, news)
  - 📞 StarPhone API at starphone.platphormnews.com (communications)
  - 💼 Jobs API at jobs.platphormnews.com (career listings)
  - 🔄 Reflux API at reflux.platphormnews.com (data pipelines)
  - 🎮 GTA API at gta.platphormnews.com (GTA community)
  - 🤖 NPaaS API at npaas.platphormnews.com (AI news platform)
  - 🏹 Airrow API at airrow.platphormnews.com (AI recommendations)
  - 📖 Docs API at docs.platphormnews.com (documentation hub)
  - 📝 Markdown API at markdown.platphormnews.com (Markdown processing)
  - 📋 XML API at xml.platphormnews.com (XML tools)
  - 📊 JSON API at json.platphormnews.com (JSON tools)
  - 🧠 Polymaths API at polymaths.platphormnews.com (interdisciplinary research)
  - 🚀 Two API at two.platphormnews.com (next-gen platform)
- **i18n:** 10 locales (en, es, fr, de, ja, zh, pt, ko, ar, hi) with RTL support (Arabic)
- **MCP:** Model Context Protocol v1.1.0 — 30 tools exposed at /api/mcp
- **Standard Endpoints:** All sites in the PlatPhorm News network expose /api/docs, /api/mcp, and /api/health

---

## 🗺️ Full Route Map

| Route | Description |
|-------|-------------|
| `/` | 🏠 Home — Top HackerNews stories (news-focused) |
| `/top` | 🔝 HackerNews top 500 stories |
| `/best` | ⭐ HackerNews best stories |
| `/ask` | ❓ Ask threads |
| `/show` | 💡 Show submissions |
| `/jobs` | 💼 job board |
| `/news` | 📰 General news |
| `/games` | 🎮 Games Arena — live servers, leaderboards, matches |
| `/platform` | 🌐 PlatPhorm network — MCP tools, monitoring, feeds |
| `/story/[id]` | 📄 Individual story + comment thread |
| `/login` | 🔐 User authentication |
| `/signup` | ✍️ User registration |
| `/api/docs` | 📖 OpenAPI 3.1 interactive documentation |
| `/api/mcp` | 🤖 Model Context Protocol manifest + tool calls |
| `/api/games` | 🎮 Games stats proxy |
| `/api/platform` | 🌐 MCP platform stats proxy (60s cache) |
| `/api/sports` | 🏈 Sports news and stats proxy |
| `/api/emoji` | 😀 Emoji search and library proxy |
| `/api/calendar` | 📅 Calendar events proxy |
| `/api/altnews` | 📰 Alternative news proxy |
| `/api/ascii` | 🎨 ASCII art generation proxy |
| `/api/fashion` | 👗 Fashion news proxy |
| `/api/starphone` | 📞 StarPhone communications proxy |
| `/api/jobs` | 💼 Jobs listings proxy |
| `/api/reflux` | 🔄 Data pipeline proxy |
| `/api/gta` | 🎮 GTA community proxy |
| `/api/npaas` | 🤖 NPaaS platform proxy |
| `/api/airrow` | 🏹 Airrow AI proxy |
| `/api/webhooks` | 🔔 Inbound webhook receiver (Zapier, n8n) |
| `/api/health` | 💚 Health check with dependency probes |
| `/api/getTopStories` | 📊 Top stories JSON feed |
| `/api/getLatestNews` | 📰 Latest news JSON |
| `/api/getNewsDetails` | 📃 Story detail by ID |
| `/api/hackernews/*` | 🔥 HN-specific category feeds |
| `/rss.xml` | 📡 RSS 2.0 feed |
| `/sitemap.xml` | 🗺️ XML sitemap with hreflang × 10 locales |

---

## 🎮 Games Platform

PlatPhorm News integrates **live games browser-based platform** at https://games.platphormnews.com:

- 🏟️ **Real-time server stats** — online servers, active players, match counts
- 🏆 **Leaderboards** — top players with K/D ratios, updated in real-time
- ⚔️ **Match history** — recent games with map, mode, player count, duration
- 🎮 **Game Catalog** — multiple titles in the catalog
- 📊 **Stats API** — GET https://www.platphormnews.com/api/games

---

## 🌐 Featured Network Services

### 🏈 Sports (sports.platphormnews.com)
Live sports news, scores, and statistics.
- API: GET https://www.platphormnews.com/api/sports?type=news|scores|stats

### 😀 Emoji (emoji.platphormnews.com)
Emoji search, lookup, and custom emoji library.
- API: GET https://www.platphormnews.com/api/emoji?q=search&category=filter

### 📅 Calendar (calendar.platphormnews.com)
Shared calendar, event scheduling, and reminders.
- API: GET https://www.platphormnews.com/api/calendar?type=events&limit=10

### 📰 AltNews (altnews.platphormnews.com)
Alternative and independent news aggregation.
- API: GET https://www.platphormnews.com/api/altnews?type=stories&limit=10

### 🎨 ASCII (ascii.platphormnews.com)
ASCII art generator and text art tools.
- API: GET https://www.platphormnews.com/api/ascii?type=generate&text=hello&font=big

### 👗 Fashion (fashion.platphormnews.com)
Fashion news, trends, and style content.
- API: GET https://www.platphormnews.com/api/fashion?type=news|trends|collections

### 📞 StarPhone (starphone.platphormnews.com)
Next-generation communication platform — messaging, calls, and collaboration.
- API: GET https://www.platphormnews.com/api/starphone?type=status|features|stats

### 💼 Jobs (jobs.platphormnews.com)
Job board and career listings across the PlatPhorm network.
- API: GET https://www.platphormnews.com/api/jobs?type=listings&q=search&limit=20&page=1

### 🔄 Reflux (reflux.platphormnews.com)
Event-driven data pipeline and stream processing.
- API: GET https://www.platphormnews.com/api/reflux?type=status|streams|metrics

### 🎮 GTA (gta.platphormnews.com)
Grand Theft Auto news, stats, and community hub.
- API: GET https://www.platphormnews.com/api/gta?type=news|stats|community

### 🤖 NPaaS (npaas.platphormnews.com)
News Platform as a Service — AI-powered news ingestion and distribution.
- API: GET https://www.platphormnews.com/api/npaas?type=status|stats|pipelines

### 🏹 Airrow (airrow.platphormnews.com)
AI-powered recommendation and routing engine.
- API: GET https://www.platphormnews.com/api/airrow?type=recommendations|routes|stats&context=...

### 🤖 MCP (mcp.platphormnews.com)
Model Context Protocol server — AI tool manifest and execution endpoint.
- API: GET/POST https://www.platphormnews.com/api/mcp

---

## 🤖 MCP Tool Manifest

**Endpoint:** POST https://www.platphormnews.com/api/mcp
**Auth:** none (public read-only tools)
**Protocol:** Model Context Protocol v1.1.0 / JSON-RPC 2.0 (protocol version 2024-11-05)
**Transport:** Streamable HTTP (also supports legacy { tool, params } format)
**Discovery:** https://www.platphormnews.com/.well-known/mcp.json

### 📰 News Tools
1. `list_stories(category, limit, page)` — list stories by category
2. `get_story(id)` — full story detail by item ID
3. `search_stories(query, limit)` — full-text search via Algolia API
4. `get_altnews_stories(limit, category)` — alternative news from altnews.platphormnews.com

### 🌐 Network Tools
5. `list_domains(category)` — list all network domains
6. `get_domain(name)` — single domain detail
7. `get_network_info()` — full network overview

### 🎮 Games Tools
8. `get_games_catalog(limit, page)` — game catalog
9. `get_games_servers(game, mode)` — live server list
10. `get_games_leaderboard(game, sort, limit)` — top players
11. `get_games_stats(game)` — aggregate arena stats
12. `get_games_matches(game, limit)` — recent match history
13. `get_gta_stats(type, limit)` — GTA news and community

### 📊 Platform & Infrastructure Tools
14. `get_platform_stats()` — MCP server stats
15. `get_monitor_status(service)` — health status from monitor.platphormnews.com
16. `get_npaas_status(type)` — NPaaS platform status
17. `get_reflux_data(type)` — data pipeline metrics

### 🤖 AI Tools
18. `get_airrow_data(type, context)` — AI recommendations and routing

### 🎨 Content & Media Tools
19. `get_sports_news(type, limit)` — sports from sports.platphormnews.com
20. `get_emoji_data(query, category)` — emoji from emoji.platphormnews.com
21. `get_ascii_art(text, font)` — ASCII art from ascii.platphormnews.com
22. `get_fashion_content(type, limit)` — fashion from fashion.platphormnews.com
23. `get_calendar_events(limit, from)` — events from calendar.platphormnews.com

### 📞 Communications & Career Tools
24. `get_starphone_data(type)` — StarPhone communications
25. `get_jobs_listings(query, limit, page)` — job listings from jobs.platphormnews.com

---

## 🌐 MCP Network Sites

All major PlatPhorm services expose MCP endpoints at `/api/mcp` and discovery at `/.well-known/mcp.json`.
AI agents can discover and connect to any site in the network using the standard MCP protocol (JSON-RPC 2.0).

| Site | URL | MCP Endpoint | Category |
|------|-----|--------------|----------|
| MCP Hub | https://mcp.platphormnews.com | /api/mcp | service |
| Docs | https://docs.platphormnews.com | /api/mcp | service |
| Games | https://games.platphormnews.com | /api/mcp | gaming |
| Sports | https://sports.platphormnews.com | /api/mcp | content |
| Emoji | https://emoji.platphormnews.com | /api/mcp | content |
| Calendar | https://calendar.platphormnews.com | /api/mcp | infra |
| AltNews | https://altnews.platphormnews.com | /api/mcp | content |
| ASCII | https://ascii.platphormnews.com | /api/mcp | content |
| Fashion | https://fashion.platphormnews.com | /api/mcp | commerce |
| StarPhone | https://starphone.platphormnews.com | /api/mcp | comms |
| Jobs | https://jobs.platphormnews.com | /api/mcp | content |
| Reflux | https://reflux.platphormnews.com | /api/mcp | infra |
| GTA | https://gta.platphormnews.com | /api/mcp | gaming |
| NPaaS | https://npaas.platphormnews.com | /api/mcp | ai |
| Airrow | https://airrow.platphormnews.com | /api/mcp | ai |
| Markdown | https://markdown.platphormnews.com | /api/mcp | content |
| XML | https://xml.platphormnews.com | /api/mcp | infra |
| JSON | https://json.platphormnews.com | /api/mcp | infra |
| Polymaths | https://polymaths.platphormnews.com | /api/mcp | ai |
| Two | https://two.platphormnews.com | /api/mcp | service |
| Monitor | https://monitor.platphormnews.com | /api/mcp | service |

### MCP Network Discovery

- **Central MCP Discovery:** https://www.platphormnews.com/.well-known/mcp.json
- **Network Manifest:** https://www.platphormnews.com/network.manifest (includes mcp_enabled_sites)
- **LLM Index:** https://www.platphormnews.com/llms-index.json (live network data with MCP endpoints)
- **Network Graph:** https://www.platphormnews.com/api/network/graph (filter by category, get MCP metadata)
- **Domain Discovery:** https://www.platphormnews.com/api/domains (live Vercel API discovery)

To connect to any site's MCP endpoint, use: `https://{site}.platphormnews.com/api/mcp`
To discover a site's tools, send: `POST /api/mcp` with `{"jsonrpc":"2.0","id":1,"method":"tools/list"}`

---

## 🌐 Network Graph API

PlatPhorm News now exposes the entire network as a **graph of nodes (domains) and edges (relationships)**.

**Endpoint:** GET https://www.platphormnews.com/api/network/graph
**Filtering:** ?filter=subdomain|partner|external|service|api, ?category=gaming|infra|ai|commerce|community|content|comms|...
**Stats-only:** ?stats=true
**DynamoDB Explorer:** GET https://www.platphormnews.com/api/dynamodb?action=discover (read-only)
**Domain Discovery:** GET https://www.platphormnews.com/api/domains

### Node Categories
- **infra**: admin, api, analytics, deployments, monitor, lab, logslash, calendar, reflux
- **gaming**: games, gta, gta6, backyardbrawl, robotwrestling, flamethrower
- **community**: ph3ar, chat, chatv2, echo, radio
- **commerce**: shop, globalshop, roboclothes, fashion, fasion, legos
- **content**: blog, news, sports, nomad, dronereel, emoji, fortune, altnews, ascii, jobs, phearnews
- **finance**: finance, nad, polymarkets, frontrunners
- **faith**: a1bibles, bibles, reliablebible
- **comms**: mail, mailthing, starphone, uberpidgeons, emailreading
- **security**: ja4-atlas, threatrelay, spectrum-k9, biocyber
- **ai**: mcp, airrow, npaas, dogstar-cybernetics, microwave

---

## 🌐 Subdomain Network (platphormnews.com)

PlatPhorm News operates a network of **130+ subdomains**, all under platphormnews.com:

ascii, admin, airrow, analytics, api, blog, calendar, chat, deployments, echo, emoji,
fashion, games, gta, jobs, lab, mail, mcp, monitor, news, npaas, preview, projects,
reflux, sports, shop, radio, starphone, altnews, and 100+ others.

See https://www.platphormnews.com/sitemap.xml or https://www.platphormnews.com/network.manifest for full indexed list.

---

## 🌍 Internationalization

Supported locales: 🇺🇸 en · 🇪🇸 es · 🇫🇷 fr · 🇩🇪 de · 🇯🇵 ja · 🇨🇳 zh · 🇧🇷 pt · 🇰🇷 ko · 🇸🇦 ar · 🇮🇳 hi
- ✅ hreflang tags present on all primary routes
- ✅ Language switcher in footer navigation
- ✅ RTL support for Arabic (ar)
- ✅ Browser language auto-detection with localStorage persistence

---

## 🔍 SEO & Structured Data

- ✅ JSON-LD: NewsMediaOrganization + WebSite + SearchAction on all pages
- ✅ Open Graph tags (title, description, image, type, locale) on all pages
- ✅ Twitter Card (summary_large_image) on all pages
- ✅ Canonical URLs on all pages
- ✅ robots.txt: https://www.platphormnews.com/robots.txt
- ✅ Sitemap: https://www.platphormnews.com/sitemap.xml
- ✅ RSS: https://www.platphormnews.com/rss.xml
- ✅ llms.txt: https://www.platphormnews.com/llms.txt
- ✅ MCP well-known: https://www.platphormnews.com/.well-known/mcp.json
- ✅ knowsAbout: Technology News, Sports, Fashion, Gaming, GTA, Emoji, Jobs, AI, MCP, etc.

---

## 🔔 Webhooks

**Endpoint:** POST https://www.platphormnews.com/api/webhooks
**Events:** story.created, story.trending, comment.created, ping, custom
**Compatible with:** Zapier, n8n, Make.com, custom HTTP

---

## 👤 Contact & Community

- 🌐 Hosted Site: https://www.platphormnews.com
- 🏘️ Community Hub: https://ph3ar.com/about
- 📝 Blog: https://blog.ph3ar.com
- ✍️ Author: Michael Barbine
- 📧 Email: Michael@Barbineworldwide.com
- 🐙 GitHub: https://www.github.com/mbarbine
- 🐦 Twitter/X: @BigNerdLoLz

---

## ⚖️ Legal

Content aggregated from Hacker News is subject to Terms of Service.
Original site code and design © 2026 Michael Barbine / PlatPhorm, Inc.
Privacy policy: https://www.platphormnews.com/privacy
Terms: https://www.platphormnews.com/terms