# Oh my AI — Developer Portal & API Documentation

Welcome to the Oh my AI developer portal. Oh my AI provides production-grade machine interfaces designed for autonomous AI agents, tool-calling LLMs, and human software engineering teams. Deployed globally on Vercel with edge caching and Serverless Functions.

## 1. Machine Interfaces Overview

- **Model Context Protocol (MCP):** Streamable HTTP live handshake at `https://ohmyai-exedev.vercel.app/.well-known/mcp` and `/api/mcp`.
- **OpenAPI 3.1 Specification:** Machine-readable JSON schema at `https://ohmyai-exedev.vercel.app/openapi.json`.
- **Content Negotiation:** Automated Markdown delivery via `Accept: text/markdown` compliant with acceptmarkdown.com.
- **Agent Discovery:** Structured index at `/llms.txt`, extended context at `/llms-full.txt`, and guidance at `/agent-instructions.txt`.

## 2. Model Context Protocol (MCP) Server

Oh my AI exposes an MCP server using **Streamable HTTP** transport:

- **Endpoint:** `https://ohmyai-exedev.vercel.app/.well-known/mcp` (or `/api/mcp`)
- **Protocol version:** `2024-11-05`
- **Supported methods:** `initialize`, `tools/list`, `tools/call`, `ping`

### Tools

- `get_services`: Enumerate Oh my AI production capabilities (AI agents, GPT applications, workflow automation, and custom integrations).
- `estimate_timeline`: Calculate delivery timeline, milestones, and architectural tiers for an automation use case.
- `submit_inquiry`: Programmatically submit project requirements or consultation requests.
- `get_company_info`: Retrieve verified legal entity details, KvK registration, Maastricht headquarters, and contact points.

## 3. REST API Endpoints

### POST /api/intake
Submit a new project inquiry or workflow automation scoping request.

Payload format:
```json
{
  "systemType": "agent",
  "process": "Automate invoice verification and ERP data entry.",
  "timing": "immediate",
  "contact": {
    "name": "Jordan Engineer",
    "company": "Enterprise B.V.",
    "email": "jordan@example.com"
  }
}
```

## 4. Vercel Hosting & Architecture

- **Hosting Platform:** Vercel Anycast edge network (`ohmyai-exedev.vercel.app`).
- **Framework:** React 19 + Vite 6 client-side application in `dist/client/`.
- **Caching & Caching Headers:** `Vary: Accept, Accept-Encoding` configured across all routes.