Skip to content
Agents tracked: 501 Releases (7d): 777 Agent status: no reported issuesSince last limit reset: Claude 10d · Codex 8d For AI agents: Markdown Updated Nov 21, 2026
Recipe Results as reported by Anthropic

Build a CI-health monitoring agent with the Claude Agent SDK and GitHub MCP

In this Anthropic cookbook notebook, an agent gets the official GitHub MCP server and is told to look over recent CI runs. It reports failing jobs, flaky patterns and recommended actions ranked by priority.

The problem

On-call engineers spend time digging through workflow runs to figure out what broke and how serious it is. An agent limited to read-oriented GitHub tools can do that first investigation for them.

Steps

  1. Create a fine-grained GitHub personal access token and save it as GITHUB_TOKEN in .env.
  2. Install and start Docker Desktop. The GitHub MCP server runs in a container.
  3. Add the server to the mcp_servers config of ClaudeSDKClient, using a docker command with ghcr.io/github/github-mcp-server.
  4. Set allowed_tools to mcp__github and disallow Bash, WebSearch and WebFetch.
  5. Send the CI-health prompt and stream the reply with an async loop.

From the official docs

"Analyze the CI health for facebook/react repository. Examine the most recent runs of the 'CI' workflow and provide: ..."

Results as reported by Anthropic

  • A status summary of recent CI runs and what triggered them.
  • The failing jobs or tests with a severity assessment, plus notes on long or flaky runs.
  • Recommended actions labeled critical, high, medium or low.
  • The GitHub MCP server gives the agent over 100 tools across issues, pull requests, CI/CD and security alerts.

These figures are as reported by Anthropic in Claude Cookbook ↗ (Sep 12, 2025). Anthropic sells the product used here. AgentGid did not measure or independently verify them.

Takeaway. Give a monitoring agent only the tools it needs so it stays on task.
AgentGid's take

This suits a small team with Python and Docker experience that wants a first-pass CI triage for on-call engineers, since setup needs a fine-grained GitHub token and a running Docker container. The SDK is free, but usage is billed through the Claude API or a subscription, so check costs before pointing it at busy repos. LangGraph (Free (OSS)) is an alternative if you'd rather not tie the build to Claude.

The agent used here

Similar use cases

Guides