Crela API enhancements (API Evangelist)

overlay: 1.0.0
info:
  title: Crela API enhancements (API Evangelist)
  version: '2026-11-04'
extends: ../openapi/_ae-authored/crela-io-openapi-generated.yml
x-provenance:
  generated: '2026-11-04'
  method: derived
  source: https://crela.io/llms.txt
actions:
- target: $.info
  update:
    description: 'Crela Agent API: lets creators and CI/CD submit desktop software to the Crela marketplace, upload new builds and read review status. The @crela/mcp server is a thin client over this API. Authenticate with Authorization: Bearer crela_<api-key> (keys created at https://crela.io/dashboard/creator/keys); the requirements endpoint needs no auth.'
    x-mcp-servers:
    - {transport: streamable-http, url: https://crela.io/mcp, auth: none}
    - {transport: stdio, install: npx -y @crela/mcp, auth: api-key}
- target: $.paths['/api/agent/requirements'].get
  update:
    summary: Get submission requirements
    description: Current submission rules, K.O. criteria and thresholds. No authentication required.
    security: []
    x-mcp-tool: get_submission_requirements
- target: $.paths['/api/agent/software'].post
  update:
    summary: Submit a new tool
    description: 'Multipart submission of metadata plus the build ZIP. Required: title, slug, description (min. 20 characters, no URLs), long_description (min. 80 characters), categories, price_eur (0 or >= 0.99), system_requirements, version (Semver) and the build ZIP. framework, entrypoint, install_type, platforms and license are detected from the ZIP.'
    x-mcp-tool: submit_new_software
- target: $.paths['/api/agent/software/$TOOL_ID/build'].post
  update:
    summary: Upload a new version
    description: New versions of an existing tool (version, os, arch, optional channel "demo") go through this endpoint, never through a new submission.
    x-mcp-tool: update_software
- target: $.paths['/api/agent/software/$TOOL_ID/review'].get
  update:
    summary: Get review status
    description: Query the status of the multi-stage review for a tool; poll until the review completes.
    x-mcp-tool: check_review_status
- target: $.paths['/api/agent/software/$TOOL_ID/sdk-marker'].get
  update:
    summary: Get SDK marker
    description: Returns the per-tool Crela Protect SDK marker the review requires in builds.
    x-mcp-tool: get_sdk_marker