# PlatPhorm Notes

https://notes.platphormnews.com

Purpose: Public learning notepad that enriches notes, detects terminology, looks up PlatPhorm Dictionary definitions, and stages human-approved dictionary submissions.

Public routes:
- /
- /docs
- /app
- /api/health
- /api/docs
- /openapi.yaml
- /api/mcp

Dictionary integration:
- Lookup through dictionary.platphormnews.com
- External submissions require explicit human approval in the UI

Embeddable tools:
- Sheets: https://sheets.platphormnews.com
- ASCII: https://ascii.platphormnews.com
- Emoji: https://emoji.platphormnews.com
- Phorm: https://phorm.platphormnews.com
- SVG: https://svg.platphormnews.com
- Sheets embeds can pull public server-indexed sheet metadata from /api/v1/sheets/{id}, rows, summary, quality, and schema endpoints.
- Emoji learning scores use Emoji Score public MCP tools such as score_sentiment and score_phrase_with_emoji.
- Phorm embeds use bounded MCP discovery for prompt-to-interface, review, and design preview capabilities.
- SVG embeds use bounded MCP discovery for templates, generation, validation, optimization, and data-url utilities.
- Agentic workflow templates are available at /api/workflows and /api/workflows/runs for public preview-only planning.

Authentication:
- No visitor authentication
- Backend service calls use PLATPHORM_API_KEY only
- Grok and Tigris credentials are backend-only provider secrets and are never accepted from clients

Privacy:
- Note bodies are not emitted in discovery files, feeds, or sitemaps
- Secrets, cookies, raw IPs, and x-vercel-ja4-digest are redacted from public output

Updated: 2026-06-10T17:15:56.495Z

Platform contract:
- Standard health, docs, OpenAPI, LLMS, robots, sitemap, feed, manifest, trust, agents, and MCP discovery routes are exposed.
- Modern web surfaces include humans.txt, Atom, RSS, sitemap index, structured data JSON-LD, favicon, generated sharecard, OpenGraph image, and Twitter image.
- REST API responses should use { "ok": true, "data": {} } or { "ok": false, "error": { "code": "", "message": "" } }.
- MCP uses JSON-RPC 2.0 at /api/mcp and lists only implemented public-safe tools.
- Deterministic term detection is available without AI. Grok-assisted definition drafting is review-only and degrades when grok_api_key is unavailable.
- Tigris object storage backs resource uploads when configured; missing storage credentials return honest degraded states.
- PlatPhorm service calls include traceparent, tracestate, X-PlatPhorm-Trace-Id, X-PlatPhorm-Request-Id, and X-PlatPhorm-Source-Site.
- OpenDocs, ASCII, Emoji, Phorm, SVG, Sheets, OpenContent, and AgentOps integrations expose honest degraded states when backend credentials or upstream service support is unavailable.

MCP tools:
- get_notes_info: Return public-safe PlatPhorm Notes database counts and degraded database status.
- get_public_templates: List public note templates that have been published from the notes workspace.
- lookup_dictionary_terms: Look up terms through PlatPhorm Dictionary using backend-only PlatPhorm service credentials.
- preview_term_detection: Run deterministic candidate term detection on supplied text without saving a note.
- preview_note_analysis: Return deterministic word count, reading time, and candidate terms for supplied note text.
- get_integration_status: Return public-safe integration configuration and degraded states.
- get_agent_policy: Return the public agent and AI policy for PlatPhorm Notes.
- get_health: Return the public health payload for PlatPhorm Notes.
- get_route_compliance: Return route compliance based on this service route registry.
- get_discovery_compliance: Return discovery file compliance based on this service route registry.
- get_workflow_templates: List public-safe agentic workflow templates available for PlatPhorm Notes.
- preview_agentic_workflow: Prepare a non-executing workflow run preview for note learning, publishing, sheet review, or AgentOps handoff.

MCP resources:
- notes://info: Notes Info
- notes://templates: Public Templates
- notes://integrations: Integration Status
- notes://openapi: OpenAPI
- notes://llms: LLMS Context
- notes://trust-policy: Trust Policy
- notes://workflows: Workflow Templates