What is PlatPhorm News?

PlatPhorm News is the public root and demilitarized read-only entry point for the PlatPhorm network. It aggregates public source-attributed stories and exposes the root graph, discovery files, feeds, and trusted-domain directory.

What is the PlatPhorm network?

The PlatPhorm network is the set of trusted and pending *.platphormnews.com services discovered through the root graph, static registry, and sitemap surfaces.

What is MCP (Model Context Protocol)?

MCP is used where it matches a site purpose. The root exposes a local MCP endpoint for public story and network discovery, with protected actions gated by PLATPHORM_API_KEY.

How do I access the PlatPhorm News API?

The API is available at /api/docs and /openapi.yaml with endpoints for stories, feeds, network graph, route compliance, trusted domains, and MCP discovery.

What requires authentication?

Public read-only discovery is open. Mutating, sync, test-triggering, reporting, publishing, and administrative actions require PLATPHORM_API_KEY.

API Documentation

Public read-only API for stories, trusted-domain discovery, network graph inspection, MCP introspection, route evidence, and support metadata.

General Information

Base URL: https://platphormnews.com
Public GET endpoints are available without authentication. REST responses use { ok, data } or { ok: false, error } where the route is part of the platform contract.

Five-minute quickstart

curl https://platphormnews.com/api/v1/stories/top

curl https://platphormnews.com/api/mcp

curl https://platphormnews.com/api/v1/network/graph

curl https://platphormnews.com/.well-known/trust.json

curl https://platphormnews.com/status/contracts

Authentication

Public GET requests do not require authentication. Protected sync, write, report persistence, registry mutation, and administrative actions require Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY.

Surface	Public read	Protected write/sync
Stories	yes	no
Network graph	yes	sync protected
Trust policy	yes	mutation protected
MCP introspection	yes	protected tools require key
Support metadata	yes	report persistence degraded/protected by payload
Webhooks	no	yes

Error schema

{
  "ok": false,
  "error": {
    "code": "auth_required",
    "message": "Protected action requires authentication.",
    "details": {},
    "traceId": "optional-trace-id"
  }
}

Endpoints

GET /api/v1/health

Check system health and status.

GET /api/mcp

Retrieve the public root MCP manifest and usage metadata.

POST /api/mcp

Execute JSON-RPC MCP methods. Public introspection is open; protected tools require PLATPHORM_API_KEY.

Params: jsonrpc, method, params

GET /api/v1/support

Retrieve support categories, contact routes, and public-safe reporting guidance.

POST /api/v1/support/report

Create a redacted support packet. Durable storage is degraded unless backend persistence is configured.

Params: category, url, description, severity, traceId

GET /api/v1/status

Root status summary with route, discovery, MCP, news, and integration posture.

GET /api/v1/integrations

Public integration directory for platform services routed from the root.

GET /api/v1/trust

Public trust policy envelope.

GET /api/v1/agent-policy

Public agent and crawler policy.

POST /api/v1/webhooks

Endpoint for external integrations (Zapier/n8n).

Params: event, payload

GET /api/v1/network/graph

Fetch the full network graph (nodes & edges).

Params: filter, category

GET /api/v1/public-contract

Fetch the canonical public contract used by trust, MCP, status, docs, and LLM surfaces.

Params: live

GET /api/v1/route-compliance

Read the route compliance summary. Use live=true where supported for fetched evidence.

GET /api/v1/discovery-compliance

Read discovery-file compliance for llms, OpenAPI, RSS, sitemap, robots, and well-known files.

GET /api/games

PlatPhorm Games data proxy — catalog, servers, leaderboard, stats, or matches.

Params: type, game, mode, sort, limit, page

Request examples

TypeScript

const res = await fetch("https://platphormnews.com/api/v1/network/graph");
const graph = await res.json();

Python

import requests
graph = requests.get("https://platphormnews.com/api/v1/network/graph").json()

MCP JSON-RPC

curl https://platphormnews.com/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'