Tools and examples
What you can access
After OAuth, the client can query the following, depending on the access you approve:
- connected account and organization context;
- authorized project list, with type and status filters;
- details for one authorized project;
- current project metrics when available;
- authorized project builds, deployments, and logs;
- application health, instances, network analytics, and auto-scaling;
- Valkey project status;
- the organization's Storage, its buckets, and the folders and files in each bucket, without file contents or access keys;
- metadata for authorized AI models and keys, without credentials;
- AI usage for a rolling period;
- project measurement and billing information;
- organization transactions when financial access is authorized separately;
- ready-made summaries in a single query: the latest failed build, a text search in logs, the incidents of a recent window, and an overview of the organization's projects.
The MCP server publishes concise tool names:
| Tool | Purpose |
|---|---|
get_context | Read the connected account and organization context. |
list_projects | List authorized projects. |
get_project | Read one authorized project. |
get_project_metrics | Read current project metrics. |
list_builds | List project build metadata. |
get_project_logs | Read recent, bounded application logs. |
get_build_logs | Read paginated logs for one build. |
list_deployments | List deployments recorded in the current month. |
get_project_health | Read health check availability and configuration. |
list_healthcheck_failures | List recent health check failures. |
get_project_network | Read network summaries, routes, responses, and events. |
get_project_autoscaling | Read the current auto-scaling configuration. |
list_autoscaling_events | List recent capacity increase or reduction events. |
list_project_instances | List public instance identifiers. |
get_valkey_status | Read public status and configuration for a Valkey project. |
get_object_storage | Check whether the organization can use Storage and, when it was selected for the connection, its name, status, region, and address. Never returns access keys. |
list_object_storage_buckets | List the buckets of the authorized Storage, with size, file count, and dates. |
list_object_storage_objects | List one folder level of a bucket: subfolders and files with size and upload time. Never returns file contents or download links. |
list_ai_keys | List authorized AI key metadata without credentials. |
get_ai_usage | Read observed AI usage. |
get_project_billing | Read project measurements or ledger entries. |
list_transactions | List authorized organization transactions. |
get_latest_build_failure | Find an application's latest failed build and show the end of its log. |
search_project_logs | Search an application's recent logs for a text. |
get_project_incidents | Summarize 5xx responses, failing routes, health check failures, and auto-scaling events for a recent window. |
get_organization_overview | Summarize authorized projects by status and type and highlight the failing ones. |
Clients may display a server namespace before these names. With a server named zenifra, for example, get_context may appear as zenifra_get_context. Do not add zenifra_ to the MCP tool name itself.
Financial data requires separate consent during authorization. Lack of financial access does not prevent permitted project and metric queries.
Example prompts
After verifying the connection, try queries such as:
Which organization is connected?List the projects I can query.Show the current metrics for the authorized project I name.List recent builds for the selected project and show the logs for the build I specify.Check this project's health, instances, and auto-scaling events.Show a network summary for the last hour and recent health check failures.Show my available AI usage period and authorized transactions.Why did the latest build of this project fail?Search this application's recent logs for "timeout".What went wrong in this application in the last hour?Are any of my projects failing?The client should answer only with data covered by the connection's consent.
Last updated on