Developer & AI Agent Hub

Developer Resources & API Hub

Predictable machine-readable specifications, OpenAPI definitions, MCP server configurations, and integration guides for developers and AI agents.

📋OpenAPI Spec (JSON)/openapi.json 📄OpenAPI Spec (YAML)/openapi.yaml ⚡MCP Server Config/mcp.json 🤖Agent Instructions/agent-instructions.md

Core Platform API Endpoints

Base URL: https://api.theiotworld.io

OpenAPI JSON ↗

POST/api/v1/telemetry/ingest

mTLS-authenticated telemetry & sensorimotor ingestion endpoint for Physical AI nodes, robotics & MHS gateways.

POST/api/v1/rag/query

Hybrid retrieval endpoint (pgvector + BM25) for equipment manuals, calibration runbooks, and spatial intelligence.

POST/api/v1/inference/vllm

Multi-tenant OpenAI-compatible low-latency inference endpoint backed by Ray Serve & vLLM with deterministic safety policies.

GET/api/v1/hardware/mhs/diagnostics

Model Hardware Standard (MHS)* diagnostic state, sensor drift metrics, and physical actuation interlocks. (*Subject to OEM / Anthropic access permissions)

Model Context Protocol (MCP) Integration

The IoT World exposes an MCP server for AI IDEs (Claude Desktop, Cursor, Antigravity) allowing agents to query live platform telemetry, trigger RAG lookups, and inspect hardware diagnostic streams securely.

{
  "mcpServers": {
    "theiotworld": {
      "command": "npx",
      "args": ["-y", "@theiotworld/mcp-server@latest"],
      "env": {
        "THEIOTWORLD_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}