MCP tools reference
The tools the emma MCP server exposes to your AI client — what each does, its parameters, and whether it needs confirmation.
The emma MCP server exposes your infrastructure to any MCP-compatible AI client (Claude Desktop, Cursor, your own agent) as a set of tools. This page lists them by category.
Set up the server first — see Connect the MCP server. All tools are scoped to the emma account whose token you configured.
Resources
list_resources
Lists the resources in your account, optionally filtered by type, provider, or region.
| Parameter | Type | Required | Description |
|---|---|---|---|
type | string | no | Filter by resource type (vm, volume, k8s, …) |
provider | string | no | Filter by cloud provider |
region | string | no | Filter by region |
Effects: read-only. Example: list_resources(type: "vm", region: "eu-central")
get_resource
Returns the full detail of a single resource by id.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | The resource id |
Effects: read-only.
Cost
get_cost
Returns cost figures for the account, a provider, or a single resource over a time window.
| Parameter | Type | Required | Description |
|---|---|---|---|
scope | string | no | account (default), provider, or resource |
id | string | conditional | Required when scope is provider or resource |
period | string | no | e.g. last_30d (default), mtd |
Effects: read-only.
Security
get_security_findings
Returns open security findings (exposed ports, permissive rules, unencrypted volumes).
| Parameter | Type | Required | Description |
|---|---|---|---|
severity | string | no | Minimum severity: low / medium / high |
Effects: read-only.
Global options
Every tool accepts these:
| Option | Description |
|---|---|
--token | The emma access token (or set EMMA_TOKEN) — scopes every call to your account |
--format | json (default) or text |
These read tools never mutate infrastructure. Write actions (create/resize/delete) are not exposed over MCP without a confirmation flow — see Safety & confirmations.
See also
Last updated on 17 Jul 2026