docs: update github agent

Author: cristipufu

README.md

@@ -31,8 +31,8 @@ UIPATH_ACCESS_TOKEN=YOUR_TOKEN_HERE
 
 ### Servers Definition
 
+Create the `mcp.json` file:
 ```json
-// mcp.json
 {
   "servers": {
     "my-python-server": {

docs/how_to_pack_binary.md

@@ -1,6 +1,6 @@
-# How to pack and publish the official GitHub MCP Server
+# How to pack and publish the GitHub MCP Server
 
-This guide walks you through manually packaging and publishing the GitHub MCP server to UiPath Orchestrator. An [example GitHub Actions workflow](/.github/workflows/build-github-mcp-server.yml) is provided to automate these steps.
+This guide walks you through manually packaging and publishing the official [GitHub MCP server](https://github.com/github/github-mcp-server) to UiPath Orchestrator. An [example GitHub Actions workflow](/.github/workflows/build-github-mcp-server.yml) is provided to automate these steps.
 
 ## Prerequisites
 

samples/github-helper-agent/README.md

@@ -8,6 +8,19 @@ The agent uses:
 - LangGraph for orchestration
 - UiPath hosted GitHub MCP server
 
+The agent consists of three main components:
+
+1. [GitHub action to deploy](https://github.com/UiPath/uipath-mcp-python/blob/main/docs/how_to_pack_binary.md) the official GitHub MCP Server to UiPath
+2. [GitHub action](https://github.com/UiPath/uipath-mcp-python/blob/main/.github/workflows/trigger-github-agent.yml) that triggers this agent on "/help <command>"
+3. The GitHub helper agent itself with developer and reviewer nodes
+
+## Command Structure
+
+The agent responds to the following commands:
+
+- Reviewer: `/help suggest`, `/help review`, `/help test`
+- Developer: `/help commit` (commits the latest suggestion/review/tests)
+
 ## Architecture
 
 ```mermaid
@@ -64,7 +77,7 @@ uv venv -p 3.11 .venv
 uv sync
 ```
 
-Set your MCP Remote Server URL as environment variables in .env
+Set your MCP Remote Server URL as environment variables in `.env`:
 
 ```bash
 UIPATH_MCP_SERVER_URL=https://cloud.uipath.com/account/tenant/mcp_/mcp/folder-key/github-mcp/sse
@@ -75,8 +88,10 @@ UIPATH_MCP_SERVER_URL=https://cloud.uipath.com/account/tenant/mcp_/mcp/folder-ke
 For debugging issues:
 
 1. Check logs for any connection or runtime errors:
-   ```bash
-   uipath run agent '{"owner": "uipath", "repo": "uipath-mcp-python", "pullNumber": 78, "command": "summarize", "in_reply_to": 2060859623}'
-   ```
+```bash
+uipath run agent '{"owner": "uipath", "repo": "uipath-mcp-python", "pullNumber": 78, "command": "summarize", "in_reply_to": 2060859623}'
+```
+2. Verify that the GitHub MCP Server is properly deployed and accessible.
+3. Check GitHub Action logs for any issues with command triggers.