Skip to main content
Glama
scaleway-ops-mcp-server

scaleway-ops-mcp-server

by gkrost

scaleway-ops-mcp-server

CI

MCP server for Scaleway IAM (Applications, API keys, Policies, Permission sets) and Object Storage Bucket Policy management.

Why this exists

Provisioning a scoped Scaleway credential for a new service (create an IAM Application, mint its API key, attach an IAM Policy, attach a Bucket Policy on the target bucket) is a recurring task that was previously done by hand through the web console. This server wraps the real Scaleway API so an agent can do it via tool calls instead - see docs/gotchas.md for the non-obvious parts of that API this server exists to paper over.

Related MCP server: skycloak-mcp

Setup

npm install
npm run build

Configuration

Environment variables (see .env.example):

Variable

Required

Purpose

SCW_ACCESS_KEY

yes

Access key of the credential this server authenticates as.

SCW_SECRET_KEY

yes

Secret key. Used as X-Auth-Token for the IAM API and as the SigV4 secret for S3 calls.

SCW_ORGANIZATION_ID

yes

Organization these operations run in (UUID).

SCW_PROJECT_ID

yes

Default Project UUID (used as default_project_id when creating API keys, and wherever a Project id is needed but not explicitly passed).

SCW_DEFAULT_REGION

no (default fr-par)

Region for Bucket Policy calls when a tool call doesn't specify one.

MAX_OUTPUT_CHARS

no (default 25000)

Truncation limit for tool response text; structuredContent is replaced with a { truncated: true, note } marker when the untruncated JSON exceeds the ceiling.

MAX_PUT_OBJECT_BYTES

no (default 5000000)

Decoded-size ceiling for scaleway_s3_put_object - single-part only, multipart is out of scope.

MAX_GET_OBJECT_BYTES

no (default 5000000)

Decoded-size ceiling for scaleway_s3_get_object - larger objects should use scaleway_s3_generate_presigned_url.

The credential this server runs as needs its own IAM Policy granting (at minimum) IAMApplicationManager + IAMPolicyManager (organization scope) and ObjectStorageFullAccess (project scope) - see docs/gotchas.md for why these must be two separate policy rules. Create a dedicated IAM Application for this server (don't reuse a human user's credential or an Application scoped for something else) and grant it only what the table above needs.

Running

Via Claude Code / any MCP client, as a stdio server. Simplest, via npx (no local clone needed) - pin @latest explicitly, don't leave the spec bare: npx caches its first resolution of an unpinned package name and silently keeps reusing that same version on every later run, even after a new one is published, unless you either pin @latest or clear npx's cache yourself (live-verified 2026-08-20 - npx -y scaleway-ops-mcp-server kept serving a stale 0.1.0 from days earlier while npx -y scaleway-ops-mcp-server@latest correctly resolved 0.2.0):

{
  "mcpServers": {
    "scaleway-ops": {
      "command": "npx",
      "args": ["-y", "scaleway-ops-mcp-server@latest"],
      "env": {
        "SCW_ACCESS_KEY": "...",
        "SCW_SECRET_KEY": "...",
        "SCW_ORGANIZATION_ID": "...",
        "SCW_PROJECT_ID": "..."
      }
    }
  }
}

Or from a local clone/build, useful for development or pinning to an unreleased commit:

{
  "mcpServers": {
    "scaleway-ops": {
      "command": "node",
      "args": ["/absolute/path/to/scaleway-ops-mcp-server/dist/index.js"],
      "env": {
        "SCW_ACCESS_KEY": "...",
        "SCW_SECRET_KEY": "...",
        "SCW_ORGANIZATION_ID": "...",
        "SCW_PROJECT_ID": "..."
      }
    }
  }
}

Tools

IAM Applications

  • scaleway_iam_create_application, scaleway_iam_list_applications, scaleway_iam_get_application, scaleway_iam_update_application, scaleway_iam_delete_application

IAM API keys

  • scaleway_iam_create_api_key, scaleway_iam_list_api_keys, scaleway_iam_update_api_key, scaleway_iam_delete_api_key

  • update_api_key covers description/expires_at/default_project_id only - the access_key/secret_key pair never changes, so it never rotates the credential.

IAM Policies

  • scaleway_iam_create_policy, scaleway_iam_list_policies, scaleway_iam_get_policy, scaleway_iam_update_policy, scaleway_iam_delete_policy

  • update_policy covers name/description/tags only. For rules, use the two tools below - get_policy never returns them.

IAM Policy rules (separate endpoint from the Policy object itself - see docs/gotchas.md)

  • scaleway_iam_list_policy_rules, scaleway_iam_set_policy_rules (atomic full-replace PUT, no delete+recreate lockout risk)

IAM Users (human identities, issue #4; invite semantics unverified - see gotchas)

  • scaleway_iam_list_users, scaleway_iam_get_user

  • scaleway_iam_create_user (confirm-guarded; sends a real invitation email - semantics unverified without a disposable mailbox)

  • scaleway_iam_update_user (profile fields), scaleway_iam_delete_user (confirm + owner-refused + guest-scoped API errors surfaced)

  • scaleway_iam_lock_user / scaleway_iam_unlock_user (lock is confirm-guarded - acts on a person)

  • scaleway_iam_update_user_password (admin-set reset, confirm-guarded), scaleway_iam_update_user_username (confirm-guarded)

  • scaleway_iam_delete_user_mfa_otp (confirm-guarded, security-weakening), scaleway_iam_list_user_grace_periods

IAM Groups (issue #5; completes the group_id principal loop policy tools already accept - fully live-verified, zero blast radius)

  • scaleway_iam_list_groups (name is EXACT match, not substring), scaleway_iam_get_group

  • scaleway_iam_create_group (no confirm - reversible, no side effects to anyone), scaleway_iam_update_group (name/description/tags)

  • scaleway_iam_delete_group (confirm-guarded; refuses managed/special/deletable=false groups tool-side)

  • scaleway_iam_add_group_member (one user and/or one application), scaleway_iam_add_group_members (bulk, additive) — both refuse managed/special/editable=false groups

  • scaleway_iam_set_group_members (confirm-guarded; FULL-REPLACE - omitted members are removed), scaleway_iam_remove_group_member (confirm-guarded) — same special/non-editable refusal

IAM SSH Keys (issue #6; projects-scope permission, unlike this server's other IAM tools - see gotchas)

  • scaleway_iam_list_ssh_keys, scaleway_iam_get_ssh_key, scaleway_iam_create_ssh_key (public keys only - rejects anything that looks like a private key), scaleway_iam_update_ssh_key (rename only), scaleway_iam_delete_ssh_key (confirm-guarded)

IAM JWTs (issue #6; browser/console session tokens, not API keys)

  • scaleway_iam_list_jwts, scaleway_iam_get_jwt, scaleway_iam_delete_jwt (confirm-guarded) - list structurally 403s for an Application/API-key credential regardless of permissions (see gotchas); implemented per the corrected /jwts path in case get/delete fare better.

IAM SAML SSO (issue #6; org-wide - see gotchas for a live incident this was found from)

  • scaleway_iam_get_saml_config, scaleway_iam_enable_saml / update_saml / disable_saml (all confirm-guarded, org-wide blast radius), scaleway_iam_list/add/get/delete_saml_certificate (add/get/delete confirm-guarded where destructive; single-certificate path unverified, see gotchas)

IAM SCIM provisioning (issue #6; same org-wide caution as SAML)

  • scaleway_iam_get_scim_config, scaleway_iam_enable_scim / disable_scim (confirm-guarded), scaleway_iam_list/create/delete_scim_token (create/delete confirm-guarded; token secret returned once, like an API key)

IAM Security Settings (issue #6; org-wide auth policy - live-verified both directions)

  • scaleway_iam_get_security_settings, scaleway_iam_update_security_settings (confirm-guarded; only passed fields change)

IAM Permission sets

  • scaleway_iam_list_permission_sets - call this before creating/attaching a policy; see docs/gotchas.md.

Object Storage Buckets (S3-compatible endpoint, separate auth path from the IAM API)

  • scaleway_s3_create_bucket, scaleway_s3_list_buckets, scaleway_s3_delete_bucket - bucket lifecycle.

Object Storage bucket configuration (issue #7; behavior facts live-verified 2026-08-18, see docs/gotchas.md)

  • Tags: scaleway_s3_get/put/delete_bucket_tagging (put = full-replace).

  • CORS: scaleway_s3_get/put/delete_bucket_cors (put = full-replace).

  • Versioning: scaleway_s3_get_bucket_versioning, scaleway_s3_set_bucket_versioning (suspend needs confirm).

  • Website: scaleway_s3_get/put/delete_bucket_website (put publishes an endpoint, needs confirm).

  • Visibility: scaleway_s3_get/set_bucket_visibility - coarse public/private via canned ACL (public needs confirm; Bucket Policies are the fine-grained mechanism).

  • Lifecycle rules: scaleway_s3_get/put/delete_bucket_lifecycle - expiration, noncurrent-version expiration, transitions, and aborting incomplete multipart uploads (#74). Put is FULL-REPLACE: omitted rules are removed, so an abort-only put deletes an existing expiration rule. Put/delete are confirm-guarded (expiration and noncurrent expiration permanently delete data). The exceptions: an abort-only put on a bucket whose current rules are abort-only too (checked by a read before writing), and dry_run: true, which returns the rule-level diff (added/removed/changed/unchanged, #80) without writing. Every put echoes that diff.

  • Single-rule lifecycle edits (#80): scaleway_s3_add_lifecycle_rule (server-side merge, duplicate-ID refused, existing rules - including elements this server doesn't model - pass through untouched; confirm unless the new rule is abort-only) and scaleway_s3_remove_lifecycle_rule (confirm unless the removed rule is abort-only; refuses the last remaining rule and unknown IDs).

  • Encryption config: scaleway_s3_get/put/delete_bucket_encryption - real, toggleable setting (console-confirmed), not inert metadata; see docs/gotchas.md.

  • Object Lock: scaleway_s3_get_object_lock, scaleway_s3_enable_object_lock (one-way: never disableable, versioning prerequisite handled, versioning frozen afterwards; create-time lock flag is silently ignored by Scaleway).

  • Read-only analytics (#76): scaleway_s3_bucket_stats (count/bytes/oldest/newest overall and per group; group_by: "key-stem" strips trailing timestamps so a backup series is one row), scaleway_s3_audit_lifecycle (flags buckets with no lifecycle config, no enabled expiration rule, no enabled abort-multipart rule, and - single bucket + check_objects - retention drift where the oldest object outlives the smallest enabled expiration rule).

  • No tools for bucket logging or bucket metrics: Scaleway's S3 endpoint returns NotImplemented for both.

Object Storage Bucket Policies

  • scaleway_s3_get_bucket_policy, scaleway_s3_put_bucket_policy, scaleway_s3_delete_bucket_policy (put is FULL-REPLACE, confirm-guarded; dry_run: true returns the by-Sid statement diff (#80) without writing, and every put echoes it).

  • Statement-level edits (#77): scaleway_s3_add_bucket_policy_statement (server-side read-modify-write, duplicate Sid refused, never revokes) and scaleway_s3_remove_bucket_policy_statement (confirm-guarded; refuses unknown Sids and removing the last statement).

  • Temporary grants (#77): scaleway_s3_grant_temporary_access mints an Allow statement whose Sid encodes the expiry epoch (tmp-<epoch>-<rand>); scaleway_s3_revoke_expired_grants previews (or, with confirm, removes) lapsed tmp-* statements across one bucket or the whole region.

  • scaleway_s3_explain_access (#73) - evaluate one action against a bucket's policy for THIS server's own principal: allowed/denied/no-matching-statement and by which Sid. On any AccessDenied, the S3 tools now append the same context to their error instead of a bare "Access Denied".

Object Storage Objects (multipart/large-file UPLOAD is out of scope; copies over 5 GB go multipart automatically)

  • scaleway_s3_put_object, scaleway_s3_get_object, scaleway_s3_list_objects, scaleway_s3_head_object, scaleway_s3_copy_object, scaleway_s3_delete_object, scaleway_s3_delete_objects

  • scaleway_s3_copy_object switches to a multipart copy (ranged UploadPartCopy, aborted on failure so no billed parts leak) above S3's 5 GB single-request ceiling (#75). scaleway_s3_copy_prefix (#75) does bucket-to-bucket prefix sync with rclone copy --ignore-existing semantics, server-side: dry-run by default, skips existing keys, bounded by max_objects with a continuation token. One server-side copy needs a principal with read on the source AND write on the destination - with per-stage bucket policies that means an explicit temporary grant (#77).

  • Incomplete multipart uploads (#78): scaleway_s3_list_multipart_uploads (parts you pay for that no object listing shows; include_parts: true adds part count/bytes) and scaleway_s3_abort_multipart_upload (confirm-guarded; permanently deletes the uploaded parts).

  • put_object/get_object carry binary payloads as base64 (encoding: "base64"); decoded size is capped by MAX_PUT_OBJECT_BYTES / MAX_GET_OBJECT_BYTES respectively (default 5 MB). get_object auto-detects UTF-8 text vs. binary and returns encoding accordingly; objects over the get ceiling fail fast - use scaleway_s3_generate_presigned_url.

  • scaleway_s3_get_object_tags, scaleway_s3_put_object_tags (put replaces the whole tag set, same replace-not-merge semantics as put_bucket_policy)

  • scaleway_s3_generate_presigned_url - time-limited GET/PUT URL for handing direct object access to something outside MCP, without exposing this server's credential.

Audit Trail — event queries (read-only; all need AuditTrailReadOnly on this server's credential - grant via scaleway_iam_set_policy_rules)

  • scaleway_audit_list_events - who did what, when, from where (API/resource activity).

  • scaleway_audit_list_authentication_events - authentication activity (login/token/MFA outcomes) - separate endpoint.

  • scaleway_audit_list_system_events - actions performed by Scaleway's own systems on your resources.

  • scaleway_audit_list_combined_events - all three streams in one chronological feed, each event tagged api/auth/system.

  • scaleway_audit_get_last_events_overview - the recent-events snapshot the console's Audit Trail landing page shows.

  • scaleway_audit_list_products - products/services/methods integrated with Audit Trail (the valid filter-value catalog).

Audit Trail — alert rules

  • scaleway_audit_list_alert_rules, scaleway_audit_set_alert_rules_enabled (additive), scaleway_audit_replace_enabled_alert_rules (full-replace, confirm-guarded) - Scaleway's preconfigured rules; they can only be enabled/disabled, never created or deleted. Unknown rule IDs reject the whole request atomically (live-verified 2026-08-18).

  • scaleway_audit_list_custom_alert_rules, scaleway_audit_create_custom_alert_rule, scaleway_audit_update_custom_alert_rule (name/description only), scaleway_audit_delete_custom_alert_rule, scaleway_audit_set_custom_alert_rules_enabled, scaleway_audit_replace_enabled_custom_alert_rules - caveat: Scaleway documents these endpoints but the deployed API returns HTTP 501 for every custom-alert-rules method (live-verified 2026-08-18). The tools are in place and surface that error verbatim; they'll work when Scaleway ships the backend.

Audit Trail — export jobs (ship audit events to an Object Storage bucket)

  • scaleway_audit_list_export_jobs, scaleway_audit_create_export_job, scaleway_audit_delete_export_job (confirm-guarded; stops future exports, doesn't delete already-exported objects).

  • Alert/export write tools need more than AuditTrailReadOnly on this server's credential; permission errors surface verbatim.

Security audit (#81, read-only)

  • scaleway_security_audit - cross-references buckets, bucket policies, applications and API keys into severity-grouped findings: buckets with no policy; dangling principals; cross-stage grants (labelled heuristic); Principal "*" or delete/abort grants; never-expiring keys (this server's own key is high); multi-key applications; possibly-orphaned keys whose sibling's description says the prior credential was lost/rotated. Reports only - remediation stays with the confirm-gated tools. The server also warns on stderr at startup when its own operating credential has no expiry.

Scope

Deliberately narrow: IAM identity/policy management (Applications, human Users, and Groups), SSH Keys, JWTs, SAML/SCIM/Security Settings, Bucket Policies, bucket lifecycle and configuration, Object Storage object CRUD (put/get/list/head/copy/delete/tags/presigned URLs; copies above 5 GB go multipart automatically, multipart upload remains out of scope), a read-only access/keys security audit, and Audit Trail (event queries, alert rules, export jobs), because that's what actually caused friction so far. Not a general Scaleway API wrapper - no compute, databases, containers, no multipart upload, no bucket logging/metrics (Scaleway's S3 API doesn't implement them), no Quotas (no real endpoint could be found - see docs/gotchas.md). Extend it the same way if/when those become a recurring need too.

Dev

npm run dev     # tsc --watch
node scripts/smoke-test.mjs   # exercises real tool calls against the live account via .env - not automated CI

Available Tools

117 tools
scaleway_audit_create_custom_alert_ruleCreate a Scaleway Audit Trail custom alert ruleA

Create a custom Audit Trail alert rule: a CEL expression evaluated against incoming audit events, firing when at least occurrences matching events land within evaluation_window. Metadata-only edits later via scaleway_audit_update_custom_alert_rule; the query itself cannot be changed in place - to change the logic, create a new rule and delete the old one. Needs more than AuditTrailReadOnly on THIS server's own credential (read-only covers just the query tools) - if the call fails with permissions_denied, grant the Audit Trail write permission set via scaleway_iam_set_policy_rules. CAVEAT (live-verified 2026-08-18): Scaleway documents the custom-alert-rules endpoints, but the deployed API (fr-par) returns HTTP 501 'unknown method' for every custom-alert-rules method - this tool is kept for when Scaleway implements them and currently surfaces that error verbatim. Don't retry on 501; the preconfigured rules via scaleway_audit_list_alert_rules are the working alternative today.

Inputs: name (required), query (required), occurrences (required), region, +3 more.

scaleway_audit_create_export_jobCreate a Scaleway Audit Trail export jobA

Create an export job shipping Audit Trail events to an Object Storage bucket (S3 destination). Requires confirm=true. The bucket must already exist and be writable - create it first (e.g. scaleway_s3_create_bucket). Live-verified 2026-08-18: creation triggers an IMMEDIATE backfill, not just a future cadence - a fresh job wrote ~6 days of past daily log objects (one JSON file per day, e.g. '2026/07/12/logs_*.json') into the bucket within seconds of creation. scaleway_audit_delete_export_job does not delete these - if you created a bucket just to test this, you'll need to empty it (object-level operations are out of scope for this server) before scaleway_s3_delete_bucket will succeed. Check last_run_at / last_status via scaleway_audit_list_export_jobs afterwards for the ongoing cadence. Needs more than AuditTrailReadOnly on THIS server's own credential (read-only covers just the query tools) - if the call fails with permissions_denied, grant the Audit Trail write permission set via scaleway_iam_set_policy_rules.

Inputs: name (required), bucket (required), confirm (required), tags, +4 more.

scaleway_audit_delete_custom_alert_ruleDelete a Scaleway Audit Trail custom alert ruleA
Destructive

PERMANENTLY delete a custom alert rule by ID. Requires confirm=true. Irreversible - the rule's definition is gone, though past events it recorded remain in the event streams. Needs more than AuditTrailReadOnly on THIS server's own credential (read-only covers just the query tools) - if the call fails with permissions_denied, grant the Audit Trail write permission set via scaleway_iam_set_policy_rules. CAVEAT (live-verified 2026-08-18): Scaleway documents the custom-alert-rules endpoints, but the deployed API (fr-par) returns HTTP 501 'unknown method' for every custom-alert-rules method - this tool is kept for when Scaleway implements them and currently surfaces that error verbatim. Don't retry on 501; the preconfigured rules via scaleway_audit_list_alert_rules are the working alternative today.

Inputs: confirm (required), custom_alert_rule_id (required), region.

scaleway_audit_delete_export_jobDelete a Scaleway Audit Trail export jobA
Destructive

PERMANENTLY delete an export job by ID. Requires confirm=true. Stops future exports; objects already written to the destination bucket are NOT deleted by this call. Needs more than AuditTrailReadOnly on THIS server's own credential (read-only covers just the query tools) - if the call fails with permissions_denied, grant the Audit Trail write permission set via scaleway_iam_set_policy_rules.

Inputs: confirm (required), export_job_id (required), region.

scaleway_audit_get_last_events_overviewGet Scaleway Audit Trail last-events overviewA
Read-onlyIdempotent

Get the snapshot of most recent Audit Trail events the console shows on the Audit Trail landing page - the last handful of api events, no filters, no pagination. Handy as a cheap 'anything happening lately?' check before running a full paginated query. Requires the AuditTrailReadOnly permission set on THIS server's own credential; if every call fails with permissions_denied, that's very likely why - grant it via scaleway_iam_set_policy_rules (organization scope).

Inputs: region, project_id, full_detail.

scaleway_audit_list_alert_rulesList Scaleway Audit Trail alert rulesA
Read-onlyIdempotent

List Scaleway's preconfigured Audit Trail alert rules for this Organization and their current status (enabled/disabled) - the console's Audit Trail > Alerts page. These rules are defined by Scaleway and cannot be created or deleted, only enabled/disabled. Needs more than AuditTrailReadOnly on THIS server's own credential (read-only covers just the query tools) - if the call fails with permissions_denied, grant the Audit Trail write permission set via scaleway_iam_set_policy_rules.

Inputs: region, status, max_pages.

scaleway_audit_list_authentication_eventsList Scaleway Audit Trail authentication eventsA
Read-onlyIdempotent

List authentication events (logins, API-key/token auth, MFA outcomes - success/failure, origin, country, method) across this Organization. A separate endpoint from scaleway_audit_list_events: those cover API/resource activity, these cover authentication activity only. Requires the AuditTrailReadOnly permission set on THIS server's own credential; if every call fails with permissions_denied, that's very likely why - grant it via scaleway_iam_set_policy_rules (organization scope). Defaults to the last 24 hours. Cursor-based pagination with no total_count, same caveats as scaleway_audit_list_events.

Inputs: region, order_by, max_pages, full_detail, +2 more.

scaleway_audit_list_combined_eventsList Scaleway Audit Trail combined eventsA
Read-onlyIdempotent

List all three Audit Trail event streams in one chronological feed - each event is tagged with its kind (api, auth, or system) and compacted per-kind. Use this when investigating a timeline across streams; use the per-stream tools (scaleway_audit_list_events, _list_authentication_events, _list_system_events) when one stream is enough. Requires the AuditTrailReadOnly permission set on THIS server's own credential; if every call fails with permissions_denied, that's very likely why - grant it via scaleway_iam_set_policy_rules (organization scope). Defaults to the last 24 hours. Cursor-based pagination with no total_count, same caveats as scaleway_audit_list_events.

Inputs: region, order_by, max_pages, project_id, +4 more.

scaleway_audit_list_custom_alert_rulesList Scaleway Audit Trail custom alert rulesA
Read-onlyIdempotent

List this Organization's custom Audit Trail alert rules (CEL-expression alerts you created) with their query, evaluation window, occurrence threshold, severity, and enabled/disabled status. Distinct from scaleway_audit_list_alert_rules, which lists Scaleway's preconfigured rules. Needs more than AuditTrailReadOnly on THIS server's own credential (read-only covers just the query tools) - if the call fails with permissions_denied, grant the Audit Trail write permission set via scaleway_iam_set_policy_rules. CAVEAT (live-verified 2026-08-18): Scaleway documents the custom-alert-rules endpoints, but the deployed API (fr-par) returns HTTP 501 'unknown method' for every custom-alert-rules method - this tool is kept for when Scaleway implements them and currently surfaces that error verbatim. Don't retry on 501; the preconfigured rules via scaleway_audit_list_alert_rules are the working alternative today.

Inputs: region, status, max_pages.

scaleway_audit_list_eventsList Scaleway Audit Trail eventsA
Read-onlyIdempotent

List Audit Trail events (who did what, when, from where, against what) across this Organization - the same data as the console's Audit Trail > Events page. Requires the AuditTrailReadOnly permission set on THIS server's own credential; if every call fails with permissions_denied, that's very likely why - grant it via scaleway_iam_set_policy_rules (organization scope). Defaults to the last 24 hours. Pagination is cursor-based with no total_count - max_pages is a safety cap, not a completeness guarantee; the response says whether it was truncated and includes the last page token to continue from.

Inputs: region, max_pages, full_detail, resource_type, +3 more.

scaleway_audit_list_export_jobsList Scaleway Audit Trail export jobsA
Read-onlyIdempotent

List this Organization's Audit Trail export jobs - recurring jobs shipping audit events to an Object Storage bucket (S3 destination config, last run, last status). The console's Audit Trail > Exports page. Needs more than AuditTrailReadOnly on THIS server's own credential (read-only covers just the query tools) - if the call fails with permissions_denied, grant the Audit Trail write permission set via scaleway_iam_set_policy_rules.

Inputs: name, region, order_by, max_pages.

scaleway_audit_list_productsList Scaleway products integrated with Audit TrailA
Read-onlyIdempotent

List the products/services integrated with Audit Trail, with their service and method names - the catalog behind the resource_type / product_name / service_name / method_name filters of the scaleway_audit_list_* event tools. Call this when a filter value is rejected or to discover valid values before querying. Requires the AuditTrailReadOnly permission set on THIS server's own credential; if every call fails with permissions_denied, that's very likely why - grant it via scaleway_iam_set_policy_rules (organization scope).

Inputs: region.

scaleway_audit_list_system_eventsList Scaleway Audit Trail system eventsA
Read-onlyIdempotent

List system events - actions performed by Scaleway's own systems on your resources (product_name / system_name / kind), rather than by a user or application. The third event stream besides scaleway_audit_list_events (API activity) and scaleway_audit_list_authentication_events (authentication). Requires the AuditTrailReadOnly permission set on THIS server's own credential; if every call fails with permissions_denied, that's very likely why - grant it via scaleway_iam_set_policy_rules (organization scope). Defaults to the last 24 hours (the API's own default window is 1 hour, so this tool pins it explicitly). Cursor-based pagination with no total_count, same caveats as scaleway_audit_list_events.

Inputs: region, order_by, max_pages, full_detail, +2 more.

scaleway_audit_replace_enabled_alert_rulesReplace the enabled set of Scaleway Audit Trail alert rulesA
DestructiveIdempotent

Atomically replace the COMPLETE set of enabled preconfigured alert rules: after this call, exactly the listed rules are enabled and every other preconfigured rule is disabled - including ones you did not mention. Prefer scaleway_audit_set_alert_rules_enabled (additive) unless you genuinely want full-replace semantics, e.g. syncing to a declared state. Live-verified 2026-08-18: an unknown rule ID rejects the whole request (HTTP 404) - no partial application. Requires confirm=true. Needs more than AuditTrailReadOnly on THIS server's own credential (read-only covers just the query tools) - if the call fails with permissions_denied, grant the Audit Trail write permission set via scaleway_iam_set_policy_rules.

Inputs: confirm (required), enabled_alert_rule_ids (required), region.

scaleway_audit_replace_enabled_custom_alert_rulesReplace the enabled set of Scaleway Audit Trail custom alert rulesA
DestructiveIdempotent

Atomically replace the COMPLETE set of enabled custom alert rules: after this call, exactly the listed custom rules are enabled and every other custom rule is disabled - including ones you did not mention. Prefer scaleway_audit_set_custom_alert_rules_enabled (additive) unless you genuinely want full-replace semantics. Requires confirm=true. Needs more than AuditTrailReadOnly on THIS server's own credential (read-only covers just the query tools) - if the call fails with permissions_denied, grant the Audit Trail write permission set via scaleway_iam_set_policy_rules. CAVEAT (live-verified 2026-08-18): Scaleway documents the custom-alert-rules endpoints, but the deployed API (fr-par) returns HTTP 501 'unknown method' for every custom-alert-rules method - this tool is kept for when Scaleway implements them and currently surfaces that error verbatim. Don't retry on 501; the preconfigured rules via scaleway_audit_list_alert_rules are the working alternative today.

Inputs: confirm (required), enabled_custom_alert_rule_ids (required), region.

scaleway_audit_set_alert_rules_enabledEnable or disable Scaleway Audit Trail alert rulesA
Idempotent

Enable or disable specific preconfigured Audit Trail alert rules by ID. Touches ONLY the listed rules - the enabled/disabled state of every other rule is left unchanged (unlike scaleway_audit_replace_enabled_alert_rules, which rewrites the whole enabled set). Get IDs from scaleway_audit_list_alert_rules. Live-verified 2026-08-18: an unknown rule ID rejects the whole request (HTTP 404) - no partial application. Needs more than AuditTrailReadOnly on THIS server's own credential (read-only covers just the query tools) - if the call fails with permissions_denied, grant the Audit Trail write permission set via scaleway_iam_set_policy_rules.

Inputs: enabled (required), rule_ids (required), region.

scaleway_audit_set_custom_alert_rules_enabledEnable or disable Scaleway Audit Trail custom alert rulesA
Idempotent

Enable or disable specific custom alert rules by ID. Touches ONLY the listed rules - the state of every other custom rule is left unchanged (unlike scaleway_audit_replace_enabled_custom_alert_rules, which rewrites the whole enabled set). Get IDs from scaleway_audit_list_custom_alert_rules. Needs more than AuditTrailReadOnly on THIS server's own credential (read-only covers just the query tools) - if the call fails with permissions_denied, grant the Audit Trail write permission set via scaleway_iam_set_policy_rules. CAVEAT (live-verified 2026-08-18): Scaleway documents the custom-alert-rules endpoints, but the deployed API (fr-par) returns HTTP 501 'unknown method' for every custom-alert-rules method - this tool is kept for when Scaleway implements them and currently surfaces that error verbatim. Don't retry on 501; the preconfigured rules via scaleway_audit_list_alert_rules are the working alternative today.

Inputs: enabled (required), rule_ids (required), region.

scaleway_audit_update_custom_alert_ruleUpdate a Scaleway Audit Trail custom alert ruleA
Idempotent

Update a custom alert rule's metadata (name/description) in place. The API exposes ONLY these two fields on update - the query, evaluation window, occurrences, and severity are immutable after creation; changing the logic means create-new + delete-old. Needs more than AuditTrailReadOnly on THIS server's own credential (read-only covers just the query tools) - if the call fails with permissions_denied, grant the Audit Trail write permission set via scaleway_iam_set_policy_rules. CAVEAT (live-verified 2026-08-18): Scaleway documents the custom-alert-rules endpoints, but the deployed API (fr-par) returns HTTP 501 'unknown method' for every custom-alert-rules method - this tool is kept for when Scaleway implements them and currently surfaces that error verbatim. Don't retry on 501; the preconfigured rules via scaleway_audit_list_alert_rules are the working alternative today.

Inputs: custom_alert_rule_id (required), name, region, description.

scaleway_iam_add_group_memberAdd one member to a Scaleway IAM GroupA

Add one User and/or one Application to a Group in a single call (both may be given at once - it's not either/or). Grants that member every permission any Policy attaches to this group's group_id, immediately. Existing members are preserved. Refuses Scaleway-managed/special or non-editable groups.

Inputs: group_id (required), user_id, application_id.

scaleway_iam_add_group_membersAdd multiple members to a Scaleway IAM GroupA

Add multiple Users and/or Applications to a Group at once. Existing members are preserved - this is additive, not a replace. Refuses Scaleway-managed/special or non-editable groups.

Inputs: group_id (required), user_ids, application_ids.

scaleway_iam_add_saml_certificateAdd a SAML certificateA

Register a new signing certificate for SAML SSO. ORG-WIDE BLAST RADIUS: this changes how EVERYONE in the Organization signs in. A misconfigured IdP entity_id/SSO URL, or an expired/wrong certificate, can lock every user out of the console at once - console-based recovery is also gated by this policy if it fails. Verify the IdP-side configuration is correct BEFORE calling this, and keep at least one non-SAML login method (password) available on your own account as a fallback. Requires confirm=true. UNVERIFIED FIELD SHAPE: the exact request body was never live-tested while building this tool (to avoid repeating the empty-body incident documented in docs/gotchas.md) - the PEM certificate is sent under 'certificate', matching Scaleway's SAML certificate conventions elsewhere, but this is a best-effort guess pending a real live test.

Inputs: confirm (required), saml_id (required), certificate (required).

scaleway_iam_clone_policyClone Scaleway IAM PolicyA

Clone an existing IAM Policy. The result is an exact copy: same rules, same principal (application_id/user_id/group_id), same tags. Name gets Scaleway's own 'Copy of ' default - rename afterward with scaleway_iam_update_policy if a distinct name is needed (nothing references a Policy by name, so renaming is always safe). Gotcha this tool works around: Scaleway's underlying CLONE endpoint (POST /policies/{id}/clone) ignores its request body entirely and always returns the clone UNATTACHED (no_principal, tags stripped) regardless of the source - confirmed empirically 2026-08-18. This tool follows up with a PATCH restoring the source's principal and tags before returning, so the clone you get back actually matches what 'clone' implies, instead of a silently orphaned policy with no built-in way to reattach it. As with scaleway_iam_create_policy, the response's nb_rules/nb_permission_sets counts can read 0 immediately after this call despite rules having copied correctly - call scaleway_iam_list_policy_rules for ground truth if that count looks wrong.

Inputs: policy_id (required).

scaleway_iam_create_api_keyCreate Scaleway API KeyA

Generate a new API key (access_key + secret_key pair) for an Application. IMPORTANT: secret_key is returned ONLY in this response - Scaleway never shows it again, and there is no recovery endpoint. The caller MUST capture it immediately (e.g. write straight to the target host's env file or a secret manager) rather than just printing it, since it cannot be re-fetched later - only revoked and replaced with a new key. Each call mints a real, immediately-active credential; don't call this speculatively.

Inputs: description (required), application_id (required), expires_at, default_project_id.

scaleway_iam_create_applicationCreate Scaleway IAM ApplicationA

Create a new IAM Application (a non-human identity) in this Organization. Creates the identity only - it has NO permissions until you attach an IAM Policy (scaleway_iam_create_policy) and/or a Bucket Policy. Returns the Application id, needed for both of those next steps.

Inputs: name (required), description.

scaleway_iam_create_groupCreate a Scaleway IAM GroupA

Create a new, empty Group. No confirm needed - fully reversible, grants nothing to anyone until members are added and/or a Policy is attached to its group_id. Name must be unique in the Organization (max 64 chars) - re-creating the same name immediately after deleting a group with that name may hit a brief uniqueness lag (seen elsewhere in this API, e.g. Applications).

Inputs: name (required), tags, description.

scaleway_iam_create_policyCreate Scaleway IAM PolicyA

Create an IAM Policy granting permission sets to an Application/User/Group, scoped to specific Project(s) or the whole Organization. This is the PROJECT-WIDE half of access control - for Object Storage specifically, it grants access to every bucket in the Project(s); narrow to one bucket with a Bucket Policy (scaleway_s3_put_bucket_policy) as well. A Bucket Policy alone is NOT sufficient on Scaleway - both are required together for an Application to actually read/write a specific bucket. Call scaleway_iam_list_permission_sets first to get exact names and scope_types.

Inputs: name (required), rules (required), user_id, group_id, +2 more.

scaleway_iam_create_scim_tokenCreate a SCIM provisioning tokenA

Generate a new SCIM token. IMPORTANT: like an API key's secret, this token is returned ONLY in this response - capture it immediately and configure it in the identity provider, it cannot be re-fetched later. Requires confirm=true - this token grants the IdP power to create/modify/deactivate Users. FIELD SHAPE UNVERIFIED: never live-tested (see docs/gotchas.md) - 'description' is a best-effort guess matching every other credential-creation tool's convention in this server.

Inputs: confirm (required), scim_id (required), description (required).

scaleway_iam_create_ssh_keyRegister a Scaleway IAM SSH KeyA

Register a PUBLIC SSH key (never a private key - rejected client-side if the payload looks like a PEM private-key block or doesn't start with a recognized public-key prefix). This grants SSH access to any Instance/service that trusts keys from this Project - don't call speculatively.

Inputs: name (required), public_key (required), project_id.

scaleway_iam_create_userCreate/invite a Scaleway IAM UserA

Create a human User by email. SEMANTICS UNVERIFIED (2026-08-18): Scaleway's docs state users 'can only be invited to join' an Organization, yet the API exposes this create endpoint requiring a type field - most likely this sends the person an invitation/set-password email and creates a guest; that happy path could not be live-verified without a disposable mailbox. A REAL email is sent to the address on success - never call speculatively. Requires confirm=true. The API validates email format and a type ('guest' is the default here, inferred from the guest-only delete endpoint - also unverified).

Inputs: email (required), confirm (required), tags, type.

scaleway_iam_delete_api_keyDelete Scaleway API KeyA
Destructive

PERMANENTLY revoke an API key by its access_key. Requires confirm=true. Irreversible - anything using this key stops authenticating immediately.

Inputs: confirm (required), access_key (required).

scaleway_iam_delete_applicationDelete Scaleway IAM ApplicationA
Destructive

PERMANENTLY delete an IAM Application: also deletes every API key it holds and detaches every policy scoped to it. Any credential still deployed somewhere (e.g. in a host's .env.prod) stops authenticating immediately and irreversibly. Requires confirm=true.

Inputs: confirm (required), application_id (required).

scaleway_iam_delete_groupDelete a Scaleway IAM GroupA
Destructive

PERMANENTLY delete a Group. Requires confirm=true. IRREVERSIBLE: any Policy granting access via this group's group_id stops applying to its former members immediately - anyone relying solely on this group's grants loses that access. Refuses Scaleway-managed/special groups (all_users/all_applications) tool-side - fetches the group first to check.

Inputs: confirm (required), group_id (required).

scaleway_iam_delete_jwtRevoke a JWT sessionA
Destructive

Immediately invalidate one active browser/console session. Requires confirm=true. Whoever holds that session is signed out right away - same severity as revoking an API key, but for an interactive login instead of a programmatic credential.

Inputs: jti (required), confirm (required).

scaleway_iam_delete_policyDelete Scaleway IAM PolicyA
Destructive

PERMANENTLY delete an IAM Policy. Requires confirm=true. Every permission it granted is revoked immediately.

Inputs: confirm (required), policy_id (required).

scaleway_iam_delete_saml_certificateDelete a SAML certificateA
Destructive

PERMANENTLY remove one SAML certificate. Requires confirm=true. If this is the certificate actively validating SSO assertions, SSO breaks immediately for everyone until a replacement is added - check scaleway_iam_list_saml_certificates for other valid certificates first if SSO must stay available. PATH UNCONFIRMED - see scaleway_iam_get_saml_certificate's description.

Inputs: confirm (required), saml_id (required), certificate_id (required).

scaleway_iam_delete_scim_tokenDelete a SCIM provisioning tokenA
Destructive

PERMANENTLY revoke a SCIM token. Requires confirm=true. IdP provisioning breaks immediately until a new token is created and configured in the IdP. PATH UNCONFIRMED: follows the same nesting convention as scaleway_iam_list_scim_tokens (/scim/{scim_id}/tokens) but the single-item path could not be live-verified without recreating a live SCIM config - deliberately avoided, see docs/gotchas.md.

Inputs: confirm (required), scim_id (required), token_id (required).

scaleway_iam_delete_ssh_keyDelete a Scaleway IAM SSH KeyA
Destructive

PERMANENTLY remove an SSH key. Requires confirm=true. If any Instance/service was relying solely on this key for access, whoever holds it loses SSH access immediately - confirm it's no longer in use, or that another access path exists, before deleting.

Inputs: confirm (required), ssh_key_id (required).

scaleway_iam_delete_userDelete a Scaleway IAM UserA
Destructive

PERMANENTLY remove a User from this Organization. Requires confirm=true. Two guards: (1) this tool refuses to delete the Organization OWNER (type === 'owner') outright; (2) the API's own endpoint is guest-scoped ('Delete a guest user') - deleting a member/owner is rejected server-side and that error is surfaced verbatim. Live-probed 2026-08-18 on bogus ids only; guest happy-path unverified.

Inputs: confirm (required), user_id (required).

scaleway_iam_delete_user_mfa_otpDelete a Scaleway IAM User's MFA OTP factorA
Destructive

Remove the person's TOTP MFA factor. SECURITY-WEAKENING on a human account - requires confirm=true. Expected legitimate use: lost authenticator recovery. Creating/enrolling a new OTP is deliberately NOT a tool here: enrollment requires the human's authenticator code to validate, and a created-but-unvalidated factor leaves MFA half-configured (flow states unprobed, endpoint shape live-verified 2026-08-18).

Inputs: confirm (required), user_id (required).

scaleway_iam_disable_samlDisable SAML SSO for the OrganizationA
Destructive

PERMANENTLY remove the Organization's SAML SSO configuration. Requires confirm=true. Anyone who relies on SSO to sign in falls back to password/other login methods - if they have none set, they are LOCKED OUT. Confirmed via live probe: the working endpoint is a top-level DELETE by the SAML config's own id, NOT the org-nested path (which 405s) - this tool fetches the config first to resolve that id.

Inputs: confirm (required).

scaleway_iam_disable_scimDisable SCIM provisioning for the OrganizationA
Destructive

PERMANENTLY disable SCIM. Requires confirm=true. Provisioning from the IdP stops immediately - including DEPROVISIONING: if the IdP was the mechanism offboarding relies on to remove departed Users, that stops working silently until re-enabled. Confirmed via live probe: the working endpoint is a top-level DELETE by the SCIM config's own id, NOT the org-nested path (which 405s) - this tool fetches the config first.

Inputs: confirm (required).

scaleway_iam_enable_samlEnable SAML SSO for the OrganizationA
Destructive

Enable SAML SSO, registering the identity provider's entity_id and SSO URL. ORG-WIDE BLAST RADIUS: this changes how EVERYONE in the Organization signs in. A misconfigured IdP entity_id/SSO URL, or an expired/wrong certificate, can lock every user out of the console at once - console-based recovery is also gated by this policy if it fails. Verify the IdP-side configuration is correct BEFORE calling this, and keep at least one non-SAML login method (password) available on your own account as a fallback. Requires confirm=true. The resulting config starts in status 'missing_certificate' until a certificate is added via scaleway_iam_add_saml_certificate - SSO logins cannot succeed until then, so enabling alone does not immediately expose a working (or misconfigurable) login path.

Inputs: confirm (required), entity_id (required), single_sign_on_url (required).

scaleway_iam_enable_scimEnable SCIM provisioning for the OrganizationA

Enable SCIM (lets an external identity provider create/update/deactivate Users automatically). Requires confirm=true. Live-probed 2026-08-18: this endpoint takes no request fields - enabling alone does not grant any provisioning access by itself, a token must be created separately (scaleway_iam_create_scim_token) and configured in the IdP before anything can actually provision.

Inputs: confirm (required).

scaleway_iam_get_applicationGet Scaleway IAM ApplicationA
Read-onlyIdempotent

Get one IAM Application by id, including its API-key count.

Inputs: application_id (required).

scaleway_iam_get_groupGet a Scaleway IAM GroupA
Read-onlyIdempotent

Read one Group's full details, including its complete member lists (user_ids/application_ids) and special-group flags (managed/all_users/all_applications).

Inputs: group_id (required).

scaleway_iam_get_jwtGet one JWT session by idA
Read-onlyIdempotent

Read one JWT session's metadata (jti, audience, expiry, IP, user agent) by its id.

Inputs: jti (required).

scaleway_iam_get_policyGet Scaleway IAM PolicyA
Read-onlyIdempotent

Get one IAM Policy's metadata (name, description, tags, application_id, nb_rules count) by id. Does NOT return the actual rules array - confirmed empirically that Scaleway's GET here never populates it despite create accepting rules in its request body. Call scaleway_iam_list_policy_rules for the real rules.

Inputs: policy_id (required).

scaleway_iam_get_saml_certificateGet a SAML certificateA
Read-onlyIdempotent

Read one SAML certificate's metadata (fingerprint, expiry) by id. PATH UNCONFIRMED: scaleway_iam_list_saml_certificates's path (/saml/{saml_id}/certificates) is live-verified; this single-item path follows the same nesting convention but could not be confirmed without recreating a live SAML config (deliberately avoided - see docs/gotchas.md). May need correction on first real use.

Inputs: saml_id (required), certificate_id (required).

scaleway_iam_get_saml_configGet the Organization's SAML SSO configurationA
Read-onlyIdempotent

Read the Organization's SAML SSO config (status, entity IDs, ACS URL). Returns an error if SAML has never been enabled for this Organization - that is the expected/default state, not a fault.

Inputs: no named parameters.

scaleway_iam_get_scim_configGet the Organization's SCIM provisioning configurationA
Read-onlyIdempotent

Read the Organization's SCIM config (id, created_at). Returns an error if SCIM was never enabled - that is the expected default state.

Inputs: no named parameters.

scaleway_iam_get_security_settingsGet the Organization's security settingsA
Read-onlyIdempotent

Read org-wide auth policy: password-renewal enforcement, grace period duration, login-attempt lockout threshold, max session/API-key-expiration durations.

Inputs: no named parameters.

scaleway_iam_get_ssh_keyGet a Scaleway IAM SSH KeyA
Read-onlyIdempotent

Read one SSH key by id, including the full public_key text and fingerprint.

Inputs: ssh_key_id (required).

scaleway_iam_get_userGet a Scaleway IAM UserA
Read-onlyIdempotent

Read one human User by id - full profile incl. status, type, locked, MFA flags.

Inputs: user_id (required).

scaleway_iam_list_api_keysList Scaleway API KeysA
Read-onlyIdempotent

List API keys in this Organization (never includes secret_key - only visible once, at creation). Optionally filter to one Application.

Inputs: application_id.

scaleway_iam_list_applicationsList Scaleway IAM ApplicationsA
Read-onlyIdempotent

List IAM Applications in this Organization, optionally filtered by name substring.

Inputs: name_filter.

scaleway_iam_list_groupsList Scaleway IAM GroupsA
Read-onlyIdempotent

List Groups in the Organization, including Scaleway's preset groups (Administrators/Editors/Billing Administrators) and any special managed groups. 'name' is an EXACT match, not a substring filter. Array filters (group_ids/user_ids/application_ids) narrow to groups matching ANY of the given ids.

Inputs: tag, name, order_by, user_ids, +2 more.

scaleway_iam_list_jwtsList a User's active JWTs (browser/console sessions)A
Read-onlyIdempotent

List active JWT sessions (browser/console logins) for one User. NOT the same as API keys - these are interactive-login session tokens. Live-probed 2026-08-18: this server's Application/API-key credential gets 403 'insufficient permissions' on resource 'self_jwt' even with full IAMManager - the surface appears scoped to a session's own JWTs, which an API-key credential never has. May only be callable from a human's own session context, not from this server. Reports the error verbatim if so.

Inputs: audience_id (required).

scaleway_iam_list_permission_setsList Scaleway IAM Permission SetsA
Read-onlyIdempotent

List every permission set Scaleway IAM policies can grant (e.g. ObjectStorageReadOnly, IAMPolicyManager). Each entry's scope_type is 'organization' or 'projects' - a single policy rule can only combine permission sets that share the SAME scope_type (mixing them fails with 'permission sets must be of the same scope type'); use separate rules for each scope_type instead. Call this BEFORE scaleway_iam_create_policy to confirm exact names and scope_types - guessing a name or assuming its scope produces an actionable-but-late 400/invalid_arguments error.

Inputs: name_filter.

scaleway_iam_list_policiesList Scaleway IAM PoliciesA
Read-onlyIdempotent

List IAM Policies in this Organization, optionally filtered to those attached to one Application.

Inputs: application_id.

scaleway_iam_list_policy_rulesList rules on a Scaleway IAM PolicyA
Read-onlyIdempotent

Get the actual rules (permission sets + scope, each as project_ids or organization_id) attached to a Policy. Use this, not scaleway_iam_get_policy, to see what a policy really grants.

Inputs: policy_id (required).

scaleway_iam_list_saml_certificatesList an Organization's SAML certificatesA
Read-onlyIdempotent

List certificates registered for SAML SSO validation.

Inputs: saml_id (required).

scaleway_iam_list_scim_tokensList an Organization's SCIM tokensA
Read-onlyIdempotent

List SCIM provisioning tokens. Never includes the token secret (only visible once, at creation, per scaleway_iam_create_scim_token).

Inputs: scim_id (required).

scaleway_iam_list_ssh_keysList Scaleway IAM SSH KeysA
Read-onlyIdempotent

List SSH public keys registered in a Project (used to grant SSH access to Instances). Compact view - omits the actual public_key text; use scaleway_iam_get_ssh_key for the full key if needed. Needs SSHKeysReadOnly/FullAccess.

Inputs: name, project_id.

scaleway_iam_list_user_grace_periodsList a Scaleway IAM User's grace periodsA
Read-onlyIdempotent

Read the User's grace periods (post-lock/deletion data-access windows). Read-only.

Inputs: user_id (required).

scaleway_iam_list_usersList Scaleway IAM UsersA
Read-onlyIdempotent

List human Users of this Organization (the console's IAM > Users page) - id, email, status, type (owner/member/guest), locked and MFA flags. Needs IAMUserReadOnly/IAMUserManager on this server's credential.

Inputs: email.

scaleway_iam_lock_userLock a Scaleway IAM UserA
DestructiveIdempotent

Lock a human User out of the Organization IMMEDIATELY (expected use: compromise response, offboarding). Requires confirm=true. This acts on a person, not a service - the console shows them as locked. Exact session/token invalidation timing unverified.

Inputs: confirm (required), user_id (required).

scaleway_iam_remove_group_memberRemove one member from a Scaleway IAM GroupA
Destructive

Remove one User and/or one Application from a Group. Requires confirm=true. That member immediately loses every permission this group's attached Policies granted them - check they don't rely solely on this group for access they still need. Refuses Scaleway-managed/special or non-editable groups.

Inputs: confirm (required), group_id (required), user_id, application_id.

scaleway_iam_set_group_membersOverwrite a Scaleway IAM Group's entire membershipA
DestructiveIdempotent

FULL-REPLACE a Group's membership: the given user_ids/application_ids become the COMPLETE member list - anyone currently a member but NOT in either list is REMOVED, losing this group's grants immediately. Requires confirm=true. Pass empty arrays to remove everyone. Refuses Scaleway-managed/special groups.

Inputs: confirm (required), group_id (required), user_ids (required), application_ids (required).

scaleway_iam_set_policy_rulesSet rules on a Scaleway IAM PolicyA
DestructiveIdempotent

Overwrite the COMPLETE rules array on an existing Policy in one atomic call - the safe way to add or remove a permission set on a live policy. Requires confirm=true. Prefer this over delete+recreate: deleting a policy that grants its own holder IAMPolicyManager revokes that permission the instant it's deleted, before a replacement can be created, which can lock the credential you're using out of IAM entirely. Distinct lockout mode: a successful replace that drops this server's IAM-management rule (IAMPolicyManager/IAMApplicationManager) cannot be undone through this server - the credential then cannot call this tool, or any other IAM policy/application tool, to fix itself. Call scaleway_iam_list_policy_rules first to get the current array before changing it.

Inputs: rules (required), confirm (required), policy_id (required).

scaleway_iam_unlock_userUnlock a Scaleway IAM UserA
Idempotent

Restore a locked User's access. Reversible counterpart of lock_user.

Inputs: user_id (required).

scaleway_iam_update_api_keyUpdate Scaleway API KeyA
Idempotent

Change an existing API key's description, expiry, or default_project_id WITHOUT rotating its secret - the access_key/secret_key pair itself never changes. Use this instead of delete+recreate for a metadata-only change (e.g. extending an expiry before it lapses, or fixing a stale description); delete+recreate would mint a new secret and break anything already deployed with the old one. Only the fields you pass are changed; omitted fields are left as-is.

Inputs: access_key (required), expires_at, description, default_project_id.

scaleway_iam_update_applicationUpdate Scaleway IAM ApplicationA
Idempotent

Rename/re-describe/re-tag an existing IAM Application. Only the id is fixed - name, description and tags are all safe to change at any time: nothing else in Scaleway references an Application by name (Bucket Policies and API keys reference application_id, never the name), so renaming never breaks a live credential or requires touching anything downstream. Only the fields you pass are changed; omitted fields are left as-is.

Inputs: application_id (required), name, tags, description.

scaleway_iam_update_groupUpdate a Scaleway IAM GroupA
Idempotent

Change a Group's name/description/tags. Only passed fields change. Refuses Scaleway-managed/special groups tool-side.

Inputs: group_id (required), name, tags, description.

scaleway_iam_update_policyUpdate Scaleway IAM PolicyA
Idempotent

Rename/re-describe/re-tag an existing IAM Policy. Does NOT touch rules, application_id, or any other principal/permission field - only name, description, tags change, so this never alters what the policy grants or to whom. Nothing references a Policy by name, so renaming is always safe. Only the fields you pass are changed; omitted fields are left as-is.

Inputs: policy_id (required), name, tags, description.

scaleway_iam_update_samlUpdate the Organization's SAML SSO configurationA
DestructiveIdempotent

Change the registered identity provider's entity_id/SSO URL. ORG-WIDE BLAST RADIUS: this changes how EVERYONE in the Organization signs in. A misconfigured IdP entity_id/SSO URL, or an expired/wrong certificate, can lock every user out of the console at once - console-based recovery is also gated by this policy if it fails. Verify the IdP-side configuration is correct BEFORE calling this, and keep at least one non-SAML login method (password) available on your own account as a fallback. Requires confirm=true. Method is PATCH per the API reference (distinct from enable, which is POST); the PATCH call itself was not live-verified (deliberately - see docs/gotchas.md).

Inputs: confirm (required), entity_id (required), single_sign_on_url (required).

scaleway_iam_update_security_settingsUpdate the Organization's security settingsA
DestructiveIdempotent

Change org-wide auth policy. ORG-WIDE BLAST RADIUS, BOTH DIRECTIONS: tightening (e.g. lowering login_attempts_before_locked, enabling enforce_password_renewal) can lock out users who haven't met the new requirement yet; loosening (raising session/expiration durations) weakens the org's security posture for everyone. Only the fields you pass are changed - live-verified that an empty call leaves every current value untouched, unlike SAML/SCIM's enable endpoints (see docs/gotchas.md). Requires confirm=true.

Inputs: confirm (required), grace_period_duration, enforce_password_renewal, max_login_session_duration, +2 more.

scaleway_iam_update_ssh_keyRename a Scaleway IAM SSH KeyA
Idempotent

Change an SSH key's name. The key material itself (public_key/fingerprint) cannot be changed here - delete and re-create to rotate the actual key.

Inputs: name (required), ssh_key_id (required).

scaleway_iam_update_userUpdate a Scaleway IAM UserB
Idempotent

Update a User's mutable profile fields (tags; name/email where the API allows - invalid fields are rejected with the API's own validation message). Only passed fields change.

Inputs: user_id (required), tags, last_name, first_name.

scaleway_iam_update_user_passwordSet a Scaleway IAM User's password (admin reset)A
DestructiveIdempotent

ADMIN-SET password reset: the new password is supplied BY THE CALLER (API takes it explicitly, 1-72 bytes - live-probed) and takes effect immediately for the person's login. Account-takeover-grade power over a human - requires confirm=true. The password value travels in this tool call's arguments: generate a strong one, deliver it to the person over a separate secure channel, and never reuse an existing/known password. Whether active sessions are invalidated is unverified.

Inputs: confirm (required), user_id (required), password (required).

scaleway_iam_update_user_usernameChange a Scaleway IAM User's username (login identity)A
Idempotent

Change what the person types to LOG IN. Requires confirm=true - they must be told, or they cannot sign in next time. Live-probed on bogus ids only (404 shape).

Inputs: confirm (required), user_id (required), new_username (required).

scaleway_s3_copy_objectCopy an object within or across Scaleway Object Storage bucketsA
Idempotent

Server-side copy of one object to a new bucket/key, without downloading and re-uploading. Source and destination must be in the same region.

Inputs: dest_key (required), source_key (required), dest_bucket (required), source_bucket (required), +1 more.

scaleway_s3_create_bucketCreate Scaleway Object Storage bucketA

Create a new, empty Object Storage bucket, private by default. Configure it afterwards with the scaleway_s3_*bucket* config tools (visibility, versioning, tags, CORS, website, lifecycle, encryption). Object Lock cannot be enabled at creation on Scaleway (the S3 create-time flag is silently ignored) - enable versioning then scaleway_s3_enable_object_lock afterwards.

Inputs: bucket (required), region.

scaleway_s3_delete_bucketDelete Scaleway Object Storage bucketA
Destructive

PERMANENTLY delete an empty Object Storage bucket. Requires confirm=true. Fails if the bucket still contains objects.

Inputs: bucket (required), confirm (required), region.

scaleway_s3_delete_bucket_corsDelete Scaleway bucket CORS rulesA

Remove ALL CORS rules from a bucket - browsers regain no cross-origin access (default-deny).

Inputs: bucket (required), region.

scaleway_s3_delete_bucket_encryptionDelete Scaleway bucket encryption configA

Remove the bucket's default-encryption configuration. Live-verified 2026-08-18: this reverts the console's 'Encryption type' back to 'Disabled' - a real change, not a no-op on inert metadata.

Inputs: bucket (required), region.

scaleway_s3_delete_bucket_lifecycleDelete Scaleway bucket lifecycle rulesA
Destructive

Remove ALL lifecycle rules. Requires confirm=true: objects that would have expired keep living (rule removal stops pending deletions - dangerous in the opposite direction of putting rules).

Inputs: bucket (required), confirm (required), region.

scaleway_s3_delete_bucket_policyDelete Scaleway Bucket PolicyA
DestructiveIdempotent

Remove a bucket's Bucket Policy entirely. Requires confirm=true. Any principal relying only on this policy loses access to the bucket immediately.

Inputs: bucket (required), confirm (required), region.

scaleway_s3_delete_bucket_taggingDelete Scaleway bucket tagsA
DestructiveIdempotent

Remove ALL tags from a bucket. Requires confirm=true. Reversible in the sense that tags can be re-applied, but the current set is lost.

Inputs: bucket (required), confirm (required), region.

scaleway_s3_delete_bucket_websiteDelete Scaleway bucket website configurationB

Remove the static-website configuration - the website endpoint stops serving.

Inputs: bucket (required), region.

scaleway_s3_delete_objectDelete a single object from Scaleway Object StorageA
DestructiveIdempotent

PERMANENTLY delete one object. Requires confirm=true.

Inputs: key (required), bucket (required), confirm (required), region.

scaleway_s3_delete_objectsBatch-delete objects from Scaleway Object StorageA
DestructiveIdempotent

PERMANENTLY delete up to 1000 explicitly-named objects in one call. Requires confirm=true. No prefix/wildcard form - never wipes a bucket recursively.

Inputs: keys (required), bucket (required), confirm (required), region.

scaleway_s3_enable_object_lockEnable Object Lock on a Scaleway bucket (ONE-WAY, irreversible)A
DestructiveIdempotent

Enable Object Lock (WORM: object versions can never be deleted before their retention expires). IRREVERSIBLE: once enabled it can NEVER be disabled or removed - Scaleway rejects the disable request at the XML-schema level, and versioning becomes permanently frozen at Enabled (both live-verified 2026-08-18). Prerequisite: versioning must be Enabled first - pass enable_versioning_if_needed=true to let this tool do that, otherwise the API rejects with InvalidBucketState. Creating a bucket with object lock at creation time is NOT possible on Scaleway: the S3 CreateBucket flag ObjectLockEnabledForBucket is silently ignored (live-verified 2026-08-18) - this tool is the only working path. An empty locked bucket can still be deleted.

Inputs: bucket (required), confirm (required), region, enable_versioning_if_needed.

scaleway_s3_generate_presigned_urlGenerate a time-limited presigned URL for an objectA
Destructive

Generate a URL that grants direct GET or PUT access to one object for a limited time, without exposing this server's credential. Useful for handing a download/upload link to something outside MCP, or for content too large for scaleway_s3_get_object/put_object's inline transfer. operation='put' requires confirm=true because it exports a write capability outside the MCP boundary.

Inputs: key (required), bucket (required), operation (required), region, +3 more.

scaleway_s3_get_bucket_corsGet Scaleway bucket CORS rulesA
Read-onlyIdempotent

Read a bucket's CORS rules. Errors with NoSuchCORSConfiguration if none are set.

Inputs: bucket (required), region.

scaleway_s3_get_bucket_encryptionGet Scaleway bucket encryption configA
Read-onlyIdempotent

Read the bucket's S3 default-encryption configuration. A fresh bucket returns an EMPTY config (HTTP 200, not an error, unlike AWS which errors) rather than 'AES256 always on' - this is a REAL, toggleable setting, not inert metadata: live-verified 2026-08-18 via the console's Settings tab, put_bucket_encryption/delete_bucket_encryption visibly flip the bucket's 'Encryption type' there between 'Disabled' and 'SSE-ONE encryption with Scaleway Object Native Encryption keys'. (An earlier version of this description claimed the config was declarative-only with no effect - that was wrong, corrected after console cross-validation.)

Inputs: bucket (required), region.

scaleway_s3_get_bucket_lifecycleGet Scaleway bucket lifecycle rulesA
Read-onlyIdempotent

Read a bucket's lifecycle rules. Errors with NoSuchLifecycleConfiguration if none are set.

Inputs: bucket (required), region.

scaleway_s3_get_bucket_policyGet Scaleway Bucket PolicyA
Read-onlyIdempotent

Read the current Bucket Policy JSON attached to an Object Storage bucket. Returns an error if the bucket has no policy.

Inputs: bucket (required), region.

scaleway_s3_get_bucket_taggingGet Scaleway bucket tagsA
Read-onlyIdempotent

Read a bucket's tags (key/value pairs). Errors with NoSuchTagSet if no tags are set.

Inputs: bucket (required), region.

scaleway_s3_get_bucket_versioningGet Scaleway bucket versioning stateA
Read-onlyIdempotent

Read a bucket's versioning state: '' (never enabled), 'Enabled', or 'Suspended'. Note: once Object Lock is enabled on a bucket, versioning is frozen at Enabled and cannot be suspended (live-verified 2026-08-18).

Inputs: bucket (required), region.

scaleway_s3_get_bucket_visibilityGet Scaleway bucket visibility (public/private)A
Read-onlyIdempotent

Read a bucket's visibility, derived from its ACL grants: 'public' if the anonymous AllUsers group holds any grant, otherwise 'private'. Returns the raw grants too.

Inputs: bucket (required), region.

scaleway_s3_get_bucket_websiteGet Scaleway bucket website configurationA
Read-onlyIdempotent

Read a bucket's static-website configuration. Errors with NoSuchWebsiteConfiguration if none is set.

Inputs: bucket (required), region.

scaleway_s3_get_objectDownload an object from Scaleway Object StorageA
Read-onlyIdempotent

Download a single object's content and metadata. Content is returned as UTF-8 text when it round-trips cleanly as text, otherwise as base64 (see 'encoding' in the result). Decoded size is capped (MAX_GET_OBJECT_BYTES, default 5 MB) - larger objects fail fast; use scaleway_s3_generate_presigned_url instead.

Inputs: key (required), bucket (required), region.

scaleway_s3_get_object_lockGet Scaleway bucket object-lock configurationA
Read-onlyIdempotent

Read whether Object Lock (WORM protection) is enabled on the bucket. ObjectLockConfigurationNotFoundError means NOT enabled - there is no 'disabled' state, the config simply does not exist until first enabled.

Inputs: bucket (required), region.

scaleway_s3_get_object_tagsGet an object's tagsA
Read-onlyIdempotent

Read the key/value tag set attached to an object.

Inputs: key (required), bucket (required), region.

scaleway_s3_head_objectGet object metadata without downloading its contentA
Read-onlyIdempotent

Fetch an object's metadata (content-type, size, etag, last-modified, user metadata) without transferring its body. Cheaper than scaleway_s3_get_object when you don't need the content.

Inputs: key (required), bucket (required), region.

scaleway_s3_list_bucketsList Scaleway Object Storage bucketsA
Read-onlyIdempotent

List Object Storage buckets in one region (buckets are region-scoped on Scaleway, unlike AWS's account-wide bucket namespace).

Inputs: region.

scaleway_s3_list_objectsList objects in a Scaleway Object Storage bucketA
Read-onlyIdempotent

List object keys in a bucket, optionally scoped by prefix and grouped by delimiter (like folders). Paginated - pass the returned next_continuation_token to continue.

Inputs: bucket (required), limit, prefix, region, +2 more.

scaleway_s3_put_bucket_corsSet Scaleway bucket CORS rules (full replace)A
Idempotent

Set a bucket's CORS rules. FULL-REPLACE semantics: the provided list becomes the complete rule set - existing rules not in the list are removed. This loosens or restricts browser cross-origin access to the bucket.

Inputs: rules (required), bucket (required), region.

scaleway_s3_put_bucket_encryptionSet Scaleway bucket encryption configA
Idempotent

Set the bucket's S3 default-encryption configuration (AES256). Live-verified 2026-08-18: this is a real setting, not S3-API-compatibility filler - the console's Settings tab shows 'Encryption type' flip from 'Disabled' to 'SSE-ONE encryption with Scaleway Object Native Encryption keys' immediately after this call.

Inputs: bucket (required), region, algorithm.

scaleway_s3_put_bucket_lifecycleSet Scaleway bucket lifecycle rules (full replace)A
DestructiveIdempotent

Set a bucket's lifecycle rules. FULL-REPLACE: the provided list becomes the complete rule set. DESTRUCTIVE: rules with expiration permanently DELETE matching objects once they take effect - requires confirm=true regardless of rule content. Rules apply to objects stored with Scaleway storage classes; transition targets Scaleway classes (ONEZONE_IA, GLACIER).

Inputs: rules (required), bucket (required), confirm (required), region.

scaleway_s3_put_bucket_policySet Scaleway Bucket PolicyA
DestructiveIdempotent

Replace a bucket's entire Bucket Policy with the given JSON document. This is the bucket-scoped half of access control - see scaleway_iam_create_policy's description for why both an IAM Policy and a Bucket Policy are needed together. Recommended safety net: include a statement granting the bucket owner's own user_id full access (mirrors the console's 'Maintain access to bucket' checkbox) so a mistake here can never lock the account out of its own bucket.

Inputs: bucket (required), policy_json (required), region.

scaleway_s3_put_bucket_taggingSet Scaleway bucket tags (full replace)A
DestructiveIdempotent

Set a bucket's tags. FULL-REPLACE semantics: the provided list becomes the complete tag set - tags not in the list are removed.

Inputs: tags (required), bucket (required), region.

scaleway_s3_put_bucket_websiteSet Scaleway bucket website configuration (full replace)A
Idempotent

Configure the bucket for static-website serving (index document, optional error document). FULL-REPLACE. Requires confirm=true because this publishes an HTTP website endpoint for the bucket. The website endpoint follows Scaleway's s3-website..scw.cloud naming - check the console bucket page for the exact URL; anonymous website access on Scaleway additionally depends on the bucket's visibility (see scaleway_s3_set_bucket_visibility).

Inputs: bucket (required), confirm (required), index_document (required), region, +1 more.

scaleway_s3_put_objectUpload an object to Scaleway Object StorageA
Idempotent

Upload (or overwrite) a single object. Single-part only - see the 'content' field for the size ceiling and the binary-payload encoding.

Inputs: key (required), bucket (required), content (required), region, +2 more.

scaleway_s3_put_object_tagsSet an object's tagsA
DestructiveIdempotent

Replace an object's entire tag set. This REPLACES, it does not merge - see the 'tags' field.

Inputs: key (required), tags (required), bucket (required), region.

scaleway_s3_set_bucket_versioningEnable or suspend Scaleway bucket versioningA
Idempotent

Set versioning to Enabled or Suspended. Enabling keeps every object version (deletes create delete markers instead of removing data). Suspending requires confirm=true: new writes stop versioning, existing versions are retained. VERSIONING CAN NEVER GO BACK TO 'never-enabled' - suspending is not disabling. Suspending fails outright (InvalidBucketState) while Object Lock is enabled on the bucket.

Inputs: bucket (required), status (required), region, confirm.

scaleway_s3_set_bucket_visibilitySet Scaleway bucket visibility (public/private)A
Idempotent

Set bucket visibility via canned ACL: 'public-read' grants the anonymous internet READ on ALL objects (the console's 'Public' setting) - requires confirm=true; 'private' restores owner-only access. Note Bucket Policies (scaleway_s3_put_bucket_policy) are the finer-grained mechanism - this tool is the coarse on/off switch.

Inputs: bucket (required), visibility (required), region, confirm.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 117 tools

    Disambiguation4/5

    Tools are grouped by clear service prefixes (iam/s3/audit) and almost every tool targets a distinct resource-action pair, so an agent can usually tell them apart. A few pairs could still be confused, notably add_group_member vs add_group_members and set_alert_rules_enabled vs replace_enabled_alert_rules, though the descriptions do clarify the semantics.

    Naming Consistency5/5

    The naming pattern is consistently service_verb_noun across all 117 tools (e.g. scaleway_iam_list_groups, scaleway_s3_put_bucket_policy, scaleway_audit_list_events). Minor verb variation like set_bucket_versioning vs put_bucket_tagging is conventional rather than chaotic, and there is no mixing of naming styles.

    Tool Count1/5

    117 tools far exceeds the rubric's 50+ threshold for an extreme count and is excessive for an agent to navigate efficiently. Even though the three domains are broad, the surface is massively oversized and will impose serious context and selection overhead.

    Completeness4/5

    The IAM, S3, and Audit Trail domains are covered with broad lifecycle support: create/read/update/delete, policy management, credential handling, bucket configuration, object operations, audit event streams, alert rules, and export jobs. Minor gaps exist, such as object-version-level operations, object-lock retention configuration, and the custom alert rule tools which currently hit API 501 errors, but core workflows are not blocked.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      Enables interaction with AWS S3 through MCP, supporting bucket and object management, lifecycle configurations, tagging, policies, CORS settings, presigned URLs, and file uploads/downloads.
      3
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Official MCP server for Skycloak (managed Keycloak) that enables managing clusters, realms, applications, identity providers, users, themes, exports, SIEM destinations, and webhooks through natural language, with OAuth or API key authentication.
      141
      1
      Apache 2.0
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for OVHcloud Object Storage, enabling management of buckets, objects, project users, S3 credentials, and storage policies. Read-only by default with opt-in write tools.
      1
      37 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables managing and interacting with any S3-compatible storage endpoint through MCP tools for listing, reading, writing, copying, and deleting buckets and objects.
      11
      MIT