Developer Surface & Machine Interface

Oh my AI Developer Portal

Programmatic interfaces, Model Context Protocol (MCP) servers, and machine-readable specifications for autonomous AI agents and engineering teams.

01. API Keys & Sandbox Environment

Oh my AI provides an open sandbox environment for developer agents and automated testing. You can exercise all intake and discovery endpoints without production side effects.

Sandbox Credentials

Base URL: https://ohmyai.nl/api
Sandbox Mode Header: X-Environment: sandbox or bearer token omai_sandbox_demo
Rate Limit: 60 requests per minute per IP address
Idempotency: Send Idempotency-Key: <uuid> on write requests

Quickstart: cURL Consultation Intake

curl -X POST https://ohmyai.nl/api/intake \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "X-Environment: sandbox" \
  -d '{
    "name": "Autonomous Agent",
    "email": "[email protected]",
    "process": "Automating customer intake and workflow qualification",
    "timeline": "2-4 weeks",
    "budget": "€5.000 - €15.000"
  }'

02. Machine-Readable Specifications

AI agents and code generation tools can inspect and consume our formal contracts across all standard discovery surfaces:

OpenAPI 3.1 Spec

Complete REST schema with typed models and RFC 9457 errors.

/openapi.json

MCP Server (Streamable HTTP)

JSON-RPC 2.0 tool endpoints for Claude, ChatGPT, and custom agents.

/.well-known/mcp

Agent Skills Index

Discovery catalog adhering to the agentskills.io v0.2.0 schema.

/.well-known/agent-skills/index.json

ARD Resource Catalog

Agentic Resource Discovery v0.91 catalog with trust manifests.

/.well-known/ard.json

Machine Auth Specification

WorkOS-compliant auth.md walkthrough for machine credentials.

/auth.md

Engagement Pricing

Structured pricing tiers, deliverable schedules, and SLA limits.

/pricing.md

03. Model Context Protocol (MCP) Integration

Our production MCP server runs on Streamable HTTP transport and provides 4 native tools for LLM agent integration:

get_services — List production automation capabilities, deliverables, and SLAs.
estimate_timeline — Calculate realistic timeline ranges based on workflow complexity.
submit_inquiry — Programmatically submit scoped requests for engineering review.
check_readiness — Run an audit check on workflow automation prerequisites.

Claude Desktop / Cursor Configuration

{
  "mcpServers": {
    "oh-my-ai": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-fetch", "https://ohmyai.nl/api/mcp"]
    }
  }
}

04. API Standards & Reliability Guarantees

RFC 9457 Problem Details: All 4xx and 5xx responses carry {"error": {"code": "...", "message": "...", "hint": "..."}}.
IETF Rate Limiting: Standard headers RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset are included on every response.
Content Negotiation: Send Accept: text/markdown to receive lightweight markdown versions of key pages.
CORS: All API and specification endpoints allow cross-origin requests (Access-Control-Allow-Origin: *).