PlatphormNews
v2.0.0OpenAPI 3.1

API Documentation

Complete reference for the PlatphormNews MCP Platform API. All endpoints follow JSON-RPC 2.0 over Streamable HTTP transport with the MCP 2024-11-05 protocol.

Download OpenAPI SpecView JSON

Endpoints

All HTTP endpoints available on the PlatphormNews MCP server.

POST/api/mcp
MCPJSON-RPC

MCP JSON-RPC endpoint. Send JSON-RPC 2.0 messages for tools/call, resources/read, prompts/get, etc.

GET/api/mcp
MCPInfo

MCP server info with name, version, protocol, transport, and capability counts.

GET/api/health
Health

Health check with Redis connectivity, platform stats, and uptime metrics.

GET/api/docs
Docs

Structured JSON documentation of all endpoints, tools, resources, and prompts.

GET/api/v1/test/mcp
Test

Integration test runner. Tests MCP initialization and key tools across all categories. Add ?verbose=true for full data.

POST/api/v1/seed
Seed

Seed the platform registry with 50 Vercel-hosted sites and register the MCP federation server.

GET/api/ping
Health

Minimal ping endpoint returning OK status and timestamp for uptime monitoring.

MCP Tools (71)

All tools available via tools/call JSON-RPC method.

Network
7

network info, sites, MCP servers, domain resolve, sitemap, API discovery, health check

Content
6

list, get, create, update, delete, publish articles

Categories
4

list, create, update, delete categories

FAQ
4

list, create, update, delete FAQs

Search
1

full-text article search

Analytics
3

view counts, trending, event tracking

GitHub
5

org repos, details, info, code search, trending

Sites
12

list, get, register, update, resolve, token, capability, domains, sitemap, crawl, validate, audit-log

Events
3

list events, emit event, audit trail

Deployments
3

list, get by site, record deployment

Federation
3

cross-site search, platform stats, aggregate analytics

Product Hunt
3

today's posts, get post, search posts

MCP Proxy
2

list servers, proxy MCP call

Orchestrator
7

Neon, Render, Vercel infra + capability graph + health summary

Verticals
3

Quake stats, platform jobs, fashion trends

DynamoDB
5

list sites, get site, list articles, list events, table info

Discovery Files

Machine-readable files for search engines, LLM agents, and feed readers.

OpenAPI 3.1 Spec
/openapi.yaml

Full OpenAPI specification covering every endpoint, schema, tool, resource, and prompt.

llms.txt
/llms.txt

Summary LLM discovery file with endpoint, capabilities, and categories.

llms-full.txt
/llms-full.txt

Complete LLM specification with all 41 tools, parameters, resources, and prompts.

llms-index.json
/llms-index.json

Structured JSON metadata for LLM agents with tool categories and connection configs.

RSS 2.0
/rss.xml

RSS feed with platform updates and announcements.

Atom Feed
/feed.xml

Atom 1.0 feed with platform updates.

Sitemap
/sitemap.xml

XML sitemap with all public pages.

robots.txt
/robots.txt

Crawler directives for search engines.

Quick Start

Connect to the MCP server from any compatible client.

Claude Desktop / Cursor / Windsurf
Add this to your MCP client configuration file.
{
  "mcpServers": {
    "platphormnews": {
      "url": "https://mcp.platphormnews.com/api/mcp"
    }
  }
}
cURL Test
Quick test to verify the MCP server is responding.
curl -X POST https://mcp.platphormnews.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'