Un sito. Tutte le interfacce.

Agent Card

Identità, capacità e skill.

MCP manifest

Endpoint, versioni e autenticazione.

Server Card

Strumenti, trasporto, limiti e fallback.

OpenAPI

Contratti REST degli stessi strumenti MCP.

API Catalog

Mappa macchina di tutte le interfacce.

Verifica pubblica

Handshake, schemi, parità e consulente AI.

Chiedi all’agente del sito

Ask the BlackOrder site agent about its services, apps or articles. It uses DeepSeek to inspect the official catalog and returns recommendations, official images, requirements and source URLs. Read-only; AI commentary is explicitly inferred. Never send secrets, personal details or payment data.

consult_resource

POST /api/agent/tools/consult_resource
Content-Type: application/json

{
    "query": "Realizzate software su richiesta?",
    "language": "it"
}

Search the official site

Search services, Studio, contacts, public pages, applications and articles. For custom development or company questions search here, not only search_apps. Missing results do not prove a service is absent.

search_site

POST /api/agent/tools/search_site
Content-Type: application/json

{
    "query": "sviluppo",
    "language": "it"
}

Read an official public page

Read the current published text of a page by its slug from search_site. Includes content date, hash, headings and truncation flag. No arbitrary URL fetching.

read_site_page

POST /api/agent/tools/read_site_page
Content-Type: application/json

{
    "slug": "studio",
    "language": "it"
}

Search BlackOrder apps

Ranked search over BlackOrder applications. Returns compact records with canonical_url and official_page_url (the page where a person downloads; files are never returned).

search_apps

POST /api/agent/tools/search_apps
Content-Type: application/json

{
    "query": "audio",
    "free": true,
    "language": "it"
}

List BlackOrder apps

All BlackOrder applications, optionally filtered by category, platform, price and language of the answer.

list_apps

POST /api/agent/tools/list_apps
Content-Type: application/json

{
    "language": "it"
}

Get app details

Full record of one app: description, version, requirements, capabilities, privacy facts, screenshots, official page. Identify it by app_id or slug (e.g. "peaklab", "charlie", "onrecord").

get_app_details

POST /api/agent/tools/get_app_details
Content-Type: application/json

{
    "app_id": "peaklab",
    "language": "it"
}

Get latest version

Current version, build, release date, minimum macOS and release notes of an app distributed through BlackOrder's signed update channel, plus the official download page.

get_latest_version

POST /api/agent/tools/get_latest_version
Content-Type: application/json

{
    "app_id": "peaklab",
    "language": "it"
}

Check compatibility

Whether an app runs on a given macOS version and CPU architecture.

check_compatibility

POST /api/agent/tools/check_compatibility
Content-Type: application/json

{
    "app_id": "peaklab",
    "os": "14.5",
    "architecture": "arm64",
    "language": "it"
}

Search The Dark Codex articles

Ranked search over BlackOrder's blog articles (English and Italian). Each result carries the canonical article URL in the requested language.

search_articles

POST /api/agent/tools/search_articles
Content-Type: application/json

{
    "query": "privacy",
    "language": "it"
}

Get article

One article by article_id (numeric) or slug, with summary, excerpt, tags, dates, related apps and canonical URLs in English and Italian.

get_article

POST /api/agent/tools/get_article
Content-Type: application/json

{
    "slug": "agentorder",
    "language": "it"
}

Get official page

The official BlackOrder page (or App Store page) for an app or article, in the requested language. This is where a person reads more and, for apps, decides whether to download. The API never serves files.

get_official_page

POST /api/agent/tools/get_official_page
Content-Type: application/json

{
    "content_id": "peaklab",
    "language": "it"
}