PlatphormNews
v0.0.1MCP 2024-11-0572 tools · 16 resources · 23 prompts

API Documentation

Complete reference for the PlatphormNews MCP Platform API. 8+ sites, 11 MCP-enabled subdomains, 2 federated MCP servers. All endpoints follow JSON-RPC 2.0 over Streamable HTTP transport.

Download OpenAPI SpecView JSONAuto-Discovery

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/discovery
Discovery

Auto-discovery engine for *.platphormnews.com. Scan, list, crawl, and register subdomains. Supports ?subdomain=, ?action=scan|list|crawl, and POST for full registration.

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 (72)

All tools available via tools/call JSON-RPC method. Tool count reflects live server registration — use tools/list for the authoritative list.

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

Auto-Discovery

The network auto-discovery engine scans all 24 known *.platphormnews.com subdomains, queries MCP tools/list, resources/list, and prompts/list via JSON-RPC, and auto-registers newly discovered tools as SiteCapability records.

reader.platphormnews.com

base.platphormnews.com

docs.platphormnews.com

sheets.platphormnews.com

browserops.platphormnews.com

evals.platphormnews.com

agentui.platphormnews.com

webhooklab.platphormnews.com

cobol.platphormnews.com

claws.platphormnews.com

desa.platphormnews.com

Verticals covered:

Discovery Files

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

MCP Discovery
/.well-known/mcp.json

MCP manifest with live tool/resource/prompt counts, transport config, network federation info, and integration examples.

Agents Registry
/.well-known/agents.json

AI agent registry listing all MCP-enabled agents with IDE integration configs for Cursor, Windsurf, VS Code, Claude Desktop, and Zed.

AI Plugin Manifest
/.well-known/ai-plugin.json

OpenAI ChatGPT plugin manifest for AI assistant integration with live capability counts.

security.txt
/.well-known/security.txt

Security contact information following RFC 9116.

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 tools, parameters, resources, and prompts.

llms-index.json
/llms-index.json

Dynamic JSON metadata for LLM agents: live tool list, IDE configs, network map, and capability counts.

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.

IDE & Agent Integration

Connect to the MCP server from any compatible client or IDE.

Cursor / Claude Desktop
.cursor/mcp.json or claude_desktop_config.json
{
  "mcpServers": {
    "platphormnews": {
      "url": "https://mcp.platphormnews.com/api/mcp"
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "platphormnews": {
      "serverUrl": "https://mcp.platphormnews.com/api/mcp"
    }
  }
}
VS Code (GitHub Copilot)
.vscode/settings.json
{
  "mcp.servers": {
    "platphormnews": {
      "type": "http",
      "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"}}}'
List All Tools
Retrieve the live, authoritative list of 72 registered tools.
curl -X POST https://mcp.platphormnews.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'