diff --git a/README.md b/README.md
index 1dc57e0..418e66e 100644
--- a/README.md
+++ b/README.md
@@ -71,6 +71,8 @@ Ask Claude things like:
 - "List all NuGet packages for myorg"
 - "What are the package defaults for myorg?"
 - "List all repos for myorg"
+- "List open issues for gitcaddy/server"
+- "Show me issue #42 in myorg/myrepo"
 
 ## Available Tools
 
@@ -104,6 +106,14 @@ Ask Claude things like:
 | `list_artifacts` | List artifacts from a workflow run |
 | `get_artifact_download_url` | Get the download URL for a specific artifact |
 
+### Repository & Issue Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_repos` | List repositories for an owner (org or user) |
+| `list_issues` | List issues for a repository with pagination and state filtering |
+| `get_issue` | Get issue details including body content and comments |
+
 ### Release & Package Tools
 
 | Tool | Description |