{"slug":"integration","title":"Platphorm News Network Integration","description":"How Polymaths integrates with the Platphorm News ecosystem","lastUpdated":"2026-03-06","category":"integration","content":"# Platphorm News Network Integration\n\n> How Polymaths connects with the broader network\n> Part of the Platphorm News Network\n\n---\n\n## Network Overview\n\nThe **Platphorm News Network** is a federated collection of 84+ specialized sites sharing a common infrastructure and interoperability layer based on the Model Context Protocol (MCP).\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│                    PLATPHORM NEWS NETWORK                       │\n│                         v0.0.5                                  │\n├─────────────────────────────────────────────────────────────────┤\n│                                                                 │\n│   ┌─────────────┐    ┌─────────────┐    ┌─────────────┐        │\n│   │    MCP      │    │   Monitor   │    │    DESA     │        │\n│   │    Hub      │    │  Dashboard  │    │  Analytics  │        │\n│   └──────┬──────┘    └──────┬──────┘    └──────┬──────┘        │\n│          │                  │                  │                │\n│   ┌──────┴──────────────────┴──────────────────┴──────┐        │\n│   │              Network Fabric (MCP + REST)          │        │\n│   └──────┬──────────────────┬──────────────────┬──────┘        │\n│          │                  │                  │                │\n│   ┌──────┴──────┐    ┌──────┴──────┐    ┌──────┴──────┐        │\n│   │  Polymaths  │    │    Jobs     │    │    Atlas    │        │\n│   │   (this)    │    │             │    │             │        │\n│   └─────────────┘    └─────────────┘    └─────────────┘        │\n│                                                                 │\n│   + 80 more federated sites...                                 │\n│                                                                 │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Network Statistics\n\n| Metric | Value |\n|--------|-------|\n| Total Sites | 84 |\n| MCP-Enabled Sites | 12 |\n| Total Tools | 105 |\n| Resources | 25 |\n| Prompts | 20 |\n\n---\n\n## Key Network Sites\n\n### Infrastructure\n\n| Site | Domain | Purpose |\n|------|--------|---------|\n| MCP Hub | mcp.platphormnews.com | Central MCP registry and orchestration |\n| Monitor | monitor.platphormnews.com | Network health and uptime dashboard |\n| DESA | desa.platphormnews.com | Data engineering and analytics |\n| Atlas | atlas.platphormnews.com | Geographic and spatial data |\n\n### Content & Services\n\n| Site | Domain | Purpose |\n|------|--------|---------|\n| Jobs | jobs.platphormnews.com | Career platform with interview coordination |\n| SVG Factory | svg.platphormnews.com | SVG generation and optimization tools |\n| COBOL AI | cobol.platphormnews.com | Legacy code modernization |\n| Games | games.platphormnews.com | Browser-based mini games |\n| Reflux | reflux.platphormnews.com | Band merchandise store |\n| Warm | warm.platphormnews.com | Functional hot chocolate e-commerce |\n\n---\n\n## Polymaths Integration Points\n\n### 1. MCP Hub Registration\n\nPolymaths is registered with the central MCP hub:\n\n```json\n{\n  \"name\": \"Polymaths\",\n  \"domain\": \"polymaths.platphormnews.com\",\n  \"vertical\": \"education\",\n  \"description\": \"Comprehensive resource for polymathic learning and development\",\n  \"mcpEnabled\": true,\n  \"mcpUrl\": \"https://polymaths.platphormnews.com/api/mcp\"\n}\n```\n\n### 2. Available MCP Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_polymath` | Retrieve a polymath profile by slug |\n| `list_polymaths` | List all polymaths with filtering |\n| `get_principles` | Get the 7 pillars of polymathy |\n| `get_random_quote` | Get an inspiring polymath quote |\n| `search_content` | Full-text search across all content |\n| `get_learning_path` | Get structured learning curriculum |\n\n### 3. Cross-Site Features\n\n#### Jobs Integration\n\n```typescript\n// Recommend careers based on polymath interests\nconst recommendations = await fetch(\n  'https://jobs.platphormnews.com/api/v1/recommendations',\n  {\n    method: 'POST',\n    body: JSON.stringify({\n      interests: ['technology', 'art', 'science'],\n      polymathProfile: 'generalist'\n    })\n  }\n);\n```\n\n#### Atlas Integration\n\n```typescript\n// Get geographic data for polymath birthplaces\nconst locations = await fetch(\n  'https://atlas.platphormnews.com/api/v1/points',\n  {\n    method: 'POST',\n    body: JSON.stringify({\n      points: polymaths.map(p => ({\n        label: p.name,\n        location: p.birthplace\n      }))\n    })\n  }\n);\n```\n\n#### Analytics (DESA)\n\n```typescript\n// Send learning analytics events\nawait fetch('https://desa.platphormnews.com/api/v1/events', {\n  method: 'POST',\n  body: JSON.stringify({\n    source: 'polymaths.platphormnews.com',\n    event: 'learning_path_started',\n    data: { path: 'renaissance-mind', userId: '...' }\n  })\n});\n```\n\n---\n\n## MCP Protocol Implementation\n\n### Endpoint\n\n`POST https://polymaths.platphormnews.com/api/mcp`\n\n### Protocol Version\n\nJSON-RPC 2.0 (MCP v0.0.5 compatible)\n\n### Supported Methods\n\n#### Initialize\n\n```json\n{\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"initialize\",\n  \"params\": {\n    \"protocolVersion\": \"2024-11-05\",\n    \"capabilities\": {},\n    \"clientInfo\": { \"name\": \"example-client\", \"version\": \"1.0.0\" }\n  },\n  \"id\": 1\n}\n```\n\n#### List Tools\n\n```json\n{\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"tools/list\",\n  \"params\": {},\n  \"id\": 2\n}\n```\n\n#### Call Tool\n\n```json\n{\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"tools/call\",\n  \"params\": {\n    \"name\": \"get_polymath\",\n    \"arguments\": { \"slug\": \"leonardo-da-vinci\" }\n  },\n  \"id\": 3\n}\n```\n\n### Full Tool Definitions\n\n```json\n{\n  \"tools\": [\n    {\n      \"name\": \"get_polymath\",\n      \"description\": \"Get detailed profile of a historical polymath\",\n      \"inputSchema\": {\n        \"type\": \"object\",\n        \"properties\": {\n          \"slug\": {\n            \"type\": \"string\",\n            \"description\": \"URL slug of the polymath (e.g., 'leonardo-da-vinci')\"\n          }\n        },\n        \"required\": [\"slug\"]\n      }\n    },\n    {\n      \"name\": \"list_polymaths\",\n      \"description\": \"List all polymaths with optional filtering\",\n      \"inputSchema\": {\n        \"type\": \"object\",\n        \"properties\": {\n          \"era\": {\n            \"type\": \"string\",\n            \"enum\": [\"ancient\", \"medieval\", \"renaissance\", \"enlightenment\", \"modern\", \"contemporary\"]\n          },\n          \"discipline\": {\n            \"type\": \"string\",\n            \"description\": \"Filter by primary discipline\"\n          },\n          \"limit\": {\n            \"type\": \"number\",\n            \"default\": 20\n          }\n        }\n      }\n    },\n    {\n      \"name\": \"get_principles\",\n      \"description\": \"Get the core principles of polymathic thinking\",\n      \"inputSchema\": {\n        \"type\": \"object\",\n        \"properties\": {}\n      }\n    },\n    {\n      \"name\": \"get_random_quote\",\n      \"description\": \"Get a random inspiring quote from a polymath\",\n      \"inputSchema\": {\n        \"type\": \"object\",\n        \"properties\": {\n          \"author\": {\n            \"type\": \"string\",\n            \"description\": \"Optional: filter by specific polymath\"\n          }\n        }\n      }\n    },\n    {\n      \"name\": \"search_content\",\n      \"description\": \"Search across all polymaths, principles, and resources\",\n      \"inputSchema\": {\n        \"type\": \"object\",\n        \"properties\": {\n          \"query\": {\n            \"type\": \"string\",\n            \"description\": \"Search query\"\n          },\n          \"type\": {\n            \"type\": \"string\",\n            \"enum\": [\"all\", \"polymaths\", \"principles\", \"quotes\", \"resources\"]\n          }\n        },\n        \"required\": [\"query\"]\n      }\n    }\n  ]\n}\n```\n\n---\n\n## Network Discovery\n\n### .well-known Endpoints\n\n| Endpoint | Purpose |\n|----------|---------|\n| `/.well-known/mcp.json` | MCP capability manifest |\n| `/llms.txt` | LLM discovery file |\n| `/llms-full.txt` | Comprehensive LLM context |\n| `/llms-index.json` | Structured capability index |\n| `/api/health` | Health check endpoint |\n| `/sitemap.xml` | XML sitemap |\n| `/rss.xml` | RSS feed |\n\n### Sitemap Integration\n\nThe network aggregates sitemaps from all sites:\n\n```xml\n<!-- platphormnews.com/sitemap-main.xml -->\n<sitemapindex xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\n  <sitemap>\n    <loc>https://polymaths.platphormnews.com/sitemap.xml</loc>\n  </sitemap>\n  <sitemap>\n    <loc>https://jobs.platphormnews.com/sitemap.xml</loc>\n  </sitemap>\n  <!-- ... other sites -->\n</sitemapindex>\n```\n\n---\n\n## Authentication & Authorization\n\n### Current State\n\nPolymaths is a public resource with no authentication required for read operations.\n\n### Future State (Planned)\n\nWhen network-wide authentication is available:\n\n```typescript\n// Planned: Network SSO integration\nconst session = await getNetworkSession(request);\n\nif (session?.user) {\n  // Personalized features\n  const preferences = await getUserPreferences(session.user.id);\n}\n```\n\n---\n\n## Event System\n\n### Outbound Events\n\nPolymaths emits events for network-wide consumption:\n\n| Event | Trigger | Data |\n|-------|---------|------|\n| `polymath.viewed` | Profile page view | `{ slug, timestamp }` |\n| `learning.started` | Learning path begun | `{ path, userId }` |\n| `ai.conversation` | Mentor chat message | `{ messageCount, topic }` |\n| `search.performed` | Search query | `{ query, results }` |\n\n### Inbound Events\n\nEvents consumed from network:\n\n| Event | Source | Action |\n|-------|--------|--------|\n| `user.created` | Network auth | Create local profile |\n| `content.updated` | CMS | Invalidate cache |\n| `network.alert` | Monitor | Display notification |\n\n---\n\n## API Versioning\n\n### Current Version\n\n`v1` - Stable, production-ready\n\n### Version Strategy\n\n| Version | Status | Support |\n|---------|--------|---------|\n| v1 | Current | Full support |\n| v2 | Planned | Q3 2026 |\n\n### Deprecation Policy\n\n- 6-month notice before deprecation\n- 12-month overlap period\n- Sunset headers in responses\n\n---\n\n## Monitoring\n\n### Health Dashboard\n\nView Polymaths status at: [monitor.platphormnews.com](https://monitor.platphormnews.com)\n\n### Metrics Reported\n\n| Metric | Frequency |\n|--------|-----------|\n| Uptime | Real-time |\n| Response time | 1 minute |\n| Error rate | 1 minute |\n| Request volume | 1 minute |\n\n---\n\n## Contributing to Network\n\n### Registering New Capabilities\n\n```typescript\n// Register a new tool with the network\nawait fetch('https://mcp.platphormnews.com/api/tools/register', {\n  method: 'POST',\n  headers: {\n    'Authorization': `Bearer ${PLATPHORM_API_KEY}`,\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({\n    site: 'polymaths.platphormnews.com',\n    tool: {\n      name: 'new_tool_name',\n      description: '...',\n      inputSchema: { ... }\n    }\n  })\n});\n```\n\n### Network Governance\n\n- Changes proposed via GitHub issues\n- Community review period\n- Maintainer approval required\n- Coordinated rollouts\n\n---\n\n## Contact\n\n- **Network Issues:** [github.com/platphormnews/network](https://github.com/platphormnews)\n- **Site Issues:** [github.com/platphormnews/polymaths](https://github.com/platphormnews)\n- **General:** [platphormnews.com/contact](https://platphormnews.com/contact)\n\n---\n\n*Document Version: 1.0.0*\n*Last Updated: March 2026*\n*Part of the Platphorm News Network*\n","url":"https://polymaths.platphormnews.com/docs/integration","apiUrl":"https://polymaths.platphormnews.com/api/v1/docs/integration","formats":{"json":"/api/v1/docs/integration","markdown":"/api/v1/docs/integration?format=markdown"}}