API AI Gateway

URL serveur MCP

Pour ChatGPT MCP / clients distants, utilisez l'endpoint HTTP streamable ci-dessous.

https://app.doxai.ch/v1/mcp

Body de requête

POST /v1/resume/jobs attend une enveloppe avec request_id et cv_data. cv_data.language accepte en, fr et de pour localiser les titres de sections par défaut et le libellé Présent. N'envoyez pas sections.*.type — il est déduit automatiquement par le serveur (accepté mais ignoré s'il est fourni) ; voir l'exemple cv_data ci-dessous.

{
  "request_id": "demo-job-001",
  "language": "fr",
  "cv_data": {
    "template": "original",
    "language": "fr",
    "theme_color": "NavyBlue",
    "font_family": "arial",
    "font_size": "11pt",
    "identity": {
      "first_name": "Ada",
      "last_name": "Lovelace"
    },
    "sections": {
      "summary": {
        "content": "Profil synthétique."
      }
    }
  }
}

Système

Inspection Auth

Modèles

Chat

Facturation

Jobs CV

MCP

Démarrage rapide API CV

RESPONSE=$(curl -sS "https://app.doxai.ch/v1/resume/jobs" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "request_id":"demo-job-001",
    "cv_data": {
  "template": "original",
  "language": "en",
  "theme_color": "NavyBlue",
  "font_size": "11pt",
  "font_family": "arial",
  "identity": {
    "first_name": "Leif",
    "last_name": "Doxarve",
    "jobtitle": "AI Product Engineer",
    "email": "leif@example.com",
    "mobile": "+41 79 123 45 67",
    "address": "Lausanne, Switzerland",
    "linkedin": "https://linkedin.com/in/leif-doxarve",
    "github": "https://github.com/mieleif",
    "website": "https://doxai.ch"
  },
  "sections_order": ["summary", "experience", "education", "projects", "skills", "languages"],
  "sections": {
    "summary": {
      "content": "AI product engineer focused on practical automation, LLM integrations, and scalable orchestration."
    },
    "experience": {
      "items": [
        {
          "title": "DoxAI",
          "subtitle": "Founder & Product Engineer",
          "location": "Lausanne, CH",
          "start": "2024-06",
          "end": "Present",
          "description_bullets": [
            "Built AI-assisted CV platform with public API and MCP-compatible tools.",
            "Implemented billing-aware gateway architecture with provider abstraction and failover.",
            "Operated Docker-based deployments with Traefik, GitHub Actions, and Supabase."
          ]
        },
        {
          "title": "Consulting Projects",
          "subtitle": "Software Engineer",
          "location": "Remote",
          "start": "2022-01",
          "end": "2024-05",
          "description_bullets": [
            "Delivered full-stack web apps with TypeScript, React, and Node.js.",
            "Integrated third-party APIs and automated reporting pipelines."
          ]
        }
      ]
    },
    "education": {
      "items": [
        {
          "title": "University Example",
          "subtitle": "BSc in Computer Science",
          "location": "Switzerland",
          "start": "2018-09",
          "end": "2021-07",
          "description_bullets": [
            "Focus: software engineering, data systems, and applied machine learning."
          ]
        }
      ]
    },
    "projects": {
      "items": [
        {
          "title": "CV API Gateway",
          "subtitle": "Public Tools-Only Runtime",
          "start": "2026-02",
          "end": "Present",
          "description_bullets": [
            "Exposed authenticated resume tooling for agent/CLI consumption.",
            "Added compile-action credit billing and idempotent request handling."
          ]
        }
      ]
    },
    "skills": {
      "items": [
        {
          "title": "Tech Stack",
          "description_bullets": [
            "TypeScript",
            "Node.js",
            "Next.js",
            "Fastify",
            "Supabase",
            "Docker",
            "Traefik",
            "GitHub Actions",
            "PostgreSQL"
          ]
        }
      ]
    },
    "languages": {
      "items": [
        {
          "title": "Languages",
          "description_bullets": [
            "French (native)",
            "English (professional)"
          ]
        }
      ]
    }
  }
}
  }')

JOB_ID=$(echo "$RESPONSE" | jq -r '.job_id')

curl -sS "https://app.doxai.ch/v1/resume/jobs/$JOB_ID" \
  -H "Authorization: Bearer $TOKEN" | jq '{job_id: .job.id, status: .job.status, warnings: .warnings}'

Réponse de polling CV

Interrogez GET /v1/resume/jobs/:jobId et lisez job.status. Valeurs possibles : queued, running, succeeded, failed, canceled.

{
  "ok": true,
  "request_id": "req_123",
  "warnings": [],
  "job": {
    "id": "f5821b92-9100-44ce-a610-c85c2499fe5b",
    "request_id": "demo-job-001",
    "mode": "managed",
    "status": "running",
    "created_at": "2026-03-17T15:00:00.000Z",
    "updated_at": "2026-03-17T15:00:01.000Z"
  }
}

Outils MCP

Les outils sont regroupés par namespace. Appelez tools/list pour obtenir les schémas d’entrée et de sortie, titres et annotations faisant foi.

Ressources MCP

Les lectures de ressources sont limitées à l’utilisateur authentifié. Utilisez resources/list pour découvrir les URI des CV enregistrés.

• cv://templates

  Static resume-template catalog.

• cv://resumes

  Index of the authenticated user's saved resumes.

• cv://resumes/{id}

  Stored JSON snapshot for one authenticated-user-owned resume.

• cv://profile

  Authenticated user's profile and normalized CV entries.

Versions du protocole

Le serveur négocie la version mutuellement prise en charge la plus récente lors de initialize. La sortie structurée des outils est disponible avec 2025-11-25 et 2025-06-18.

curl -sS -D /tmp/mcp_headers.txt "https://app.doxai.ch/v1/mcp" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":"init-1","method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"cli","version":"0.1.0"}}}'

SESSION_ID=$(grep -i '^MCP-Session-Id:' /tmp/mcp_headers.txt | awk '{print $2}' | tr -d '\r')

curl -X POST "https://app.doxai.ch/v1/mcp" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "MCP-Session-Id: $SESSION_ID" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":"tools-1","method":"tools/list","params":{}}'

Connecter votre agent

Créez un token API personnel avec mcp:connect, puis adaptez cette entrée de serveur distant à votre client MCP. Les clients compatibles OAuth peuvent s’authentifier via la découverte de ressource protégée du serveur.

{
  "mcpServers": {
    "cv-doxai": {
      "url": "https://app.doxai.ch/v1/mcp",
      "headers": {
        "Authorization": "Bearer <token_with_mcp:connect>"
      }
    }
  }
}

initialize → notifications/initialized → tools/list / resources/list → tools/call / resources/read

Exemple public cv_data

Payload de départ copiable pour /v1/resume/jobs ou MCP resume.create_job. Utilise les tableaux description_bullets canoniques pour le rendu PDF. title s'affiche en premier, subtitle en second. N'envoyez pas sections.*.type : le serveur le déduit automatiquement — les éléments avec des dates ou un lieu deviennent "main"/chronologie, sinon "secondary"/liste. En disposition liste, les subtitles peuvent ne pas s'afficher : placez cette information dans les description_bullets.

{
  "template": "original",
  "language": "en",
  "theme_color": "NavyBlue",
  "font_size": "11pt",
  "font_family": "arial",
  "identity": {
    "first_name": "Leif",
    "last_name": "Doxarve",
    "jobtitle": "AI Product Engineer",
    "email": "leif@example.com",
    "mobile": "+41 79 123 45 67",
    "address": "Lausanne, Switzerland",
    "linkedin": "https://linkedin.com/in/leif-doxarve",
    "github": "https://github.com/mieleif",
    "website": "https://doxai.ch"
  },
  "sections_order": ["summary", "experience", "education", "projects", "skills", "languages"],
  "sections": {
    "summary": {
      "content": "AI product engineer focused on practical automation, LLM integrations, and scalable orchestration."
    },
    "experience": {
      "items": [
        {
          "title": "DoxAI",
          "subtitle": "Founder & Product Engineer",
          "location": "Lausanne, CH",
          "start": "2024-06",
          "end": "Present",
          "description_bullets": [
            "Built AI-assisted CV platform with public API and MCP-compatible tools.",
            "Implemented billing-aware gateway architecture with provider abstraction and failover.",
            "Operated Docker-based deployments with Traefik, GitHub Actions, and Supabase."
          ]
        },
        {
          "title": "Consulting Projects",
          "subtitle": "Software Engineer",
          "location": "Remote",
          "start": "2022-01",
          "end": "2024-05",
          "description_bullets": [
            "Delivered full-stack web apps with TypeScript, React, and Node.js.",
            "Integrated third-party APIs and automated reporting pipelines."
          ]
        }
      ]
    },
    "education": {
      "items": [
        {
          "title": "University Example",
          "subtitle": "BSc in Computer Science",
          "location": "Switzerland",
          "start": "2018-09",
          "end": "2021-07",
          "description_bullets": [
            "Focus: software engineering, data systems, and applied machine learning."
          ]
        }
      ]
    },
    "projects": {
      "items": [
        {
          "title": "CV API Gateway",
          "subtitle": "Public Tools-Only Runtime",
          "start": "2026-02",
          "end": "Present",
          "description_bullets": [
            "Exposed authenticated resume tooling for agent/CLI consumption.",
            "Added compile-action credit billing and idempotent request handling."
          ]
        }
      ]
    },
    "skills": {
      "items": [
        {
          "title": "Tech Stack",
          "description_bullets": [
            "TypeScript",
            "Node.js",
            "Next.js",
            "Fastify",
            "Supabase",
            "Docker",
            "Traefik",
            "GitHub Actions",
            "PostgreSQL"
          ]
        }
      ]
    },
    "languages": {
      "items": [
        {
          "title": "Languages",
          "description_bullets": [
            "French (native)",
            "English (professional)"
          ]
        }
      ]
    }
  }
}