scaleway-ops-mcp-server
Provides tools for managing Scaleway IAM resources (applications, API keys, policies, permission sets, users, groups, SSH keys, JWTs, SAML SSO, SCIM, security settings) and Object Storage (buckets, bucket policies, objects, bucket configuration).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@scaleway-ops-mcp-server Provision a new IAM application with API key and bucket policy for bucket 'my-data'."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
scaleway-ops-mcp-server
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 buildConfiguration
Environment variables (see .env.example):
Variable | Required | Purpose |
| yes | Access key of the credential this server authenticates as. |
| yes | Secret key. Used as |
| yes | Organization these operations run in (UUID). |
| yes | Default Project UUID (used as |
| no (default | Region for Bucket Policy calls when a tool call doesn't specify one. |
| no (default | Truncation limit for tool response text; |
| no (default | Decoded-size ceiling for |
| no (default | Decoded-size ceiling for |
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_keyupdate_api_keycoversdescription/expires_at/default_project_idonly - 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_policyupdate_policycoversname/description/tagsonly. Forrules, use the two tools below -get_policynever 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-replacePUT, no delete+recreate lockout risk)
IAM Users (human identities, issue #4; invite semantics unverified - see gotchas)
scaleway_iam_list_users,scaleway_iam_get_userscaleway_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_groupscaleway_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=falsegroups 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=falsegroupsscaleway_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) -liststructurally 403s for an Application/API-key credential regardless of permissions (see gotchas); implemented per the corrected/jwtspath in caseget/deletefare 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; seedocs/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), anddry_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) andscaleway_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; seedocs/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
NotImplementedfor 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: truereturns 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) andscaleway_s3_remove_bucket_policy_statement(confirm-guarded; refuses unknown Sids and removing the last statement).Temporary grants (#77):
scaleway_s3_grant_temporary_accessmints an Allow statement whose Sid encodes the expiry epoch (tmp-<epoch>-<rand>);scaleway_s3_revoke_expired_grantspreviews (or, with confirm, removes) lapsedtmp-*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_objectsscaleway_s3_copy_objectswitches to a multipart copy (rangedUploadPartCopy, 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 withrclone copy --ignore-existingsemantics, server-side: dry-run by default, skips existing keys, bounded bymax_objectswith 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: trueadds part count/bytes) andscaleway_s3_abort_multipart_upload(confirm-guarded; permanently deletes the uploaded parts).put_object/get_objectcarry binary payloads as base64 (encoding: "base64"); decoded size is capped byMAX_PUT_OBJECT_BYTES/MAX_GET_OBJECT_BYTESrespectively (default 5 MB).get_objectauto-detects UTF-8 text vs. binary and returnsencodingaccordingly; objects over the get ceiling fail fast - usescaleway_s3_generate_presigned_url.scaleway_s3_get_object_tags,scaleway_s3_put_object_tags(putreplaces the whole tag set, same replace-not-merge semantics asput_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
AuditTrailReadOnlyon 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 ishigh); 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 CIAvailable Tools
117 toolsscaleway_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 ruleADestructive
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 jobADestructive
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 overviewARead-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 rulesARead-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 eventsARead-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 eventsARead-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 rulesARead-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 eventsARead-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 jobsARead-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 TrailARead-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 eventsARead-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 rulesADestructiveIdempotent
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 rulesADestructiveIdempotent
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 rulesAIdempotent
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 rulesAIdempotent
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 ruleAIdempotent
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 KeyADestructive
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 ApplicationADestructive
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 GroupADestructive
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 sessionADestructive
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 PolicyADestructive
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 certificateADestructive
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 tokenADestructive
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 KeyADestructive
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 UserADestructive
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 factorADestructive
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 OrganizationADestructive
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 OrganizationADestructive
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 OrganizationADestructive
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 ApplicationARead-onlyIdempotent
Get one IAM Application by id, including its API-key count.
Inputs: application_id (required).
scaleway_iam_get_groupGet a Scaleway IAM GroupARead-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 idARead-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 PolicyARead-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 certificateARead-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 configurationARead-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 configurationARead-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 settingsARead-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 KeyARead-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 UserARead-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 KeysARead-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 ApplicationsARead-onlyIdempotent
List IAM Applications in this Organization, optionally filtered by name substring.
Inputs: name_filter.
scaleway_iam_list_groupsList Scaleway IAM GroupsARead-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)ARead-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 SetsARead-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 PoliciesARead-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 PolicyARead-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 certificatesARead-onlyIdempotent
List certificates registered for SAML SSO validation.
Inputs: saml_id (required).
scaleway_iam_list_scim_tokensList an Organization's SCIM tokensARead-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 KeysARead-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 periodsARead-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 UsersARead-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 UserADestructiveIdempotent
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 GroupADestructive
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 membershipADestructiveIdempotent
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 PolicyADestructiveIdempotent
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 UserAIdempotent
Restore a locked User's access. Reversible counterpart of lock_user.
Inputs: user_id (required).
scaleway_iam_update_api_keyUpdate Scaleway API KeyAIdempotent
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 ApplicationAIdempotent
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 GroupAIdempotent
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 PolicyAIdempotent
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 configurationADestructiveIdempotent
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 settingsADestructiveIdempotent
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 KeyAIdempotent
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 UserBIdempotent
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)ADestructiveIdempotent
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)AIdempotent
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 bucketsAIdempotent
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 bucketADestructive
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 rulesADestructive
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 PolicyADestructiveIdempotent
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 tagsADestructiveIdempotent
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 StorageADestructiveIdempotent
PERMANENTLY delete one object. Requires confirm=true.
Inputs: key (required), bucket (required), confirm (required), region.
scaleway_s3_delete_objectsBatch-delete objects from Scaleway Object StorageADestructiveIdempotent
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)ADestructiveIdempotent
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 objectADestructive
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 rulesARead-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 configARead-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 rulesARead-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 PolicyARead-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 tagsARead-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 stateARead-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)ARead-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 configurationARead-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 StorageARead-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 configurationARead-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 tagsARead-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 contentARead-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 bucketsARead-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 bucketARead-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)AIdempotent
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 configAIdempotent
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)ADestructiveIdempotent
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 PolicyADestructiveIdempotent
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)ADestructiveIdempotent
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)AIdempotent
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 StorageAIdempotent
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 tagsADestructiveIdempotent
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 versioningAIdempotent
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)AIdempotent
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
Scored across 117 tools
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.
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.
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.
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
Related MCP Connectors
Governed MCP gateway: one endpoint for your tools, with credential custody and audit log.
An MCP server for the STRG.com s3-compatible object storage network for all management operations. Full documentation access, ask questions, create buckets, configure scoped access keys, CORS rules, lifecycle policies and perform any S3 operation.
Authenticated MCP server for ClearPolicy policy and compliance workflows.
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceEnables interaction with AWS S3 through MCP, supporting bucket and object management, lifecycle configurations, tagging, policies, CORS settings, presigned URLs, and file uploads/downloads.3MIT
- AlicenseAqualityBmaintenanceOfficial 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.1411Apache 2.0
- AlicenseAqualityBmaintenanceMCP 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.137 npmMIT
- AlicenseAqualityBmaintenanceEnables managing and interacting with any S3-compatible storage endpoint through MCP tools for listing, reading, writing, copying, and deleting buckets and objects.11MIT