fettle-mcp 0.5.4 → 0.6.1

package/README.md

@@ -3,7 +3,7 @@
 **Website:** [fettle.sh](https://fettle.sh) · **MCP docs:** [fettle.sh/docs/mcp](https://fettle.sh/docs/mcp) · **Dashboard:** [dashboard.fettle.sh](https://dashboard.fettle.sh) · **Support:** support@fettle.sh
 
 MCP server for [Fettle](https://fettle.sh) — uptime monitoring you can drive from
-Claude Code, Claude Desktop, Cursor, Windsurf or anything else that speaks the
+Claude Code, Codex, Claude Desktop, Cursor, Windsurf or anything else that speaks the
 [Model Context Protocol](https://modelcontextprotocol.io).
 
 Ask your assistant to create a monitor, look up why one went down, acknowledge an
@@ -39,6 +39,24 @@ Add one entry to your client's config and restart it.
 claude mcp add fettle --env FETTLE_API_KEY=fettle_your_key_here -- npx -y fettle-mcp
 ```
 
+### Codex
+
+```bash
+codex mcp add fettle --env FETTLE_API_KEY=fettle_your_key_here -- npx -y fettle-mcp
+```
+
+Or by hand in `~/.codex/config.toml` (`.codex/config.toml` for one trusted
+project):
+
+```toml
+[mcp_servers.fettle]
+command = "npx"
+args = ["-y", "fettle-mcp"]
+
+[mcp_servers.fettle.env]
+FETTLE_API_KEY = "fettle_your_key_here"
+```
+
 ### Claude Desktop
 
 `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS,
@@ -102,6 +120,8 @@ claude mcp add fettle --env FETTLE_API_KEY=fettle_your_key_here -- npx -y fettle
 
 Every tool carries the MCP hints `readOnlyHint`, `destructiveHint`, `idempotentHint` and `openWorldHint`, so a client can tell reads from changes without parsing names and ask for confirmation only where it matters. Only the five `delete_*` tools are destructive. `preview_maintenance_window` and `check_target` are marked read-only although they need a write-scope key: they change nothing. `check_now` and `check_target` reach the target host, so they are open-world.
 
+Every tool whose result is a JSON object declares an `outputSchema` and returns the result as `structuredContent` as well as text, so a client can read typed fields instead of parsing the text. The four exceptions return the text only: `list_monitors` (its compact rows) and the three tools whose result is a list — `list_active_maintenance`, `preview_maintenance_window` and `list_channels`.
+
 ### Monitors
 
 | Tool                       | Scope | What it does                                                                                  |
@@ -282,6 +302,15 @@ Clients configured through a JSON file take the same two fields:
 }
 ```
 
+Codex takes the remote channel in `~/.codex/config.toml` and reads the key from
+an environment variable, so it never sits in the file:
+
+```toml
+[mcp_servers.fettle]
+url = "https://api.fettle.sh/mcp"
+bearer_token_env_var = "FETTLE_API_KEY"
+```
+
 Use this package when your client speaks only stdio, or when you would rather
 the credential stayed in a local config file than in a client's cloud
 configuration.