Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

IONOS CLOUD MCP Server

OCI · GHCR.IO/IONOS-CLOUD/IONOSCLOUD-MCP:1.0.1 · SCANNED AUG 3

Inspect IONOS CLOUD infrastructure via MCP

−3 this week 44 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security0
  • Malware scan not yet available for this package.Unverified
  • CVE data not yet available for this package.Unverified
  • Install-script risk not yet assessed.Unverified
  • Dependency-health data not yet available.Unverified
Provenance & Transparency45
Schema Quality & AI Usability85
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (excellent).Pass
  • Tool/resource definitions use about 8375 tokens (~70/item across 119 items; 118 tools + 1 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management23
  • Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

oci · ghcr.io/ionos-cloud/ionoscloud-mcp:1.0.1

# add to Claude Code
claude mcp add ionos-cloud-ionoscloud-mcp -- docker run --rm -i ghcr.io/ionos-cloud/ionoscloud-mcp:1.0.1
# add to Codex CLI
codex mcp add ionos-cloud-ionoscloud-mcp -- docker run --rm -i ghcr.io/ionos-cloud/ionoscloud-mcp:1.0.1
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ionos-cloud-ionoscloud-mcp": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "--rm",
        "-i",
        "ghcr.io/ionos-cloud/ionoscloud-mcp:1.0.1"
      ],
      "enabled": true
    }
  }
}
# ~/.hermes/config.yaml
mcp_servers:
  ionos-cloud-ionoscloud-mcp:
    command: "docker"
    args: ["run", "--rm", "-i", "ghcr.io/ionos-cloud/ionoscloud-mcp:1.0.1"]
// mcp.json
{
  "mcpServers": {
    "ionos-cloud-ionoscloud-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/ionos-cloud/ionoscloud-mcp:1.0.1"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 2 Aug 26 +3
    • Stability: unverified → 0.20 functional
  • 31 Jul 26 −6
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 27 Jul 26 +36
    • Tool coverage: unverified → 100 functional
    • Schema quality: unverified → 100 functional
    • First check of Schema quality: fail functional
    • First check of Schema quality: excellent functional
    • First check of Tool coverage: 100 functional
    • First check of Schema quality: pass functional
  • 26 Jul 26 11

    First indexed and scored.

    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed oci/ghcr.io/ionos-cloud/ionoscloud-mcp:1.0.1

Provenance none

Ecosystem: oci · Outcome: none

Reason: no_attestation

MCP tools — 118 exposed · ~8,334 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
get_server ~68

Get details of a specific server

NameTypeReqDescription
datacenter_idstringyesthe ID of the data center
depthnull|integernesting depth of returned objects (0-5, default 1 for list operations)
server_idstringyesthe ID of the server

No output schema declared.

No examples provided.

get_server_gpu ~79

Get details of a specific GPU attached to a server

NameTypeReqDescription
datacenter_idstringyesthe ID of the data center
depthnull|integernesting depth of returned objects (0-5)
gpu_idstringyesthe ID of the GPU
server_idstringyesthe ID of the server

No output schema declared.

No examples provided.

get_server_remote_console ~73

Get the remote console URL for a specific server

NameTypeReqDescription
datacenter_idstringyesthe ID of the data center
depthnull|integernesting depth of returned objects (0-5, default 1 for list operations)
server_idstringyesthe ID of the server

No output schema declared.

No examples provided.

get_snapshot ~46

Get details of a specific snapshot

NameTypeReqDescription
depthnull|integernesting depth of returned objects (0-5)
snapshot_idstringyesthe ID of the snapshot

No output schema declared.

No examples provided.

get_target_group ~50

Get details of a specific target group

NameTypeReqDescription
depthnull|integernesting depth of returned objects (0-5)
target_group_idstringyesthe ID of the target group

No output schema declared.

No examples provided.

get_template ~47

Get details of a specific server template

NameTypeReqDescription
depthnull|integernesting depth of returned objects (0-5)
template_idstringyesthe ID of the template

No output schema declared.

No examples provided.

get_volume ~61

Get details of a specific volume

NameTypeReqDescription
datacenter_idstringyesthe ID of the data center
depthnull|integernesting depth of returned objects (0-5)
volume_idstringyesthe ID of the volume

No output schema declared.

No examples provided.

head_object_storage_bucket ~39

Check whether an Object Storage bucket exists and is accessible with the current credentials.

NameTypeReqDescription
bucketstringyesthe name of the object storage bucket

No output schema declared.

No examples provided.

head_object_storage_object ~77

Check whether an object exists in an Object Storage bucket and retrieve its user-defined metadata (x-amz-meta-* headers). Returns an error if the object does not exist or is not accessible.

NameTypeReqDescription
bucketstringyesthe name of the object storage bucket
keystringyesthe object key (path within the bucket)

No output schema declared.

No examples provided.

list_activitylog_contracts ~68

List contracts accessible for IONOS CLOUD activity log queries. Primarily useful for reseller and partner users with multiple contracts. Single-contract users can skip this — their contract number is embedded in the JWT token returned by get_billing_profile or visible in the IONOS DCD console.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_activitylog_events ~379

Query the IONOS CLOUD activity log: full audit trail of API requests made against a contract (who did what, when, on which resource). Requires ACCESS_ACTIVITY_LOG privilege on the token. Defaults: last 7 days, limit 25, RequestStatusUpdate events excluded. Use user filter to narrow to a specific account. Use event_types to restrict to e.g. ['Error','RequestAccepted']. Maximum date range is 90 days — paginate or narrow the window for longer spans. Use list_activitylog_contracts first to look up the contract number if needed.

NameTypeReqDescription
contractintegeryesthe contract number whose activity log to query; reseller/partner users get IDs from list_activitylog_contracts, single-contract users read it from their JWT
date_endnull|stringinclusive end date YYYY-MM-DD; defaults to today when omitted; maximum range is 90 days
date_startnull|stringinclusive start date YYYY-MM-DD; defaults to 7 days ago when omitted
event_typesnull|arrayfilter to these event types only (client-side); e.g. ['Error','RequestAccepted'] — omit Provision and RequestStatusUpdate to cut ~65% of typical log volume
include_status_updatesnull|booleaninclude RequestStatusUpdate events (default false); these are async provisioning echoes that account for ~55% of log volume and are rarely useful
limitnull|integermax events to return; defaults to 25; increase only when the user explicitly asks for bulk data
offsetnull|integer0-based pagination offset
usernull|stringfilter by username (client-side); e.g. '[email protected]' — drastically reduces output when investigating a specific user

No output schema declared.

No examples provided.

list_alb_forwarding_rules ~82

List all forwarding rules of an application load balancer

NameTypeReqDescription
application_loadbalancer_idstringyesthe ID of the application load balancer
datacenter_idstringyesthe ID of the data center
depthnull|integernesting depth of returned objects (0-5, default 1 for list operations)

No output schema declared.

No examples provided.

list_application_loadbalancers ~66

List all application load balancers (ALB) in a data center

NameTypeReqDescription
datacenter_idstringyesthe ID of the data center
depthnull|integernesting depth of returned objects (0-5, default 1 for list operations)

No output schema declared.

No examples provided.

list_billing_evn ~76

Get provisioning itemized data (EVN) for your contract for the current billing month. Shows per-resource usage intervals grouped by datacenter. For FOCUS v1.3 compliant output, read resource ionos://billing/focus-v1.3.

NameTypeReqDescription
contractintegeryescontract number from get_billing_profile

No output schema declared.

No examples provided.

list_billing_evn_by_period ~139

Get provisioning itemized data (EVN) for a specific billing period (YYYY-MM). One month per call. If the user requests a range longer than one month, calculate the number of monthly calls required, inform the user, and ask for permission before proceeding. For FOCUS v1.3 compliant output, read resource ionos://billing/focus-v1.3.

NameTypeReqDescription
contractintegeryescontract number from get_billing_profile
periodstringyesbilling period in YYYY-MM format (e.g. 2026-04). Maximum one month per request — for wider ranges call once per month

No output schema declared.

No examples provided.

list_billing_invoices ~68

List all invoices for your IONOS CLOUD contract. Returns invoice IDs, dates, and amounts. For FOCUS v1.3 compliant output, read resource ionos://billing/focus-v1.3.

NameTypeReqDescription
contractintegeryescontract number from get_billing_profile

No output schema declared.

No examples provided.

list_billing_invoices_by_period ~104

List invoices for a specific billing period (YYYY-MM). One month per call. If the user requests a range longer than one month, calculate the number of monthly calls required, inform the user, and ask for permission before proceeding. For FOCUS v1.3 compliant output, read resource ionos://billing/focus-v1.3.

NameTypeReqDescription
periodstringyesbilling period in YYYY-MM format (e.g. 2026-04)

No output schema declared.

No examples provided.

list_billing_products ~211

Search the IONOS CLOUD product/pricing catalog by keyword. The filter is applied client-side as a case-insensitive partial match on each product's description — it is not an API-level parameter. Returns non-deprecated products whose description contains the filter string. IMPORTANT: Only call this tool when the user has explicitly specified a product or category they want to see pricing for. If the user asks a broad question like 'what are the prices' or 'show me all products', do NOT guess keywords or call this tool multiple times — instead ask the user which specific product or category they are interested in. Examples of valid filters: 'RAM', 'core', 'storage', 'Kubernetes', 'Postgres', 'network', 'Windows'.

NameTypeReqDescription
contractintegeryescontract number from get_billing_profile
filterstringyeskeyword to filter products by description (e.g. 'RAM', 'Kubernetes', 'Postgres', 'storage'). Use broad terms to find relevant pricing

No output schema declared.

No examples provided.

list_billing_traffic ~77

Get network traffic data for your contract for the current billing month. Returns per-datacenter and per-NIC inbound/outbound traffic in bytes. For FOCUS v1.3 compliant output, read resource ionos://billing/focus-v1.3.

NameTypeReqDescription
contractintegeryescontract number from get_billing_profile

No output schema declared.

No examples provided.

list_billing_traffic_by_period ~134

Get network traffic data for a specific billing period (YYYY-MM). One month per call. If the user requests a range longer than one month, calculate the number of monthly calls required, inform the user, and ask for permission before proceeding. For FOCUS v1.3 compliant output, read resource ionos://billing/focus-v1.3.

NameTypeReqDescription
contractintegeryescontract number from get_billing_profile
periodstringyesbilling period in YYYY-MM format (e.g. 2026-04). Maximum one month per request — for wider ranges call once per month

No output schema declared.

No examples provided.

list_billing_usage ~157

Get aggregated resource usage for your contract for the current billing period. Shows metered quantities (CPU hours, GB-hours, etc.) grouped by datacenter. Defaults exclude zero-quantity meters (set include_zero=true to keep them). Filter by datacenter_id to narrow scope. For FOCUS v1.3 compliant output, read resource ionos://billing/focus-v1.3.

NameTypeReqDescription
contractintegeryescontract number from get_billing_profile
datacenter_idnull|stringscope to a single datacenter (VDC UUID)
include_zeronull|booleaninclude meters with quantity 0 (default false); set true to find datacenters with metered SKUs that didn't consume

No output schema declared.

No examples provided.

list_billing_utilization ~427

Get per-resource utilization for the current billing period, grouped by datacenter. Defaults exclude zero-quantity meters (set include_zero=true to find idle resources). Use group_by='meter' or 'datacenter' to aggregate further, or top_n=N for a flat global ranking of the largest meters. Filter by datacenter_id, meter_types, or regions to narrow scope. For contracts with many datacenters, scope with regions, datacenter_id, or meter_types — or set top_n=10 for a flat global top-N list — before group_by=datacenter to keep the response under 25 KB. For FOCUS v1.3 compliant output, read resource ionos://billing/focus-v1.3.

NameTypeReqDescription
contractintegeryescontract number from get_billing_profile
datacenter_idnull|stringscope to a single datacenter (VDC UUID)
group_bynull|stringaggregation level: omitted or '' = per-resource (default), 'meter' = sum per SKU per datacenter, 'datacenter' = sum per type per datacenter — coarser groupings shrink output but lose detail
include_zeronull|booleaninclude meters with quantity 0 (default false); set true to find existing resources that didn't consume in the window
meter_typesnull|arrayfilter to these meter type categories only (client-side); e.g. ['DBAAS','DNS','SERVER']
regionsnull|arrayfilter to these regions only (client-side); e.g. ['de/fra','es/vit']
top_nnull|integerreturn only the N largest meters globally, sorted by quantity desc — flat list with dc_id/dc_name on each row, datacenters[] omitted; ideal for cost audits on contracts with many datacenters. When co…

No output schema declared.

No examples provided.

list_billing_utilization_by_period ~401

Get per-resource utilization for a specific billing period (YYYY-MM). One month per call. If the user requests a range longer than one month, calculate the number of monthly calls required, inform the user, and ask for permission before proceeding. Same compaction flags as list_billing_utilization (include_zero, group_by, datacenter_id, meter_types, regions, top_n). For contracts with many datacenters, scope with regions, datacenter_id, or meter_types — or set top_n=10 for a flat global top-N list — before group_by=datacenter to keep the response under 25 KB. For FOCUS v1.3 compliant output, read resource ionos://billing/focus-v1.3.

NameTypeReqDescription
contractintegeryescontract number from get_billing_profile
datacenter_idnull|stringscope to a single datacenter (VDC UUID)
group_bynull|stringaggregation level: omitted or '' = per-resource (default), 'meter' = sum per SKU per datacenter, 'datacenter' = sum per type per datacenter
include_zeronull|booleaninclude meters with quantity 0 (default false)
meter_typesnull|arrayfilter to these meter type categories only (client-side); e.g. ['DBAAS','DNS','SERVER']
periodstringyesbilling period in YYYY-MM format (e.g. 2026-04). Maximum one month per request — for wider ranges call once per month
regionsnull|arrayfilter to these regions only (client-side); e.g. ['de/fra']
top_nnull|integerreturn only the N largest meters globally, sorted by quantity desc (flat list, datacenters[] omitted). When combined with group_by='datacenter', top_meters[] rows have no meter_id

No output schema declared.

No examples provided.

list_cert_auto_certificates ~26

List all auto-certificates in your IONOS Cloud Certificate Manager account

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_cert_certificates ~39

List all SSL/TLS certificates in your IONOS Cloud Certificate Manager account. Returns certificate metadata and public key material but not the private key.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_cert_providers ~35

List all certificate providers in your IONOS Cloud Certificate Manager account. Returns provider configuration but not the external account binding secret.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_datacenters ~59

List all virtual data centers. Returns names and basic properties by default (depth=1).

NameTypeReqDescription
depthnull|integernesting depth of returned objects (0-5, default 1); depth 1 includes names and basic properties

No output schema declared.

No examples provided.

list_dns_records ~17

List all DNS records across all zones

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_dns_reverse_records ~23

List all reverse DNS records in your IONOS CLOUD account

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_dns_secondary_zone_records ~37

List all DNS records in a specific secondary zone

NameTypeReqDescription
secondary_zone_idstringyesthe ID of the secondary DNS zone

No output schema declared.

No examples provided.

list_dns_secondary_zones ~24

List all secondary DNS zones in your IONOS CLOUD account

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_dns_zone_dnssec_keys ~36

List DNSSEC keys for a specific DNS zone

NameTypeReqDescription
zone_idstringyesthe ID of the DNS zone

No output schema declared.

No examples provided.

list_dns_zone_records ~33

List all DNS records in a specific zone

NameTypeReqDescription
zone_idstringyesthe ID of the DNS zone

No output schema declared.

No examples provided.

list_dns_zones ~22

List all DNS zones in your IONOS CLOUD account

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_firewall_rules ~86

List all firewall rules on a network interface

NameTypeReqDescription
datacenter_idstringyesthe ID of the data center
depthnull|integernesting depth of returned objects (0-5, default 1 for list operations)
nic_idstringyesthe ID of the network interface
server_idstringyesthe ID of the server

No output schema declared.

No examples provided.

list_images ~44

List all available images (OS templates) in IONOS CLOUD

NameTypeReqDescription
depthnull|integernesting depth of returned objects (0-5, default 1)

No output schema declared.

No examples provided.

list_ip_blocks ~44

List all reserved IP blocks in your IONOS CLOUD account

NameTypeReqDescription
depthnull|integernesting depth of returned objects (0-5, default 1)

No output schema declared.

No examples provided.

list_k8s_clusters ~45

List all Kubernetes clusters in your IONOS CLOUD account

NameTypeReqDescription
depthnull|integernesting depth of returned objects (0-5, default 1)

No output schema declared.

No examples provided.

list_k8s_nodepool_nodes ~80

List all nodes in a Kubernetes node pool

NameTypeReqDescription
depthnull|integernesting depth of returned objects (0-5, default 1 for list operations)
k8s_cluster_idstringyesthe ID of the Kubernetes cluster
nodepool_idstringyesthe ID of the Kubernetes node pool

No output schema declared.

No examples provided.

list_k8s_nodepools ~64

List all node pools in a Kubernetes cluster

NameTypeReqDescription
depthnull|integernesting depth of returned objects (0-5, default 1 for list operations)
k8s_cluster_idstringyesthe ID of the Kubernetes cluster

No output schema declared.

No examples provided.

list_k8s_versions ~22

List all available Kubernetes versions in IONOS CLOUD

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_lan_nics ~74

List all NICs attached to a specific LAN

NameTypeReqDescription
datacenter_idstringyesthe ID of the data center
depthnull|integernesting depth of returned objects (0-5, default 1 for list operations)
lan_idstringyesthe ID of the LAN

No output schema declared.

No examples provided.

list_lans ~58

List all LANs in a data center

NameTypeReqDescription
datacenter_idstringyesthe ID of the data center
depthnull|integernesting depth of returned objects (0-5, default 1 for list operations)

No output schema declared.

No examples provided.

list_loadbalancer_nics ~81

List all NICs balanced by a specific load balancer

NameTypeReqDescription
datacenter_idstringyesthe ID of the data center
depthnull|integernesting depth of returned objects (0-5, default 1 for list operations)
loadbalancer_idstringyesthe ID of the load balancer

No output schema declared.

No examples provided.

list_loadbalancers ~60

List all load balancers in a data center

NameTypeReqDescription
datacenter_idstringyesthe ID of the data center
depthnull|integernesting depth of returned objects (0-5, default 1 for list operations)

No output schema declared.

No examples provided.

list_locations ~43

List all available locations (regions) in IONOS CLOUD

NameTypeReqDescription
depthnull|integernesting depth of returned objects (0-5, default 1)

No output schema declared.

No examples provided.

list_nat_gateway_rules ~74

List all rules of a specific NAT gateway

NameTypeReqDescription
datacenter_idstringyesthe ID of the data center
depthnull|integernesting depth of returned objects (0-5, default 1 for list operations)
nat_gateway_idstringyesthe ID of the NAT gateway

No output schema declared.

No examples provided.

list_nat_gateways ~59

List all NAT gateways in a data center

NameTypeReqDescription
datacenter_idstringyesthe ID of the data center
depthnull|integernesting depth of returned objects (0-5, default 1 for list operations)

No output schema declared.

No examples provided.

list_network_loadbalancers ~66

List all network load balancers (NLB) in a data center

NameTypeReqDescription
datacenter_idstringyesthe ID of the data center
depthnull|integernesting depth of returned objects (0-5, default 1 for list operations)

No output schema declared.

No examples provided.

list_nics ~75

List all network interfaces (NICs) attached to a server

NameTypeReqDescription
datacenter_idstringyesthe ID of the data center
depthnull|integernesting depth of returned objects (0-5, default 1 for list operations)
server_idstringyesthe ID of the server

No output schema declared.

No examples provided.