# PlatPhormNews MCP Gateway Full Specification v0.1.0

This document contains the complete live technical specification for the PlatPhormNews MCP Gateway.
Generated at: 2026-06-11T07:40:19.691Z

## Statistical Overview
- Total Tools: 140
- Total Resources: 16
- Total Prompts: 23
- Categories: 16
- Registered Sites: 142
- Graph Nodes: 178
- Graph Edges: 227
- Health: healthy
- Redis: connected
- DynamoDB: degraded (READ_ONLY)
- Protocol: MCP 2024-11-05 (JSON-RPC 2.0)

## Truth Model
- Tool/resource/prompt/category counts: in-process MCP registry from registered handlers
- Registered sites, nodes, and edges: https://platphormnews.com/api/network/graph
- Crawlable public surface: https://base.platphormnews.com/sitemap-index.xml
- Storage: Redis and DynamoDB are dependency/storage surfaces, not canonical MCP count sources.

## Connection

```json
{"mcpServers":{"platphormnews":{"url":"https://mcp.platphormnews.com/api/mcp"}}}
```

## Quick Start

```bash
# List all tools
curl -X POST https://mcp.platphormnews.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Initialize before a tool call; keep Mcp-Session-Id from the response, then send notifications/initialized
curl -i -X POST https://mcp.platphormnews.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":"init","method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'
```

## Available Tools by Category (140 total)

### Analytics (7 tools)
- get_analytics
- list_events
- emit_event
- aggregate_analytics
- track_event
- list_recent_events
- dynamo_list_events

### Categories (4 tools)
- list_categories
- create_category
- update_category
- delete_category

### Content (8 tools)
- list_articles
- get_article
- create_article
- update_article
- delete_article
- publish_article
- search_articles
- dynamo_list_articles

### Deployments (3 tools)
- list_deployments
- record_deployment
- get_deployment

### DynamoDB (1 tools)
- dynamo_table_info

### FAQ (4 tools)
- list_faqs
- create_faq
- update_faq
- delete_faq

### Federation (1 tools)
- get_platform_stats

### GitHub (4 tools)
- list_org_repos
- get_repo_details
- get_org_info
- get_trending_repos

### Infrastructure (4 tools)
- list_neon_infrastructure
- list_render_infrastructure
- list_vercel_infrastructure
- get_vercel_project_details

### MCP Federation (6 tools)
- list_federated_mcp_tools
- list_mcp_servers
- proxy_mcp_call
- get_mcp_server
- sync_mcp_server
- validate_mcp_server

### Network (14 tools)
- get_network_info
- network_status
- get_network_sites
- get_network_mcp_servers
- resolve_network_domain
- fetch_network_sitemap
- discover_site_api
- get_site_health
- get_network_health_summary
- list_network_sites
- list_trusted_domains
- get_route_compliance
- get_network_capability_matrix
- get_network_graph

### Registry (55 tools)
- register_capability
- get_audit_trail
- search_producthunt
- get_producthunt_post
- trending_producthunt
- sync_network_graph
- get_discovery_compliance
- list_capabilities
- get_capability
- deprecate_capability
- validate_capability
- reconcile_registry_counts
- validate_discovery_files
- read_llms_file
- read_llms_index
- validate_openapi
- validate_rss
- validate_well_known_files
- create_docs_report
- create_sheet_report
- create_deck_summary
- summarize_capability
- recommend_tools
- explain_tool_risk
- generate_client_config
- generate_remediation_summary
- list_tools
- get_tool
- list_resources
- get_resource
- list_prompts
- get_prompt
- get_gateway_status
- get_integration_status
- get_client_config
- get_ide_instructions
- get_agent_policy
- list_agent_platforms
- get_agent_platform
- evaluate_agent_access
- get_robots_policy
- get_ai_policy
- get_discovery_manifest
- get_public_access_summary
- get_health
- get_info
- validate_generated_tool
- publish_generated_tool
- run_eval
- run_sandbox_test
- run_browserops_test
- update_agent_policy
- refresh_agent_platform_registry
- export_agent_audit_report
- create_agent_policy_report

### Search (3 tools)
- search_org_code
- search_all_sites
- search_capability_graph

### Security (2 tools)
- get_claws_intelligence
- get_trust_policy

### Sites (21 tools)
- discover_network_sites
- resolve_trusted_site
- list_sites
- get_site
- register_site
- generate_site_token
- update_site
- resolve_domain
- list_site_domains
- sync_sitemap
- crawl_site_capabilities
- validate_site_mcp
- get_subdomain_orchestration_profile
- validate_sitemap
- validate_no_dead_sitemap_links
- list_registered_sites
- unregister_site
- refresh_site_discovery
- generate_tools_from_site
- dynamo_list_sites
- dynamo_get_site

### Verticals (3 tools)
- get_quake_stats
- search_platform_jobs
- get_fashion_trends

## Federated Network Tools

The 140 tools above are local callable tools for this MCP hub. Network-wide remote MCP tools are exposed separately as source-labeled federated capabilities at https://mcp.platphormnews.com/api/v1/registry/federated-tools?live=1 and https://mcp.platphormnews.com/api/v1/registry/tools?scope=federated&live=1. Remote tools remain owned by their source service and are not folded into local tools/list unless delegated through explicit gateway policy.

## Resources (16 total)

- `platphormnews://config`: Site configuration: name, description, URL, locales, version.
- `platphormnews://articles`: All published articles as a JSON feed.
- `platphormnews://categories`: All content categories with name, slug, and description.
- `platphormnews://faqs`: All FAQs with answers, organized by category.
- `platphormnews://sites`: All registered sites in the platform registry.
- `platphormnews://events`: Recent platform events from the outbox.
- `platphormnews://deployments`: Recent deployment records across all sites.
- `platphormnews://platform-stats`: Platform-wide statistics: site count, articles, tools, version.
- `platphormnews://domain-map`: Full domain-to-site mapping for all registered sites.
- `platphormnews://mcp-servers`: All MCP servers in the federation registry.
- `platphormnews://audit-trail`: Recent audit trail entries for all write operations.
- `platphormnews://llms`: LLM discovery metadata for the platform.
- `platphormnews://capabilities`: All registered tools, resources, and prompts across the site network.
- `platphormnews://health`: Unified health status of network subdomains and infrastructure.
- `platphormnews://icons/{vertical}`: Dynamic SVG icons generated from Unicode emojis for network branding.
- `platphormnews://system-prompt`: The ultimate system prompt for an AI agent to orchestrate the network.

## Prompts (23 total)

- `write-article`: Generate a well-structured article on a given topic with SEO optimization
- `summarize-article`: Create a concise summary of an article preserving key insights
- `generate-faq`: Generate FAQ entries for a topic or product
- `seo-optimize`: Optimize content for search engines
- `editorial-review`: Perform editorial review with improvement suggestions
- `network-health-report`: Generate comprehensive network health report
- `cross-site-search`: Search across all network sites
- `site-health-check`: Deep health check for a specific site
- `discover-network`: Discover and map the entire network
- `register-new-site`: Register a new site in the network
- `migration-plan`: Generate migration plan for site updates
- `platform-overview`: Generate platform overview report
- `json-format`: Format and validate JSON using json.platphormnews.com
- `json-diff`: Compare two JSON documents
- `desa-analyze`: Analyze data with desa.platphormnews.com
- `desa-query`: Query data from DESA
- `atlas-map`: Create geographic visualizations with atlas.platphormnews.com
- `atlas-geocode`: Geocode addresses to coordinates
- `monitor-status`: Check deployment and service status with monitor.platphormnews.com
- `monitor-alerts`: List active alerts and incidents
- `ascii-convert`: Convert image to ASCII art
- `calendar-schedule`: Schedule an event
- `quake-stats`: Get gaming statistics from quake.platphormnews.com

## Resource Protocol (platphormnews://)
- platphormnews://system-prompt: The ultimate orchestrator guide.
- platphormnews://capabilities: The dynamic, searchable capability registry.
- platphormnews://icons/{vertical}: Dynamic SVG iconography.
- platphormnews://health: Unified health dashboard data.

## Platform Integration Patterns

### Interactive Execution
The dashboard at https://mcp.platphormnews.com/mcp provides public-safe registry introspection and protected operator actions.

### Automated Site Onboarding
New subdomains can self-register via the `/api/mcp/register` webhook, automatically advertising their tools to the central hub.

### Batch Requests
POST an array of JSON-RPC objects to process multiple requests in one round-trip:
```json
[
  {"jsonrpc":"2.0","id":1,"method":"tools/list"},
  {"jsonrpc":"2.0","id":2,"method":"resources/list"},
  {"jsonrpc":"2.0","id":3,"method":"prompts/list"}
]
```

## Discovery Endpoints
- /.well-known/mcp.json — MCP discovery manifest
- /.well-known/agents.json — AI agent registry with IDE integration configs
- /.well-known/ai-plugin.json — OpenAI plugin manifest
- /llms.txt — LLM summary (this file's companion)
- /llms-index.json — Structured JSON for programmatic agent integration
- /api/docs — Full live API documentation
- /openapi.yaml — OpenAPI 3.1 specification
- /asyncapi.yaml — AsyncAPI event contract for MCP registry, gateway, factory, and handoff events
- /.well-known/web.json — Canonical Web Status manifest
- /api/web/status — Web Status, readiness checks, source labels, and route evidence
- /api/web/fingerprints — Public-safe Web Status capability fingerprints
- /.well-known/web4.json — Legacy Web4 compatibility alias
- /.well-known/provenance.json — Public provenance manifest
- /api/provenance/lookup and /api/provenance/verify — Public provenance lookup and hash verification