Metorial Admin MCP server

Connect Metorial Admin to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Metorial Admin MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list endpoints tool in Metorial Admin
  • Use the list instances tool in Metorial Admin
  • Use the call endpoint tool in Metorial Admin
  • Use the get instance tool in Metorial Admin
  • Use the get account context tool in Metorial Admin
  • Use the delete provider config tool in Metorial Admin

Supported Tools

list_endpoints

List Endpoints

List callable Metorial dashboard instance API endpoints from runtime introspection. Hidden, deprecated, confidential, and non-instance endpoints are excluded.

list_instances

List Instances

DEPRECATED — use `instance_list` instead. List Metorial instances visible to the authenticated actor. This call uses the organization-level instances endpoint and does not send a metorial-instance-id header.

call_endpoint

Call Endpoint

Call a Metorial dashboard instance API endpoint that appears in list_endpoints. The endpoint is revalidated against current introspection before dispatch.

get_instance

Get Instance

DEPRECATED — use `instance_get` instead. Read the metadata of an accessible Metorial instance, including its project, organization, environment type, and timestamps. Call instance_list to discover an instance ID or slug.

get_account_context

Get Account Context

Read the authenticated credential type and its organization, project, instance, actor, and user context when available. Returns identity metadata, without returning the credential itself.

providers_configs_delete

Delete provider config

Permanently deletes a provider config.

providers_configs_get

Get provider config

Retrieves a specific provider config by ID.

providers_deployments_list

List provider deployments

Returns a paginated list of provider deployments.

providers_collections_list

List provider collections

Returns a paginated list of provider collections.

providers_auth_configs_list

List provider auth configs

Returns a paginated list of provider auth configs.

skills_imports_create

Create skill import

Queues a skill import from a repository or uploaded file.

sessions_runs_get

Get provider run

Retrieves a specific provider run by ID.

magic_mcp_endpoints_list

List magic MCP endpoints

Returns a paginated list of magic MCP endpoints.

identity_delegations_create

Create identity delegation

Creates a new identity delegation.

identity_delegation_requests_get

Get identity delegation request

Retrieves a specific identity delegation request by ID.

skills_merge_requests_close

Close skill merge request

Closes an open skill merge request without applying it.

providers_groups_add_listing

Add listing to group

Adds a provider listing to a group.

magic_mcp_endpoints_add_servers

Add servers to magic MCP endpoint

Adds magic MCP servers to a magic MCP endpoint.

magic_mcp_endpoints_remove_servers

Remove servers from magic MCP endpoint

Removes magic MCP servers from a magic MCP endpoint.

sessions_runs_list

List all provider runs

Returns a paginated list of provider runs across all sessions.

skills_items_get

Get skill item

Retrieves a specific skill item.

identity_actors_get

Get identity actor

Retrieves a specific identity actor by ID.

providers_deployments_get

Get provider deployment

Retrieves a specific provider deployment by ID.

sessions_events_get

Get session event

Retrieves a specific event from a session.

sandbox_machines_delete

Terminate sandbox machine

Terminates a machine and deletes its root disk.

magic_mcp_tokens_update

Update magic MCP token

Updates a magic MCP token.

providers_auth_methods_get

Get provider auth method

Retrieves a specific provider auth method by ID.

identity_credentials_update

Update identity credential

Updates the delegation config attached to an identity credential.

identity_agents_list

List agents

Returns a paginated list of agents for the instance.

identity_delegation_configs_delete

Delete identity delegation config

Archives an identity delegation config.

providers_get

Get provider

Retrieves a specific provider by ID.

sessions_templates_providers_create

Create session template provider

Adds a new provider configuration to a session template.

stores_get

Get store by ID

Retrieves a store by its ID.

sandbox_machines_get

Get sandbox machine

Retrieves a machine by ID.

providers_vaults_get

Get provider config vault

Retrieves a specific provider config vault by ID.

providers_tools_get

Get provider tool

Retrieves a specific provider tool by ID.

providers_vaults_list

List provider config vaults

Returns a paginated list of provider config vaults.

providers_vaults_update

Update provider config vault

Updates a specific provider config vault.

sessions_list

List sessions

Returns a paginated list of sessions.

custom_providers_versions_list

List custom provider versions

Returns a paginated list of versions for a custom provider.

magic_mcp_sessions_list

List magic MCP sessions

Returns a paginated list of magic MCP sessions.

skills_templates_delete

Delete skill template

Archives a skill template.

sessions_tool_calls_get

Get tool call

Retrieves a specific tool call by ID.

providers_triggers_list

List provider triggers

Returns a paginated list of provider triggers for a specific provider version.

sessions_get

Get session

Retrieves a specific session by ID.

custom_providers_deployments_get_logs

Get deployment logs

Retrieves the build and deployment logs for a deployment.

providers_publishers_get

Get publisher

Retrieves a specific publisher by ID.

skills_items_create

Create skill item

Creates a new item on a skill.

skills_merge_requests_perform

Perform skill merge request

Queues application of a resolved skill merge request.

skills_templates_update

Update skill template

Updates a skill template.

skills_groups_get

Get skill group

Retrieves a specific skill group.

identity_agents_get

Get agent

Retrieves a specific agent by ID.

skills_plugins_get

Get skill plugin

Retrieves a skill plugin.

magic_mcp_servers_tools

List magic MCP server tools

Returns the effective set of tools available through the providers backing a magic MCP server.

skills_groups_update

Update skill group

Updates a skill group.

sessions_templates_get

Get session template

Retrieves a specific session template by ID.

skills_plugins_archive

Archive skill plugin

Archives a skill plugin.

providers_setup_sessions_create

Create provider setup session

Creates a new provider setup session for OAuth authentication.

identity_delete

Delete identity

Archives an identity.

custom_providers_archive

Archive custom provider

Archives a specific custom provider and disables new connections to it.

custom_providers_versions_get_env

Get custom provider version environment

Retrieves the environment variables for a specific version of a custom provider.

skills_agents_delete

Delete skill agent

Archives a specific skill agent and removes its linked store item.

sessions_templates_update

Update session template

Updates a specific session template.

skills_plugins_update

Update skill plugin

Updates a skill plugin.

files_upload

Upload File

Upload a base64-encoded file to a Metorial instance. Returns the created file, whose ID can be used by skills, sandboxes, chat messages, and file links.

providers_tools_list

List provider tools

Returns a paginated list of provider tools. By default returns tools from the latest version. Use optional filters to get tools for a specific version.

sessions_templates_list

List session templates

Returns a paginated list of session templates.

custom_providers_update

Update custom provider

Updates a specific custom provider.

providers_configs_get_config_schema

Get config schema

Retrieves the JSON Schema for configuration of this provider deployment.

stores_update

Update store by ID

Updates a specific store.

providers_auth_configs_delete

Delete provider auth config

Permanently deletes a provider auth config.

custom_providers_environments_list

List custom provider environments

Returns a paginated list of environments for a custom provider.

skills_agents_list

List skill agents

Returns a paginated list of agents for a specific skill.

identity_credentials_delete

Delete identity credential

Archives an identity credential.

skills_participants_get

Get skill participant by ID

Retrieves a specific participant within a skill.

identity_list

List identities

Returns a paginated list of identities for the instance.

magic_mcp_groups_add_servers

Add servers to magic MCP group

Adds magic MCP servers to a group.

providers_setup_sessions_get

Get provider setup session

Retrieves a specific provider setup session by ID.

sessions_participants_get

Get session participant

Retrieves a specific participant in a session.

skills_imports_list

List skill imports

Returns a paginated list of skill imports.

identity_update

Update identity

Updates mutable fields on an existing identity.

identity_delegation_configs_update

Update identity delegation config

Updates mutable fields on an existing identity delegation config.

skills_merge_requests_create

Create skill merge request

Creates a merge request from one skill into another.

providers_groups_remove_listing

Remove listing from group

Removes a provider listing from a group.

providers_auth_configs_get

Get provider auth config

Retrieves a specific provider auth config by ID.

magic_mcp_tokens_delete

Delete magic MCP token

Deletes a magic MCP token.

sessions_messages_list

List session messages

Returns a paginated list of messages for a session.

stores_items_modify

Modify store items

Applies bulk item operations to a specific store.

providers_versions_get

Get provider version

Retrieves a specific provider version by ID.

skills_create

Create skill

Creates a new skill.

providers_specifications_get

Get provider specification

Retrieves a specific provider specification by ID.

providers_credentials_delete

Delete provider auth credentials

Permanently deletes provider auth credentials.

skills_templates_list

List skill templates

Returns a paginated list of skill templates.

skills_marketplaces_list

List skill marketplaces

Returns a paginated list of skill marketplaces.

identity_get

Get identity

Retrieves a specific identity by ID.

magic_mcp_servers_update

Update magic MCP server

Updates a magic MCP server.

skills_groups_create

Create skill group

Creates a skill group.

providers_triggers_get

Get provider trigger

Retrieves a specific provider trigger by ID.

providers_credentials_list

List provider auth credentials

Returns a paginated list of provider auth credentials.

identity_delegations_revoke

Revoke identity delegation

Revokes an existing identity delegation.

sessions_errors_list

List all session errors

Returns a paginated list of errors across all sessions.

providers_deployments_update

Update provider deployment

Updates a specific provider deployment.

skills_configurations_delete

Delete skill configuration

Soft deletes a specific non-internal skill configuration.

custom_providers_deployments_list

List custom provider deployments

Returns a paginated list of deployments for a custom provider.

providers_groups_get

Get provider group

Retrieves a specific provider group by ID.

stores_list

List stores

Returns a paginated list of stores owned by the instance.

sessions_templates_providers_list

List session template providers

Returns a paginated list of providers configured for a session template.

files_list

List instance files

Returns a paginated list of files owned by the instance.

skills_versions_list

List skill versions

Returns a paginated list of versions for a specific skill.

sessions_connections_get

Get session connection

Retrieves a specific connection from a session.

sandbox_machines_create

Create sandbox machine

Creates a machine and, unless disabled, starts it.

providers_deployments_create

Create provider deployment

Creates a new provider deployment.

skills_participants_list

List skill participants

Returns a paginated list of participants for a specific skill.

sessions_update

Update session

Updates a session.

sessions_create

Create session

Creates a new session with provider deployments.

skills_files_get

Get skill file

Retrieves a single skill file by path. Documents include their text content, other files include a download URL.

sessions_providers_get

Get session provider

Retrieves a specific provider connected to a session.

custom_providers_commits_list

List custom provider commits

Returns a paginated list of commits for a custom provider.

custom_providers_list

List custom providers

Returns a paginated list of custom providers.

sessions_error_groups_list

List all session error groups

Returns a paginated list of error groups across all sessions.

instance_list

List instances

Lists all instances within the organization that the authenticated actor has access to.

skills_exports_create

Create skill export

Creates a skill, plugin, or marketplace export.

sessions_events_list

List session events

Returns a paginated list of events for a session.

sessions_tool_calls_create

Create tool call

Creates a new tool call in a session by invoking a specific tool.

skills_plugins_create

Create skill plugin

Creates a skill plugin.

providers_credentials_get

Get provider auth credentials

Retrieves specific provider auth credentials by ID.

custom_providers_commits_create

Create custom provider commit

Creates a new commit to promote or rollback a version in an environment.

providers_auth_configs_update

Update provider auth config

Updates a specific provider auth config.

magic_mcp_endpoints_update

Update magic MCP endpoint

Updates a magic MCP endpoint.

skills_imports_get

Get skill import

Retrieves an individual skill import and its results.

skills_agents_get

Get skill agent by ID

Retrieves a specific agent within a skill.

skills_marketplaces_create

Create skill marketplace

Creates a skill marketplace.

skills_exports_list

List skill exports

Returns a paginated list of skill exports.

files_delete

Delete file by ID

Deletes a specific file by its ID.

skills_merge_requests_rollback

Rollback skill merge request

Restores the target skill to its state before a completed merge.

providers_groups_create

Create provider group

Creates a new custom provider group.

magic_mcp_servers_providers_update

Update magic MCP server provider

Updates a backing integration provider and then sets the corresponding integration instance provider for a magic MCP server.

identity_delegation_requests_approve

Approve identity delegation request

Approves an existing identity delegation request.

magic_mcp_groups_update

Update magic MCP group

Updates a magic MCP group.

magic_mcp_tokens_add_groups

Add magic MCP groups to token

Adds groups to a magic MCP token.

magic_mcp_servers_providers_delete

Delete magic MCP server provider

Archives a backing integration instance provider from a magic MCP server and removes the shared integration provider when unused.

skills_exports_get

Get skill export

Retrieves a skill export.

stores_create

Create store

Creates a new store for the instance.

identity_credentials_get

Get identity credential

Retrieves a specific identity credential by ID.

magic_mcp_groups_create

Create magic MCP group

Creates a magic MCP group.

custom_providers_deployments_get

Get custom provider deployment

Retrieves a specific deployment.

skills_files_batch

Apply skill file changes

Applies up to 100 put, delete and move changes one after another, in order. Every change is validated before any is applied, but changes are not applied atomically: if a change fails while being applied, the changes before it stay applied. Every change can carry its own if_match precondition.

magic_mcp_servers_providers_get

Get magic MCP server provider

Retrieves a specific backing integration instance provider for a magic MCP server.

sessions_error_groups_get

Get session error group

Retrieves a specific error group by ID across all sessions.

providers_versions_list

List provider versions

Returns a paginated list of provider versions.

skills_agents_update

Update skill agent

Updates the name or description for a specific skill agent.

magic_mcp_sessions_get

Get magic MCP session

Retrieves a specific magic MCP session.

sandbox_machines_exec

Run a command

Runs a shell command in the machine and returns its exit code and output. Non-interactive; starts the machine if needed.

magic_mcp_servers_list

List magic MCP servers

Returns a paginated list of magic MCP servers.

skills_groups_list

List skill groups

Returns a paginated list of skill groups.

skills_groups_delete

Delete skill group

Archives a skill group.

identity_delegation_configs_get

Get identity delegation config

Retrieves a specific identity delegation config by ID.

identity_create

Create identity

Creates a new identity owned by an existing identity actor.

custom_providers_versions_create

Create custom provider version

Creates a new version for a custom provider.

sessions_participants_list

List session participants

Returns a paginated list of participants in a session.

providers_categories_list

List provider categories

Returns a paginated list of provider categories.

identity_delegation_requests_list

List identity delegation requests

Returns a paginated list of identity delegation requests.

magic_mcp_endpoints_delete

Delete magic MCP endpoint

Archives a magic MCP endpoint.

stores_items_get

Get store item by ID

Retrieves a specific item within a store.

sessions_templates_delete

Delete session template

Deletes a specific session template.

identity_delegation_requests_deny

Deny identity delegation request

Denies an existing identity delegation request.

skills_list

List skills

Returns a paginated list of skills.

magic_mcp_groups_remove_servers

Remove servers from magic MCP group

Removes magic MCP servers from a group.

skills_marketplaces_update

Update skill marketplace

Updates a skill marketplace.

skills_configurations_get

Get skill configuration

Retrieves a specific skill configuration by ID, or the default.

custom_providers_create

Create custom provider

Creates a new custom provider.

providers_specifications_list

List provider specifications

Returns a paginated list of provider specifications.

magic_mcp_servers_get

Get magic MCP server

Retrieves a specific magic MCP server.

sessions_templates_providers_update

Update session template provider

Updates a provider configuration in a session template.

providers_groups_update

Update provider group

Updates an existing provider group.

sessions_providers_create

Create session provider

Adds a new provider to an active session.

skills_versions_get

Get skill version by ID

Retrieves a specific skill version by its ID.

sessions_providers_delete

Delete session provider

Removes a provider from a session.

sessions_providers_list

List session providers

Returns a paginated list of providers connected to a session.

identity_actors_delete

Delete identity actor

Archives an identity actor.

identity_delegation_configs_list

List identity delegation configs

Returns a paginated list of identity delegation configs.

skills_items_list

List skill items

Returns a paginated list of items for a skill.

magic_mcp_groups_list

List magic MCP groups

Returns a paginated list of magic MCP groups.

providers_collections_get

Get provider collection

Retrieves a specific provider collection by ID.

sessions_templates_providers_delete

Delete session template provider

Removes a provider configuration from a session template.

providers_vaults_delete

Delete provider config vault

Permanently deletes a provider config vault.

identity_delegation_configs_create

Create identity delegation config

Creates a new identity delegation config.

magic_mcp_servers_providers_create

Create magic MCP server provider

Creates a configurable provider row for a magic MCP server.

magic_mcp_groups_get

Get magic MCP group

Retrieves a specific magic MCP group.

providers_configs_list

List provider configs

Returns a paginated list of provider configs.

skills_files_list

List skill files

Lists every file of a skill with its path, size and etag. Directories are implied by file paths.

magic_mcp_groups_delete

Delete magic MCP group

Deletes a magic MCP group. Fails while the group is the only group of an active magic MCP token, so that deleting a group never widens what a token can access.

stores_delete

Delete store by ID

Deletes a specific store.

sessions_templates_list_tools

List session template tools

Returns the effective set of tools available through the providers in a session template, filtered by the tool filters of each provider, deployment, config, and auth config.

providers_list

List provider listings

Returns a paginated list of provider listings.

skills_merge_requests_get

Get skill merge request

Retrieves a skill merge request.

providers_groups_list

List provider groups

Returns a paginated list of provider groups.

skills_marketplaces_sync

Sync skill marketplace

Forces a skill marketplace sync.

identity_actors_list

List identity actors

Returns a paginated list of identity actors for the instance.

skills_templates_get

Get skill template

Retrieves a specific skill template.

skills_configurations_list

List skill configurations

Returns a paginated list of visible skill configurations.

identity_actors_update

Update identity actor

Updates mutable fields on an existing identity actor.

skills_marketplaces_get

Get skill marketplace

Retrieves a skill marketplace.

sessions_templates_providers_get

Get session template provider

Retrieves a specific provider configuration from a session template.

stores_items_list

List store items

Returns a paginated list of items for a specific store.

providers_setup_sessions_update

Update provider setup session

Updates a specific provider setup session.

skills_get

Get skill

Retrieves a specific skill.

identity_credentials_list

List identity credentials

Returns a paginated list of identity credentials for the instance.

providers_setup_sessions_delete

Delete provider setup session

Deletes a provider setup session.

identity_credentials_create

Create identity credential

Creates a new credential and attaches it to an identity.

skills_files_put

Write skill file

Creates or replaces the file at a path. Parent directories are created automatically.

skills_items_delete

Delete skill item

Archives a skill item.

sessions_connections_list

List session connections

Returns a paginated list of connections for a session.

skills_delete

Delete skill

Archives a specific skill.

identity_delegations_get

Get identity delegation

Retrieves a specific identity delegation by ID.

providers_categories_get

Get provider category

Retrieves a specific provider category by ID.

sessions_runs_get_logs

Get provider run logs

Retrieves the logs for a specific provider run.

magic_mcp_servers_create

Create magic MCP server

Creates a magic MCP server with a new session template. A Subspace session is created automatically on first connection and then reused.

skills_templates_create

Create skill template

Creates a skill template.

skills_update

Update skill

Updates a specific skill.

custom_providers_versions_get

Get custom provider version

Retrieves a specific version of a custom provider.

providers_setup_sessions_list

List provider setup sessions

Returns a paginated list of provider setup sessions.

skills_configurations_update

Update skill configuration

Updates a specific skill configuration. Updating default creates it first if needed.

sessions_providers_update

Update session provider

Updates a provider connected to a session.

sessions_tool_calls_list

List all tool calls

Returns a paginated list of tool calls across all sessions.

identity_actors_create

Create identity actor

Creates a new identity actor.

magic_mcp_endpoints_get

Get magic MCP endpoint

Retrieves a specific magic MCP endpoint.

sessions_messages_get

Get session message

Retrieves a specific message from a session.

magic_mcp_servers_providers_list

List magic MCP server providers

Returns the backing integration instance providers configured for a magic MCP server.

providers_publishers_list

List publishers

Returns a paginated list of publishers.

custom_providers_get

Get custom provider

Retrieves a specific custom provider by ID.

skills_marketplaces_archive

Archive skill marketplace

Archives a skill marketplace.

skills_plugins_list

List skill plugins

Returns a paginated list of skill plugins.

magic_mcp_servers_delete

Delete magic MCP server

Archives a magic MCP server.

magic_mcp_tokens_remove_groups

Remove magic MCP groups from token

Removes groups from a magic MCP token.

skills_agents_create

Create skill agent

Creates a new agent document in the skill agents directory.

magic_mcp_endpoints_create

Create magic MCP endpoint

Creates a magic MCP endpoint.

instance_get

Get instance details

Retrieves metadata and configuration details for a specific instance.

skills_configurations_create

Create skill configuration

Creates a new non-default skill configuration.

skills_merge_requests_list

List skill merge requests

Returns a paginated list of skill merge requests.

skills_files_delete

Delete skill file

Deletes the file at a path. Directories that were created automatically and become empty are removed. The root SKILL.md cannot be deleted.

sessions_templates_create

Create session template

Creates a new session template.

providers_configs_update

Update provider config

Updates a specific provider config.

skills_files_move

Move skill file

Moves or renames a file. The root SKILL.md cannot be moved.

custom_providers_commits_get

Get custom provider commit

Retrieves a specific commit.

files_get

Get file by ID

Retrieves details for a specific file by its ID.

identity_delegations_list

List identity delegations

Returns a paginated list of identity delegations for the instance.

providers_auth_methods_list

List provider auth methods

Returns a paginated list of provider auth methods.

identity_delegation_requests_create

Create identity delegation request

Creates a new identity delegation request.

sessions_errors_get

Get session error

Retrieves a specific error that occurred in a session.

custom_providers_environments_get

Get custom provider environment

Retrieves a specific environment.

sandbox_disks_clone

Clone sandbox disk

Creates a copy of a disk in the same region.

portals_update

Update portal

Updates an existing portal for the instance.

sandbox_disks_resize

Resize sandbox disk

Starts growing a disk to a larger size.

portals_invites_get

Get portal consumer invite

Retrieves a portal consumer invite by ID.

portals_groups_delete

Delete portal consumer group

Archives a consumer group for the portal.

network_firewalls_list

List firewalls

Returns a paginated list of firewalls.

sandbox_machines_instances_logs

Get machine instance logs

Returns a page of the console output of an instance.

events_listeners_create

Create event destination listener

Subscribes an event destination to events for this instance — generic resource events, a callback's trigger events, or a chat connection's events.

outposts_delete

Delete outpost

Delete a disabled outpost owned by this organization

monitoring_protoguard_list

List ProtoGuard alerts

Returns a paginated list of ProtoGuard alerts for this instance.

sandbox_machines_pause

Pause sandbox machine

Pauses a running machine and keeps its memory state.

chat_workspaces_get

Get chat workspace

Retrieves a specific chat workspace.

sandbox_images_create

Create sandbox image

Creates an empty image. Build a version of it to make it available to machines.

sandbox_machines_errors_get

Get machine error

Retrieves an error reported by a machine.

consumers_create

Create consumer

Creates or links a consumer for an instance.

chat_instances_create

Create chat instance

Creates a new chat instance for a chat connection.

network_firewalls_create

Create firewall

Creates a new firewall.

sandbox_image_builds_get

Get image build

Retrieves an image build by ID.

network_firewall_assignments_create

Create integration firewall assignment

Creates an assignment that applies a firewall to a target.

chat_instances_get

Get chat instance

Retrieves a specific chat instance.

portals_access_create

Create portal access

Creates a new consumer access rule for the portal.

portals_get

Get portal

Retrieves details for a specific portal.

portals_access_delete

Delete portal access

Deletes a consumer access rule from the portal.

integrations_setup_sessions_create

Create integration setup session

Creates a new integration setup session. Creates a draft integration instance unless integration_instance_id is given, in which case that instance is reused and its config and auth config are overwritten on completion.

portals_create

Create portal

Creates a new portal for the instance.

callbacks_get

Get callback

Retrieves a specific callback by ID.

events_destinations_create

Create event destination

Create an event destination for the organization

sandbox_images_builds_list

List image builds

Returns a paginated list of the builds of an image.

integrations_instances_create_template

Create integration instance session template

Creates or updates the shared session template for a specific integration instance.

chat_instances_update

Update chat instance

Updates a specific chat instance.

callbacks_list

List callbacks

Returns a paginated list of callbacks.

monitoring_alerts_list

List monitor alerts

Returns a paginated list of monitor alerts for this instance.

chat_connections_create

Create chat connection

Creates a new chat connection, together with the single provider it is linked to.

monitoring_monitors_list

List monitors

Returns a paginated list of monitors for this instance.

integrations_instances_list

List integration instances

Returns a paginated list of integration instances.

sandbox_images_get

Get sandbox image

Retrieves an image by ID.

network_internet_gateway_get

Get integration internet gateway

Retrieves the integration internet gateway of the instance, including its public IPs.

integrations_instances_delete

Delete integration instance

Archives a specific integration instance.

sandbox_regions_get

Get sandbox region

Retrieves a sandbox region by its identifier.

network_firewall_assignments_delete

Delete integration firewall assignment

Deletes an integration firewall assignment.

monitoring_alerts_unresolve

Unresolve monitor alert

Reopens a resolved monitor alert.

sandbox_machines_events_get

Get machine event

Retrieves an event of a machine.

monitoring_alerts_viewed

Mark monitor alert viewed

Marks a monitor alert as viewed by the current actor.

events_get

Get event

Get a specific event recorded for the organization

portals_invites_create

Create portal consumer invite

Invites a consumer to a portal.

sandbox_machines_operations_list

List machine operations

Returns a paginated list of the operations of a machine.

sandbox_specs_get

Get sandbox spec

Retrieves a machine spec by ID.

integrations_setup_sessions_list

List integration setup sessions

Returns a paginated list of integration setup sessions.

network_firewalls_get

Get firewall

Retrieves a specific firewall by ID.

consumers_surfaces_get

Get consumer surface

Retrieves a consumer surface by ID.

outposts_enable

Enable outpost

Enable a disabled outpost owned by this organization

sandbox_disks_delete

Delete sandbox disk

Deletes a disk. Root filesystem disks cannot be deleted; they are removed with their machine.

sandbox_machines_start

Start sandbox machine

Starts a paused or hibernated machine.

sandbox_machines_instances_list

List machine instances

Returns a paginated list of the instances of a machine.

events_destinations_update

Update event destination

Update an event destination configured for the organization

chat_workspaces_list

List chat workspaces

Returns a paginated list of workspaces for a chat instance.

portals_groups_create

Create portal consumer group

Creates a new consumer group for the portal.

monitoring_monitors_get

Get monitor

Retrieves a monitor by ID.

network_policies_create

Create network policy

Creates a new network policy.

sandbox_machines_update

Update sandbox machine

Updates a machine. Changes to its size, runtime, or mounts take effect once the machine restarts, which happens on its own for a running machine, and the machine reports restart_required until then.

monitoring_protoguard_get

Get ProtoGuard alert

Retrieves a ProtoGuard alert by ID.

sandbox_images_versions_list

List image versions

Returns a paginated list of the versions of an image.

sandbox_disks_resizes_list

List disk resizes

Returns a paginated list of the resizes of a disk.

integrations_instances_update

Update integration instance

Updates a specific integration instance.

sandbox_machines_instances_get

Get machine instance

Retrieves an instance of a machine.

outposts_credentials_get

Get outpost credential

Get a credential for an outpost owned by this organization

sandbox_images_builds_create

Build image

Builds a new version of an image from a Dockerfile. Upload the build context as a file with the sandbox_image_build_context purpose first.

sandbox_machines_touch

Touch sandbox machine

Records activity so the machine is not paused for being idle.

callbacks_events_get

Get callback event

Retrieves a specific callback event by ID, enriched with the payload the provider produced for it and, if it came from a webhook, the inbound request behind it.

portals_access_list

List portal access

Returns a paginated list of consumer access rules for a portal.

chat_events_get

Get chat event

Retrieves a specific chat event.

sandbox_disks_get

Get sandbox disk

Retrieves a disk by ID.

events_destinations_rotate_webhook_secret

Rotate event destination webhook secret

Generates a new signing secret for this event destination's webhook, invalidating the previous one. The new secret is only returned in this response.

events_destinations_ping

Ping event destination

Sends a test delivery to this event destination immediately, regardless of its listeners. The ping goes through the normal delivery/retry pipeline and shows up in delivery history.

integrations_instances_create_session

Create integration instance session

Creates a session from the shared session template of a specific integration instance.

network_enclaves_list

List integration enclaves

Returns a paginated list of integration enclaves.

sandbox_image_builds_list

List image builds

Returns a paginated list of image builds across all images.

sandbox_images_update

Update sandbox image

Updates the name and metadata of one of your images.

sandbox_machines_access_files

Create files access

Creates a short-lived token for the machine's file service.

network_firewall_assignments_list

List integration firewall assignments

Returns a paginated list of integration firewall assignments.

outposts_access_set

Set outpost access

Replace this organization's access grants on an outpost with the given list of instance/service grants

portals_access_update

Update portal access

Updates the shared listing fields for a portal access rule.

consumers_surfaces_list

List consumer surfaces

Returns a paginated list of consumer surfaces for an instance.

sandbox_specs_list

List sandbox specs

Returns a paginated list of machine specs. The available field shows whether your plan allows creating machines of that size.

sandbox_disks_list

List sandbox disks

Returns a paginated list of disks.

monitoring_alerts_resolve

Resolve monitor alert

Marks a monitor alert as resolved.

chat_events_list

List chat events

Returns a paginated list of chat events.

network_policies_update

Update network policy

Updates a network policy definition.

sandbox_disks_create

Create sandbox disk

Creates an empty disk.

portals_groups_list

List portal consumer groups

Returns a paginated list of consumer groups for a portal.

sandbox_machines_events_list

List machine events

Returns a paginated list of the events of a machine.

sandbox_machines_usage

List sandbox machine usage

Returns resource usage samples of a machine, newest first.

integrations_instances_create

Create integration instance

Creates a new integration instance.

network_policies_get

Get network policy

Retrieves a specific network policy by ID.

integrations_providers_create

Create integration provider

Creates a new integration provider.

events_destinations_get

Get event destination

Get a specific event destination configured for the organization

network_enclaves_get

Get integration enclave

Retrieves a specific integration enclave by ID.

network_firewalls_update

Update firewall

Updates a firewall definition.

integrations_providers_list

List integration providers

Returns a paginated list of integration providers.

sandbox_machines_list

List sandbox machines

Returns a paginated list of machines.

sandbox_images_delete

Delete sandbox image

Deletes one of your images and cancels its running builds.

portals_invites_list

List portal consumer invites

Returns a paginated list of invites for a portal.

network_policies_list

List network policies

Returns a paginated list of network policies.

consumers_update

Update consumer

Updates a consumer for an instance.

sandbox_disks_resizes_retry

Retry disk resize

Retries a resize that failed.

sandbox_regions_list

List sandbox regions

Returns a paginated list of regions sandboxes can run in.

outposts_credentials_disable

Disable outpost credential

Disable a credential for an outpost owned by this organization. A credential must be disabled before it can be deleted.

sandbox_disks_update

Update sandbox disk

Updates a disk name and metadata. Only metadata can be updated for root filesystem disks.

callbacks_delete

Delete callback

Disables callbacks on the underlying integration provider, tearing down this callback and every callback instance registered for it.

sandbox_machines_usage_history_summary

Get sandbox machine usage summary

Returns totals and averages for a range. Summary bounds align independently to minute or hour source buckets. Use a timeline’s effective bounds to compare its totals with a summary.

portals_access_get

Get portal access

Retrieves a portal access rule by ID.

outposts_access_list

List outpost access

List the access grants on an outpost, optionally filtered by organization or instance

consumers_list

List consumers

Returns a paginated list of consumers for an instance.

network_firewalls_delete

Delete firewall

Archives a firewall.

chat_connections_get

Get chat connection

Retrieves a specific chat connection.

network_policies_delete

Delete network policy

Archives a network policy.

chat_connections_delete

Delete chat connection

Archives a specific chat connection.

sandbox_machines_operations_get

Get machine operation

Retrieves an operation of a machine.

integrations_create

Create integration

Creates a new integration.

chat_connections_update

Update chat connection

Updates a specific chat connection.

sandbox_disks_mounts_list

List disk mounts

Returns a paginated list of the times a disk was mounted into a machine.

callbacks_events_list

List callback events

Returns a paginated list of callback events.

integrations_providers_get

Get integration provider

Retrieves a specific integration provider.

callbacks_update

Update callback

Updates the name, description, metadata or trigger group selections of a callback. Changing the selections re-registers the affected triggers. Everything else about a callback is derived from its integration provider - set `callbacks.status` to `disabled` there to tear it down.

sandbox_images_list

List sandbox images

Returns a paginated list of the images you can create machines from.

events_listeners_delete

Delete event destination listener

Removes an event destination listener.

sandbox_disks_resizes_get

Get disk resize

Retrieves a resize of a disk.

integrations_providers_delete

Delete integration provider

Archives a specific integration provider.

events_listeners_list

List event destination listeners

Returns a paginated list of event destination listeners for the organization.

network_internet_gateway_list_network_logs

List integration internet gateway network logs

Returns ingress or egress network logs for integration enclaves in the instance environment.

integrations_setup_sessions_get

Get integration setup session

Retrieves a specific integration setup session.

events_destinations_list

List event destinations

List all event destinations configured for the organization

callbacks_create

Create callback

Enables callbacks for an integration provider and returns the callback it created. Only providers whose type reports `triggers.status` as `enabled` support this. Callback instances are then registered for every matching integration instance in the background.

sandbox_images_versions_get

Get image version

Retrieves a version of an image.

outposts_credentials_list

List outpost credentials

List the credentials for an outpost owned by this organization

callbacks_instances_get

Get callback instance

Retrieves a specific callback instance by ID.

sandbox_machines_usage_history_timeline

Get sandbox machine usage timeline

Returns chronological usage buckets. Minute data is retained for 7 days and hourly data for 30 days. Zero samples means no observations, not necessarily a stopped machine.

api_keys_get

Get API key

Get the information of a specific API key

outposts_credentials_delete

Delete outpost credential

Delete a disabled credential for an outpost owned by this organization

callbacks_instances_list

List callback instances

Returns a paginated list of callback instances.

sandbox_machines_hibernate

Hibernate sandbox machine

Hibernates a machine so it stops consuming compute resources.

api_keys_list

Get user

Get the current user information

sandbox_machines_restart

Restart sandbox machine

Restarts a machine on a fresh instance.

sandbox_image_builds_cancel

Cancel image build

Cancels a build that is still running.

integrations_list

List integrations

Returns a paginated list of integrations.

portals_list

List portals

Returns a paginated list of portals.

sandbox_machines_access_ports

Create port access

Creates a short-lived token for reaching ports inside the machine.

outposts_disable

Disable outpost

Disable an outpost owned by this organization. An outpost must be disabled before it can be deleted.

portals_groups_update

Update portal consumer group

Updates a consumer group for the portal.

outposts_get

Get outpost

Get any outpost in the organization's account family

outposts_update

Update outpost

Update the information of an outpost owned by this organization

integrations_get

Get integration

Retrieves a specific integration.

outposts_create

Create outpost

Create a new outpost owned by this organization

outposts_list

List outposts

List every outpost in the organization's account family

chat_instances_list

List chat instances

Returns a paginated list of chat instances.

chat_instances_delete

Delete chat instance

Archives a specific chat instance.

consumers_get

Get consumer

Retrieves a consumer by ID.

events_destinations_archive

Archive event destination

Archives an event destination. Listeners pointed at it stop being delivered to.

sandbox_image_builds_logs

Get image build logs

Returns a page of the build output.

integrations_providers_update

Update integration provider

Updates a specific integration provider.

sandbox_machines_access_shell

Create shell access

Creates a short-lived token for an interactive shell in the machine.

chat_connections_list

List chat connections

Returns a paginated list of chat connections.

portals_groups_get

Get portal consumer group

Retrieves a portal consumer group by ID.

integrations_update

Update integration

Updates a specific integration.

events_listeners_get

Get event destination listener

Retrieves a specific event destination listener by ID.

integrations_instances_get

Get integration instance

Retrieves a specific integration instance.

sandbox_machines_errors_list

List machine errors

Returns a paginated list of the errors reported by a machine.

events_list

List events

List events recorded for the organization

monitoring_alerts_get

Get monitor alert

Retrieves a monitor alert by ID.

network_firewall_assignments_get

Get integration firewall assignment

Retrieves a specific integration firewall assignment by ID.

audit_logs_list

List organization audit logs

List audit logs recorded for the organization

chat_commands_respond

Respond to chat command

Replies to a slash command from a chat.command.invoked event, using the provider's native command response.

events_deliveries_get

Get event delivery

Get a specific event delivery recorded for the organization

chat_messages_read

Mark chat message read

Marks a specific chat message as read.

chat_messages_get

Get chat message

Retrieves a specific chat message.

chat_channels_members_list

List chat channel members

Returns a paginated list of members of a chat channel.

chat_threads_get

Get chat thread

Retrieves a specific chat thread.

chat_chats_list

List chats

Returns a paginated list of chats.

chat_instances_provider_set

Set chat instance provider

Creates or updates the single provider for a chat instance.

chat_channels_members_get

Get chat channel member

Retrieves a specific member of a chat channel.

chat_messages_delete

Delete chat message

Deletes a specific chat message.

events_deliveries_list

List event deliveries

List event deliveries recorded for the organization

chat_messages_reactions_list

List chat message reactions

Returns the reactions left on a specific chat message.

audit_logs_get

Get organization audit log

Get a specific audit log recorded for the organization

chat_messages_update

Edit chat message

Edits a specific chat message.

chat_messages_reactions_delete

Remove chat message reaction

Removes a reaction from a specific chat message.

events_delivery_attempts_get

Get event delivery attempt

Get a specific delivery attempt, including the request Metorial sent and the response the destination returned

chat_channels_list

List chat channels

Returns a paginated list of channels for a chat.

events_delivery_attempts_list

List event delivery attempts

List delivery attempts recorded for the organization

chat_instances_sync

Sync chat instance

Triggers a sync of the workspaces available on this chat instance.

chat_channels_typing_start

Start chat typing indicator

Shows a typing indicator in a chat channel.

chat_messages_create

Send chat message

Sends a new message to a chat channel.

chat_instances_provider_authenticated_user

Get chat instance authenticated user

Retrieves the chat provider account this chat instance is authenticated as.

chat_instances_provider_get

Get chat instance provider

Retrieves the single provider configured for a chat instance.

events_deliveries_retry

Retry event delivery

Schedules another attempt for a delivery that has finished, whether it succeeded or gave up. The delivery is given a fresh attempt budget.

chat_dms_open

Open chat DM

Opens (or retrieves) a direct message channel with one or more users.

chat_messages_list

List chat messages

Returns a paginated list of messages in a chat channel.

chat_threads_list

List chat threads

Returns a paginated list of threads in a chat channel.

chat_messages_reactions_create

Add chat message reaction

Adds a reaction to a specific chat message.

chat_chats_get

Get chat

Retrieves a specific chat.

chat_channels_get

Get chat channel

Retrieves a specific chat channel.

Connect Metorial Admin to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Metorial Admin in Metorial. In your Metorial portal, enable the Metorial Admin MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Metorial Admin tools.

Run Metorial Admin through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Metorial Admin and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Metorial Admin tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Metorial Admin

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

Metorial Search

Search the web and fetch readable content from selected pages. Built for fast discovery and content extraction.

Google Sheets

Create, read, and update spreadsheets and their cell data. Read and write values to individual cells, ranges, or multiple ranges using A1 notation or named ranges. Apply cell formatting including text styles, backgrounds, borders, number formats, and conditional formatting. Manage sheets (tabs) within a spreadsheet—add, delete, copy, rename, and reorder them. Create and manage embedded charts, pivot tables, filter views, data validation rules, protected ranges, named ranges, and merged cells. Perform batch operations to apply multiple updates atomically.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Slack

Slack: connect with bot OAuth or user OAuth to work with messages, conversations, search, files, Canvases, Lists, profiles, reactions, reminders, and workspace productivity settings.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Technical notes for Metorial Admin

Administer Metorial instances with one tool per admin API operation: providers, sessions, skills, files, sandboxes, Magic MCP, portals, integrations, API keys, and more, plus endpoint discovery and validated dynamic calls using OAuth or API key authentication.

Frequently asked questions

Common questions about connecting Metorial Admin to AI agents with Metorial.

  1. How many tools does the Metorial Admin MCP server have?
    The Metorial Admin MCP server exposes 456 tools, including List Endpoints, List Instances, Call Endpoint. Each one is governed and traced through Metorial.
  2. Metorial Admin exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Metorial Admin MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Metorial Admin and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Metorial Admin MCP server yourself or use the hosted gateway.

Connect Metorial Admin to production AI agents

See how Metorial gives your team governed access to Metorial Admin, with tracing and security controls built in.