# Nous-approved MCP catalog entry.
# Presence in this directory = approval. Merged via PR review.
manifest_version: 1

name: betterstack
description: 'Better Stack: logs, uptime monitors, incidents, and status pages.'
source: https://betterstack.com/docs/getting-started/integrations/mcp/

# Official vendor-hosted remote MCP (URL-only — Hermes never spawns a local
# process for this entry). Native OAuth 2.1 + Dynamic Client Registration
# (verified live: RFC 9728 protected-resource metadata -> AS metadata with
# registration_endpoint); Hermes's MCP client + mcp_oauth_manager handle
# discovery, PKCE, token exchange, and refresh.
transport:
  type: http
  url: https://mcp.betterstack.com

auth:
  type: oauth

# Curated exclude list (~106-tool surface). Excluded: vendor-docs search;
# the instruction-fetcher pseudo-tools (static how-to text as tools);
# Execute query / Create cloud connection (raw ClickHouse-SQL escape hatch +
# direct-DB credential minting); team-membership management (account access
# changes). NOTE: Better Stack's docs list display labels while the wire
# uses snake_case (their own header examples show `remove_dashboard`); the
# server is OAuth-gated so names could not be enumerated pre-auth. Entries
# below cover BOTH shapes — glob patterns for the snake_case wire names plus
# the display-label literals; unmatched entries no-op harmlessly.
# ~85+ product tools stay enabled; re-check with
# `hermes mcp configure betterstack` after first login.
tools:
  default_excluded:
    - search_documentation
    - Search documentation
    - "*instructions*"
    - execute_query
    - Execute query
    - create_cloud_connection
    - Create cloud connection
    - "*team_member*"
    - "*team member*"

# Composer-suggestion triggers (desktop brand pills).
suggest:
  keywords:
    - better stack
    - betterstack
    - uptime monitor
  hosts:
    - betterstack.com

post_install: |
  On first connection Hermes opens a browser to authorize with
  Better Stack (or run `hermes mcp login betterstack`). Approve access,
  then restart the session so tools load.

  Heads-up: this server exposes a LARGE tool surface (~106 tools as of
  Aug 2026). Hermes applies a curated exclude list automatically at install
  (docs search, instruction pseudo-tools, the raw-SQL query hatch, cloud
  credential minting, and team-membership tools); everything else stays
  enabled. Review or change the selection any time with:
    hermes mcp configure betterstack