Developer & Agent Hub

Developer Portal & Agent APIs

Complete technical reference, OpenAPI 3.1 specifications, WebMCP tools, and deterministic endpoints for autonomous AI agents, crawlers, and developers.

OpenAPI 3.1.0 & WebMCP Ready · Rate Limit: 100 req/min

Machine Discovery & Specifications

OpenAPI 3.1 SpecJSON

/openapi.json — Typed API schemas and paths for LLM tool generation.

AI Plugin ManifestWell-Known

/.well-known/ai-plugin.json — Standard autonomous discovery manifest.

WebMCP ManifestProtocol

/.well-known/webmcp.json — Model Context Protocol declaration for agents.

LLMs ContextMarkdown

/llms.txt & /llms-full.txt — Curated essay markdown index.

Protocol Telemetry & AX Headers

Every API response emitted by zivisaiah.com contains standardized agentic experience (AX) telemetry headers conforming to the Ora (ora.ai) benchmark standards:

X-Agent-Ready: true
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 99
Access-Control-Allow-Origin: *
Cache-Control: public, max-age=3600, s-maxage=86400

API Endpoints Reference

GET/api/mcp/essays

Essays & Thought Leadership Catalog

Returns the complete library of published essays, including titles, publication dates, categories, word counts, excerpt previews, and canonical URLs.

Sample Response (JSON)

{
  "status": "success",
  "data": {
    "total": 19,
    "categories": [
      "Leadership & Culture",
      "Agentic AI & Security",
      "Deepfake Defense",
      "Product & Engineering Strategy",
      "Frontier AI"
    ],
    "essays": [...]
  }
}

GET/api/mcp/essays/search?q=agentic+security

Semantic & Keyword Essay Search

Enables agents to search across all published technical essays with keyword and semantic relevance scoring.

Sample Response (JSON)

{
  "status": "success",
  "query": "agentic security",
  "count": 5,
  "results": [
    {
      "slug": "engineering-my-website-for-the-agentic-web",
      "title": "Engineering My Website for the Agentic Web",
      "category": "Agentic AI & Security",
      "score": 0.94
    }
  ]
}

GET/api/mcp/bio

Executive Biography & Credentials

Structured profile containing executive background, US patent citations, venture track record, academic degrees, and verified links.

Sample Response (JSON)

{
  "status": "success",
  "data": {
    "name": "Ziv Isaiah",
    "role": "Co-Founder & CTO",
    "company": "Clarity",
    "patents": 3,
    "credentials": [
      "Kellogg Executive MBA",
      "TAU Electrical Eng & Physics"
    ]
  }
}

GET/api/mcp/projects

Ventures & Open Source Projects

List of co-founded startups (Clarity, nSure.ai, Zeek), active ventures, and open-source initiatives (webmcpgate, OneGate).

Sample Response (JSON)

{
  "status": "success",
  "data": [
    { "name": "Clarity", "url": "https://www.getclarity.ai/", "focus": "Deepfake Defense" },
    { "name": "nSure.ai", "url": "https://nsure.ai/", "focus": "Adaptive AI Fraud Prevention" },
    { "name": "OneGate", "url": "https://github.com/onegate-bot/onegate", "focus": "Agent Secrets Broker" }
  ]
}

POST/api/mcp/contact

Structured Agent Message & Inquiry

Allows verified agents and human visitors to submit structured business inquiries, partnership notes, and messages with strict JSON validation.

Sample Response (JSON)

{
  "status": "success",
  "message": "Inquiry received and dispatched to notification channel."
}

Agent & Developer Quickstart

Integrate or query the site directly from Python, Node.js, or curl:

cURL: Search Essays

curl -s "https://www.zivisaiah.com/api/mcp/essays/search?q=deepfake" \
  -H "Accept: application/json"

Python (httpx / requests): Fetch Bio & Patents

import httpx

response = httpx.get("https://www.zivisaiah.com/api/mcp/bio")
bio_data = response.json()
print(f"Name: {bio_data['data']['name']} - Patents: {bio_data['data']['patents']}")

TypeScript / Next.js Agent Client

const res = await fetch("https://www.zivisaiah.com/api/mcp/essays", {
  headers: { "Accept": "application/json" }
});
const { data } = await res.json();
console.log(`Loaded ${data.total} essays across ${data.categories.length} pillars.`);

Explore the WebMCP Architecture Guide

Learn how deterministic machine discovery, JSON-LD graphs, and client-side WebMCP standards transform web infrastructure for autonomous AI delegates.

Read the WebMCP Guide →