API
Riferimento Tool MCP
Opsphere include oltre 310 tool MCP in sola lettura in 28 categorie operative — AWS, Kubernetes, Datadog, Prometheus, Cloudflare, GitHub, GitLab, Bitbucket, SonarQube, PagerDuty, Algolia, Railway e altro ancora. Questa pagina è un riferimento curato dei tool più rilevanti per il lavoro quotidiano sull'infrastruttura. Ogni tool è disponibile in Cursor e nel client web in base al piano del tenant e alle integrazioni.
310+ tool MCP · 28 categorie · panoramica curata in questa pagina
GLOBAL STATUS / OPS
Dashboard operativa multi-piattaforma e strumenti di manutenzione di sistema per visibilità sull'intero tenant.
| Tool | Descrizione | Parametri |
|---|---|---|
ops_status | Dashboard: Synthetics + K8s + deployment Vercel | vercelProjects?: string[], profile?, context?, allContexts?: boolean (default false) |
system_update | git pull per branch + build + riavvio condizionale PM2 | mcpOpsBranch: string, mcpWebChatBranch: string |
ops_incident_rollupPianificato | Correla alert attivi, deployment e picchi di errore in un'unica timeline dell'incidente. | env?: string, hours? (default 6) |
DATADOG
Ricerca log, monitoraggio sintetico, individuazione errori e analisi del traffico WAF tramite API Datadog.
| Tool | Descrizione | Parametri |
|---|---|---|
dd_logs_search | Cerca log in Datadog (Logs v2) | q: string (e.g.: status:error service:edge), from? (e.g.: now-1h), to? |
dd_errors_by_service | Conteggio errori per servizio (API Aggregate, 1 chiamata). Utilizzare come passaggio di discovery PRIMA di dd_errors_recent | hours? (default 1, 1-168), query?, env?, limit? (default 20) |
dd_synthetics_summary | Stato di tutti i test Synthetic | — |
PROMETHEUS
Query PromQL istantanee e per intervallo, alert attivi, stato di salute dei target di scrape, regole, etichette e individuazione serie.
| Tool | Descrizione | Parametri |
|---|---|---|
prom_query | Query PromQL istantanea | query: string, time? (RFC3339 or unix) |
prom_alerts | Elenca gli alert pendenti e attivi | (none) |
prom_targets | Inventario dello stato di salute dei target di scrape | state? (active|dropped|any) |
VERCEL
Cronologia deployment, variabili d'ambiente, stato del progetto e confronto configurazione repository-Vercel.
| Tool | Descrizione | Parametri |
|---|---|---|
vercel_deploys_latest | Ultime distribuzioni | project? (name/ID/alias), projectId?, limit? (default 3, 1-20), teamId? |
vercel_env_list | Variabili d'ambiente. Esempio: {project:"storefront-prod"}. L'ambiente va nel nome/alias del progetto | project: string (DO NOT use projectName nor environment — the env goes in the alias, e.g.: storefront-tst), teamId?, decrypt? (default false) |
vercel_project_status | Riepilogo: variabili d'ambiente + ultimi deployment | project?, teamId?, deployLimit? (default 3), search? |
RAILWAY
Stato dei progetti Railway in sola lettura, deployment, log, metriche e diagnostica incidenti.
| Tool | Descrizione | Parametri |
|---|---|---|
railway_project_status | Riepilogo operativo per un progetto Railway: ambienti, servizi, ultimi deployment, domini/volumi opzionali | project: string (required), environment?, include_domains?, include_volumes?, deployment_limit? |
railway_logs | Log storici per ID di deployment o progetto+ambiente; ambito build, runtime o ambiente; segreti oscurati | project?, environment?, service?, deployment_id?, log_type?, since?, until?, filter?, level?, text?, limit? (max 1000) |
railway_incident_diagnosis | Diagnostica correlata in sola lettura tra deployment, log e metriche; restituisce ipotetiche cause — non cause principali confermate | project: string (required), environment?, service?, since?, symptom?, max_services? |
ARGOCD
Stato di salute delle applicazioni GitOps, stato di sync, inventario dei cluster e diagnostica di connettività tramite CRD Kubernetes.
| Tool | Descrizione | Parametri |
|---|---|---|
argocd_list_apps | Elenca tutte le app ArgoCD con stato di sincronizzazione/salute. Equivalente ad argocd app list | instance? (default: nonprod), contains? (name filter) |
argocd_app_unhealthy | Risorse non Healthy o non Synced per un'app. Restituisce kind, ns, name, status, health, messaggio e suggerimenti di azione | name: string, instance? |
argocd_get_app | CRD completa di un'app: spec (source, destination, syncPolicy) + status (sync, health, risorse, condizioni) | name: string (from catalog whitelist or argocd_list_apps), instance? |
KUBERNETES
Log dei pod, riepiloghi dei cluster, ispezione risorse, cronologia dei rollout e autodiagnostica dalle notifiche ArgoCD.
| Tool | Descrizione | Parametri |
|---|---|---|
k8s_logs | Log dei pod | ns: string, pod: string, container?, tail? (default 200, 1-5000), sinceTime? (ISO 8601), profile?, context? |
k8s_find_pod | Cerca pod per pattern in tutti i namespace | pattern: string, profile?, context? |
k8s_pod_previous_logs | Log del container precedente (--previous). Per CrashLoopBackOff/OOMKilled | ns: string, pod: string, container?, head? (default 100, 10-500), profile?, context? |
AWS
Autenticazione SSO, kubeconfig EKS, ECR, Secrets Manager, CodeArtifact, CloudWatch Logs e query CLI in sola lettura.
| Tool | Descrizione | Parametri |
|---|---|---|
aws_sso_login | Avvia la sessione SSO (browser su desktop; device-code automatico su server headless). Solo account SSO — non IAM-statico | profile: string |
aws_cli_query | Query generica AWS CLI in sola lettura (lambda, rds, s3, cloudfront…). Profilo e regione dal catalogo tenant per l'account attivo | command: string (without the “aws” prefix, only read-only verbs: describe/list/get/scan…), profile? |
aws_cloudwatch_logs_search | Cerca eventi CloudWatch Logs per finestra temporale e pattern di filtro. Restituisce fino a 200 eventi. Supporta tempi relativi (ore) o timestamp ISO 8601 assoluti. | logGroupName: string, hours? (default 1, max 168), startTime? (ISO 8601), endTime? (ISO 8601), filterPattern?, profile?, region? |
AKAMAI
Property Manager, politiche WAF, spurgo cache, regole di reindirizzamento e diagnostica di identità Akamai.
| Tool | Descrizione | Parametri |
|---|---|---|
akamai_cache_purge | Svuota la cache per URL o tag (max 100 oggetti) | section?, accountSwitchKey?, type: 'invalidate'|'delete', scope: 'url'|'tag', objects: string[] |
akamai_properties_search | Cerca per hostname / propertyName / edgeHostname | section?, accountSwitchKey?, hostname?, propertyName?, edgeHostname? |
akamai_diag | Diagnostica dell'identità Akamai | section?, accountSwitchKey? |
CLOUDFLARE
DNS di zona, SSL/TLS, eventi firewall, route Workers, regole di trasformazione, regole WAF personalizzate e audit delle allowlist IP.
| Tool | Descrizione | Parametri |
|---|---|---|
cf_dns_records | Record DNS di una zona | zone: string, type? (A/AAAA/CNAME/MX/TXT/NS), name?, per_page? (default 100) |
cf_workers_scripts_list | Elenca gli script Worker per l'account (inventario e triage dei deployment) | accountId? (uses CLOUDFLARE_ACCOUNT_ID if omitted) |
cf_rules_lists_list | Elenca le Rules List dell'account (IP, hostname, ASN, reindirizzamento) | accountId?, kind? (ip|hostname|asn|redirect), page?, per_page? (default 50) |
NETWORK DIAGNOSTICS
Verifiche certificati DNS, HTTP, TCP, TLS, validazione DNSSEC e individuazione errori Datadog correlati.
| Tool | Descrizione | Parametri |
|---|---|---|
dns_lookup | Risoluzione DNS su molteplici resolver (rileva SERVFAIL/NXDOMAIN) | hostname: string, resolvers? (default [“8.8.8.8”,“1.1.1.1”,“system”]) |
http_check | Richiesta HEAD per verificare se un sito risponde | url: string, timeoutMs? (default 15000) |
alerts_active | Monitor in stato di allarme/avviso in Datadog | source? (default “datadog”), withDowntimes? (default false) |
GITHUB ENTERPRISE
Workflow GitHub Actions, PR, commit, branch, ricerca codice e autodiagnostica dei run falliti.
| Tool | Descrizione | Parametri |
|---|---|---|
ghe_actions_diagnose | Autodiagnostica l'ultimo workflow fallito: trova l'esecuzione fallita, identifica job/step falliti, restituisce i log | owner?, repo: string, workflow?, branch?, tailLines? (default 200, 10-2000) |
ghe_repo_prs | Elenca le PR — filtra per stato: open (predefinito) / closed / all | owner?, repo: string, state? (default open), limit? (default 20) |
ghe_workflow_dispatch | Avvia manualmente un workflow (on: workflow_dispatch) con input opzionali | owner?, repo: string, workflow: string|number, ref? (default main), inputs? |
BITBUCKET
Pull request, pipeline, diff, commit, branch e diagnostica dei passaggi di pipeline falliti.
| Tool | Descrizione | Parametri |
|---|---|---|
bb_pipeline_diagnose | Diagnostica pipeline fallita: identifica lo step fallito e mostra il relativo log | workspace?, repo: string, uuid? (omit = latest failed), branch?, tailLines? (default 200, 10-2000) |
bb_pr_search | Cerca PR per stato/autore/branch | workspace?, repo: string, state? (OPEN/MERGED/DECLINED/SUPERSEDED), author?, sourceBranch?, destBranch?, limit? (default 20) |
bb_pipelines_latest | Ultime esecuzioni di pipeline | workspace?, repo: string, branch?, limit? (default 3) |
GITLAB
Merge request, pipeline GitLab CI/CD, diff, commit, branch, progetti e diagnostica dei job falliti.
| Tool | Descrizione | Parametri |
|---|---|---|
gl_pipeline_diagnose | Diagnostica pipeline fallita: identifica il job fallito e mostra il log di traccia | namespace?, project: string, pipelineId? (omit = latest failed), branch?, tailLines? (default 200, 10-2000) |
gl_mr_search | Cerca merge request per stato, autore e branch | namespace?, project: string, state? (opened|closed|merged|all), author?, sourceBranch?, targetBranch?, limit? (default 20) |
gl_pipelines_latest | Ultime esecuzioni di pipeline per un progetto | namespace?, project: string, branch?, limit? (default 3) |
SONARQUBE
Quality gate, metriche selezionate, problemi, hotspot, branch, analisi e scansioni di pull request per SonarQube Server e SonarCloud.
| Tool | Descrizione | Parametri |
|---|---|---|
sq_quality_gate_status | Stato del quality gate OK/ERROR più condizioni fallite | project: string, branch?, pullRequest? |
sq_measures_summary | Riepilogo curato delle metriche generali e del nuovo codice | project: string, branch?, pullRequest? |
sq_issues_search | Cerca problemi con filtri (incluso il nuovo codice) | project?, severities?, types?, inNewCodePeriod?, branch?, pullRequest?, pageSize? |
AZURE
Login device-code per utente, query CLI Azure in sola lettura, DNS e stato di salute Service Bus con ispezione DLQ.
| Tool | Descrizione | Parametri |
|---|---|---|
azure_cli_query | Query generica az CLI in sola lettura (simile ad aws_cli_query) | command: string (without "az" prefix), azure_tenant_id? |
azure_servicebus_health_overview | Stato di salute di tutti i Service Bus | environment? (dev/tst/pre/prod/all), azure_tenant_id? |
azure_servicebus_message_explorer | Ispeziona i messaggi in code/topic (copre code, topic, DLQ, contenuto dei messaggi) | namespace: string, queueName?, topicName?, subscriptionName?, resourceGroup?, maxMessages? (default 5, 1-20), peekDeadLetters? (default false), azure_tenant_id? |
SENTRY
Tracciamento problemi, dettagli eventi, query Discover, ricerca log e statistiche di progetto.
| Tool | Descrizione | Parametri |
|---|---|---|
sentry_issues_list | Problemi con filtri | orgSlug: string, projectSlug: string, status? (unresolved/resolved/ignored), severity? (fatal/error/warning/info/debug), environment?, assigned?, firstSeen?, lastSeen?, query?, limit? (default 50) |
sentry_event_get | Dettaglio completo di un singolo evento Sentry (stacktrace, breadcrumb, span, contesto runtime). Eventi ≠ problemi | orgSlug: string, projectSlug: string, eventId: string, breadcrumbs? (default true), spans? (default false) |
sentry_issues_search | Ricerca avanzata con ordinamento | orgSlug: string, projectSlug: string, query: string (e.g.: “is:unresolved level:error”), sort? (date/new/freq/priority), limit? (default 50) |
PAGERDUTY
Incidenti, servizi, filtri di urgenza e cronologia incidenti / voci di log RCA.
| Tool | Descrizione | Parametri |
|---|---|---|
pd_incidents_search | Cerca incidenti per stato, urgenza, finestra temporale e servizio/team | status?, urgency?, since?, until?, serviceId?, teamId?, limit? (default 20) |
pd_incident_get | Ottieni il dettaglio dell'incidente per ID | incidentId: string |
pd_incident_log_entries | Elenca le voci di log della timeline / RCA per un incidente | incidentId: string, limit? (default 50) |
ALGOLIA
Stato globale dei cluster (senza credenziali), inventario indici, riproduzione ricerche e log API.
| Tool | Descrizione | Parametri |
|---|---|---|
alg_status | Stato globale del cluster Algolia (nessuna credenziale richiesta) | none |
alg_search | Riproduce una query di ricerca su un indice (hitsPerPage limitato in MCP) | query: string, indexName?, env?, hitsPerPage? |
alg_indices_list | Inventario indici con nome, entrate, dataSize e ultimo build | env? |
JIRA
Consultazione ticket, ricerca JQL, elenchi filtrati, commenti e dettagli completi sui ticket con changelog.
| Tool | Descrizione | Parametri |
|---|---|---|
jira_issue_get | Ticket per chiave | issueKey: string (e.g.: BEC-123), fields? |
jira_issues_search | Cerca con JQL | jql: string (e.g.: “project = BEC AND status = Open”), startAt? (default 0), maxResults? (default 50), fields?, expand? |
jira_issue_fulldetails | Dettagli completi: info + commenti + changelog + worklog + allegati + watcher | issueKey: string, fields? |
CONFLUENCE
Ricerca nella knowledge base e lettura impaginata delle pagine esportate in Markdown.
| Tool | Descrizione | Parametri |
|---|---|---|
confluence_search | Cerca pagine Confluence (testo+titolo CQL) | query: string, spaceKey? (default BEC), limit? (default 10, max 25) |
confluence_page_read | Legge il contenuto della pagina in formato Markdown (con paginazione) | pageId? OR title?, spaceKey?, maxChars? (default 8000), contentOffset? (default 0) |
confluence_spaces_listPianificato | Elenca gli spazi Confluence accessibili all'account di integrazione. | limit? (default 25) |
CONTENTFUL
Spazi, ambienti, tipi di contenuto, entrate e GraphQL in sola lettura per le API di delivery Contentful.
| Tool | Descrizione | Parametri |
|---|---|---|
ctf_entries_search | Interroga le entrate tramite CDA/CPA (filtri, paginazione) | space: string, environment? (default master), contentType?, query?, locale?, limit? (default 10), skip? (default 0), include? (default 1), preview? (default false) |
ctf_entry_get | Recupera una singola entrata con risoluzione opzionale dei link | space: string, environment? (default master), entryId: string, include? (default 1), preview? (default false) |
ctf_environments_list | Elenca gli ambienti e gli alias per uno spazio | space: string (catalog alias or space id), preview? |
PINGDOM
Verifiche di uptime, intervalli di disservizio, risultati delle sonde, stato per sonda e cronologia azioni di alert.
| Tool | Descrizione | Parametri |
|---|---|---|
pingdom_summary | Panoramica globale dell'uptime: conteggio up/down/in pausa + grafico ASCII dei controlli con prestazioni peggiori. Filtra per hostnameContains per un dominio specifico. Prima chiamata per qualsiasi domanda sull'uptime. | topDownLimit? (default 5), hostnameContains?, tags?[], checkIds?[] |
pingdom_check_outages | Elenco degli intervalli di disservizio/sconosciuti con durata e messaggio di errore della causa principale dai risultati della sonda | checkId: number, hours? (default 24, 1-720) |
pingdom_check_uptime | Percentuale di uptime e tempo di risposta medio per un controllo in una finestra temporale | checkId: number, hours? (default 24, 1-720), includeUptime? (default true) |
MEMORY
Memoria operativa per precedenti di incidenti, ADR e contesto di sessione — verificare sempre rispetto all'osservabilità live.
| Tool | Descrizione | Parametri |
|---|---|---|
memory_search | Recupera il blocco di memoria distillata compatta (FTS). Chiamare PRIMA di ripetere l'analisi del repo, il triage dei disservizi o la consultazione ADR. | query: string (min 3), scopes?: enum[] (session|user|repository|incident|decision), repo?: string, environment?: string, limit?: number (default 5, max 10) |
memory_store | Persiste un fatto distillato (riepilogo, non log grezzi). Rifiuta segreti; rifiuta duplicati di cloud_accounts.system_prompt_context a meno che skip_catalog_duplicate_check=true. Limite di 50 salvataggi/utente/giorno. | scope, kind, title, summary, content?, repo?, environment?, session_id?, incident?, decision?, confidence?, visibility?, skip_catalog_duplicate_check? |
memory_session_touch | Associa il repo e aggiorna la sessione di conversazione. Opzionale una volta per sessione di workspace; repo opzionale (desunto dagli argomenti dei tool ghe_/bb_/repos_). | repo?: string (org/name), environment?: string, title?: string, summary_append?: string, external_session_key?: string |
OBSERVABILITY
Digest sullo stato degli ambienti multi-segnale che combinano errori, capacità, deployment e confronti tra ambienti.
| Tool | Descrizione | Parametri |
|---|---|---|
env_health_summary | Stato di salute di un ambiente (errori, pod, latenza, deployment) | env: string (INT/TST/PRE/PRD), hours? (default 24, 1-168) |
observability_daily_digest | Report giornaliero completo di molteplici ambienti | envs: string[] (e.g.: [“INT”,“PRE”,“PRD”]), hours? (default 24) |
observability_query | Query flessibile: confronto errori o dettagli. NON è una query Datadog grezza. Esempio: {type:"errors-comparison", envs:["PRE","PRD"], hours:6} | type: 'errors-comparison'|'single-env-detail', envs: string[], hours? (default 6). Does NOT accept query, from, to |
REPOSITORIES
Ricerca testo tra repository, tracciamento variabili, cataloghi tfvars infra e riepiloghi delle pipeline CI.
| Tool | Descrizione | Parametri |
|---|---|---|
repos_var_where | Dove è definita una variabile (.env/K8s/Helm/Terraform) | name: string (e.g.: API_BASE_URL) |
repos_search_text | Ricerca testuale in tutti i repo. Esempio: {query:"95.100.110"} | query: string (the text to search — DO NOT use text nor search), globs?[], maxResults? (default 50, max 500) |
repo_pipeline_summary | Pipeline CI di un repo (GH Actions/GitLab/CircleCI/Jenkins) | repo: string (name or absolute path) |