{"openapi":"3.1.0","info":{"title":"CONTENTUM agent API","version":"1.0.0","description":"CONTENTUM is the worldwide project market for cybersecurity and IT infrastructure. It lists open projects detected from public job postings and public tenders with open deadlines (anonymised), the service areas with their demand, provider coverage as counts, a CVE database with the actively exploited vulnerabilities, buyer guides, and a passive security check for a domain. Use search_projects / get_project for demand, list_services / get_country / get_provider_coverage for the market, search_vulnerabilities / get_vulnerability for CVEs, list_guides / get_guide for background, run_domain_check for a passive check of a domain you are authorised to check, submit_project_request when a company needs providers and register_provider_interest when a provider wants to be listed or answer a project (no account; reply by e-mail; follow up with get_request_status). The three tools that send data (run_domain_check, submit_project_request, register_provider_interest) need an API key, sent as the X-API-Key header; all other tools need no key. Same tools as the MCP server at https://contentum.com/mcp and the A2A agent at https://contentum.com/a2a.","contact":{"email":"business@contentum.com","url":"https://contentum.com/agents/"}},"servers":[{"url":"https://contentum.com/agents/api"}],"paths":{"/tools":{"get":{"operationId":"listTools","summary":"All tools with JSON input schemas","responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/call":{"post":{"operationId":"callTool","summary":"Call any tool by name (write tools need the X-API-Key header)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","enum":["search_projects","get_project","list_services","get_service","list_countries","get_country","get_provider_coverage","get_market_stats","search_vulnerabilities","get_vulnerability","list_guides","get_guide","run_domain_check","check_nis2_scope","get_platform_info","submit_project_request","register_provider_interest","get_request_status"]},"arguments":{"type":"object"}},"required":["tool"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/projects":{"get":{"operationId":"searchProjects","summary":"Search open projects — Open cybersecurity and IT infrastructure projects and public tenders by service, country and words.","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string","maxLength":160,"description":"Words matched against title, services, country, region, regulations and technologies"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["company_project","public_tender"]}},{"name":"service","in":"query","required":false,"schema":{"type":"string","enum":["managed-soc","cloud-security","it-security","first-response","incident-response","ransomware-resilience","managed-ndr","managed-edr","vulnerability-management","digitale-infrastruktur","infrastruktur-konsolidierung","netzwerk-sdwan"],"description":"Service area id, see list_services"}},{"name":"country","in":"query","required":false,"schema":{"type":"string","description":"ISO 3166 alpha-2 code (DE, FR, US …) or English country name"}},{"name":"regulation","in":"query","required":false,"schema":{"type":"string","maxLength":40}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":10}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/projects/{id}":{"get":{"operationId":"getProject","summary":"Project details — One project or tender by id (CT-0001): services, country, signal, regulations, technologies, deadline.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/services":{"get":{"operationId":"listServices","summary":"Service areas — The 12 service areas with their open project counts.","parameters":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/services/{id}":{"get":{"operationId":"getService","summary":"Service area details — One service area: description, typical tasks, demand signal, open projects, provider count.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/countries":{"get":{"operationId":"listCountries","summary":"Countries with open projects — Countries with counts of company projects, tenders and listed providers.","parameters":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/countries/{country}":{"get":{"operationId":"getCountry","summary":"Country overview — One country: open projects by service, tenders, providers by service, latest projects.","parameters":[{"name":"country","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/providers/coverage":{"get":{"operationId":"getProviderCoverage","summary":"Provider coverage — How many listed providers offer a service in a country (counts only).","parameters":[{"name":"service","in":"query","required":false,"schema":{"type":"string","enum":["managed-soc","cloud-security","it-security","first-response","incident-response","ransomware-resilience","managed-ndr","managed-edr","vulnerability-management","digitale-infrastruktur","infrastruktur-konsolidierung","netzwerk-sdwan"],"description":"Service area id, see list_services"}},{"name":"country","in":"query","required":false,"schema":{"type":"string","description":"ISO 3166 alpha-2 code (DE, FR, US …) or English country name"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/stats":{"get":{"operationId":"getMarketStats","summary":"Market figures — Totals: open projects, tenders, countries, demand per service and regulation, data date.","parameters":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/vulnerabilities":{"get":{"operationId":"searchVulnerabilities","summary":"Search vulnerabilities — CVE records by vendor or year, or the actively exploited ones (CISA KEV).","parameters":[{"name":"vendor","in":"query","required":false,"schema":{"type":"string","maxLength":60,"description":"Vendor key in lower case, for example microsoft"}},{"name":"year","in":"query","required":false,"schema":{"type":"integer","minimum":1999,"maximum":2100}},{"name":"exploited_only","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":10}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/vulnerabilities/{id}":{"get":{"operationId":"getVulnerability","summary":"Vulnerability details — One CVE: description, CVSS, weaknesses, references and whether it is actively exploited.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/guides":{"get":{"operationId":"listGuides","summary":"Security guides — Buyer guides (NIS2, penetration testing, ISO 27001, OWASP …) in a given language.","parameters":[{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"Language code, default en"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/guides/{id}":{"get":{"operationId":"getGuide","summary":"Read a guide — Full text of one guide with sections, questions and sources.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","description":"Language code, default en"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/nis2-scope":{"get":{"operationId":"checkNis2Scope","summary":"NIS2 scope check — Whether an organisation is probably covered by NIS2, from sector and size.","parameters":[{"name":"sector","in":"query","required":true,"schema":{"type":"string","enum":["energy","transport","banking","fmi","health","water","wastewater","digital","ict","publicadmin","space","postal","waste","chemicals","food","manufacturing","providers","research","other"]}},{"name":"size","in":"query","required":true,"schema":{"type":"string","enum":["small","medium","large"],"description":"EU size classes: small = fewer than 50 staff and up to EUR 10 million turnover, large = 250 staff or more, or above the medium-size financial ceilings"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/info":{"get":{"operationId":"getPlatformInfo","summary":"How CONTENTUM works — What CONTENTUM does, what a request needs, contacts, languages and the agent endpoints.","parameters":[],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/requests/{request_id}":{"get":{"operationId":"getRequestStatus","summary":"Request status — Status of a request (id + e-mail).","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"email","in":"query","required":true,"schema":{"type":"string","format":"email"}}],"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/domain-checks":{"post":{"operationId":"runDomainCheck","summary":"Check a domain — Passive security check of a domain: TLS, security headers, SPF, DMARC, security.txt. Returns score and report link.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/run_domain_check_input"}}}},"security":[{"apiKey":[]}],"responses":{"201":{"description":"Done"},"400":{"description":"Invalid input"},"401":{"description":"API key missing or wrong"},"429":{"description":"Rate limit"}}}},"/project-requests":{"post":{"operationId":"submitProjectRequest","summary":"Ask for providers — A company describes the work it needs. Returns a request id; the team replies by e-mail.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/submit_project_request_input"}}}},"security":[{"apiKey":[]}],"responses":{"201":{"description":"Done"},"400":{"description":"Invalid input"},"401":{"description":"API key missing or wrong"},"429":{"description":"Rate limit"}}}},"/provider-interests":{"post":{"operationId":"registerProviderInterest","summary":"Register as a provider — A service provider asks to be listed or registers interest in a project. Returns an id.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/register_provider_interest_input"}}}},"security":[{"apiKey":[]}],"responses":{"201":{"description":"Done"},"400":{"description":"Invalid input"},"401":{"description":"API key missing or wrong"},"429":{"description":"Rate limit"}}}}},"components":{"schemas":{"search_projects_input":{"type":"object","properties":{"query":{"type":"string","maxLength":160,"description":"Words matched against title, services, country, region, regulations and technologies"},"type":{"type":"string","enum":["company_project","public_tender"]},"service":{"type":"string","enum":["managed-soc","cloud-security","it-security","first-response","incident-response","ransomware-resilience","managed-ndr","managed-edr","vulnerability-management","digitale-infrastruktur","infrastruktur-konsolidierung","netzwerk-sdwan"],"description":"Service area id, see list_services"},"country":{"type":"string","description":"ISO 3166 alpha-2 code (DE, FR, US …) or English country name"},"regulation":{"type":"string","maxLength":40},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10},"offset":{"type":"integer","minimum":0,"default":0}},"additionalProperties":false},"get_project_input":{"type":"object","properties":{"id":{"type":"string","description":"CT-0042"}},"required":["id"],"additionalProperties":false},"list_services_input":{"type":"object","properties":{},"additionalProperties":false},"get_service_input":{"type":"object","properties":{"id":{"type":"string","enum":["managed-soc","cloud-security","it-security","first-response","incident-response","ransomware-resilience","managed-ndr","managed-edr","vulnerability-management","digitale-infrastruktur","infrastruktur-konsolidierung","netzwerk-sdwan"],"description":"Service area id, see list_services"}},"required":["id"],"additionalProperties":false},"list_countries_input":{"type":"object","properties":{},"additionalProperties":false},"get_country_input":{"type":"object","properties":{"country":{"type":"string","description":"ISO 3166 alpha-2 code (DE, FR, US …) or English country name"}},"required":["country"],"additionalProperties":false},"get_provider_coverage_input":{"type":"object","properties":{"service":{"type":"string","enum":["managed-soc","cloud-security","it-security","first-response","incident-response","ransomware-resilience","managed-ndr","managed-edr","vulnerability-management","digitale-infrastruktur","infrastruktur-konsolidierung","netzwerk-sdwan"],"description":"Service area id, see list_services"},"country":{"type":"string","description":"ISO 3166 alpha-2 code (DE, FR, US …) or English country name"}},"additionalProperties":false},"get_market_stats_input":{"type":"object","properties":{},"additionalProperties":false},"search_vulnerabilities_input":{"type":"object","properties":{"vendor":{"type":"string","maxLength":60,"description":"Vendor key in lower case, for example microsoft"},"year":{"type":"integer","minimum":1999,"maximum":2100},"exploited_only":{"type":"boolean"},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10},"offset":{"type":"integer","minimum":0,"default":0}},"additionalProperties":false},"get_vulnerability_input":{"type":"object","properties":{"id":{"type":"string","description":"CVE-2024-3094"}},"required":["id"],"additionalProperties":false},"list_guides_input":{"type":"object","properties":{"lang":{"type":"string","description":"Language code, default en"}},"additionalProperties":false},"get_guide_input":{"type":"object","properties":{"id":{"type":"string"},"lang":{"type":"string","description":"Language code, default en"}},"required":["id"],"additionalProperties":false},"run_domain_check_input":{"type":"object","properties":{"domain":{"type":"string","maxLength":253,"description":"Public domain, for example example.com"},"authorized":{"type":"boolean","description":"Must be true: you confirm that you are authorised to check this domain."}},"required":["domain","authorized"],"additionalProperties":false},"check_nis2_scope_input":{"type":"object","properties":{"sector":{"type":"string","enum":["energy","transport","banking","fmi","health","water","wastewater","digital","ict","publicadmin","space","postal","waste","chemicals","food","manufacturing","providers","research","other"]},"size":{"type":"string","enum":["small","medium","large"],"description":"EU size classes: small = fewer than 50 staff and up to EUR 10 million turnover, large = 250 staff or more, or above the medium-size financial ceilings"}},"required":["sector","size"],"additionalProperties":false},"get_platform_info_input":{"type":"object","properties":{},"additionalProperties":false},"submit_project_request_input":{"type":"object","properties":{"company":{"type":"string","maxLength":160},"email":{"type":"string","format":"email"},"contact_name":{"type":"string","maxLength":120},"description":{"type":"string","maxLength":3000,"description":"The work needed: systems, size, timing, constraints"},"services":{"type":"array","items":{"type":"string","enum":["managed-soc","cloud-security","it-security","first-response","incident-response","ransomware-resilience","managed-ndr","managed-edr","vulnerability-management","digitale-infrastruktur","infrastruktur-konsolidierung","netzwerk-sdwan"],"description":"Service area id, see list_services"},"maxItems":12},"country":{"type":"string","description":"ISO 3166 alpha-2 code (DE, FR, US …) or English country name"},"website":{"type":"string","maxLength":200},"phone":{"type":"string","maxLength":60},"agent":{"type":"object","description":"Optional: who is calling, for our records.","properties":{"name":{"type":"string"},"url":{"type":"string"},"on_behalf_of":{"type":"string"}}}},"required":["company","email","description"],"additionalProperties":false},"register_provider_interest_input":{"type":"object","properties":{"company":{"type":"string","maxLength":160},"email":{"type":"string","format":"email"},"contact_name":{"type":"string","maxLength":120},"services":{"type":"array","items":{"type":"string","enum":["managed-soc","cloud-security","it-security","first-response","incident-response","ransomware-resilience","managed-ndr","managed-edr","vulnerability-management","digitale-infrastruktur","infrastruktur-konsolidierung","netzwerk-sdwan"],"description":"Service area id, see list_services"},"minItems":1,"maxItems":12},"project_id":{"type":"string","description":"CT-0042, optional"},"country":{"type":"string","description":"ISO 3166 alpha-2 code (DE, FR, US …) or English country name"},"website":{"type":"string","maxLength":200},"phone":{"type":"string","maxLength":60},"description":{"type":"string","maxLength":3000},"agent":{"type":"object","description":"Optional: who is calling, for our records.","properties":{"name":{"type":"string"},"url":{"type":"string"},"on_behalf_of":{"type":"string"}}}},"required":["company","email","services"],"additionalProperties":false},"get_request_status_input":{"type":"object","properties":{"request_id":{"type":"string"},"email":{"type":"string","format":"email"}},"required":["request_id","email"],"additionalProperties":false}},"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key"}}}}