Use the following steps to run the MCP GitHub agent and tools in a Room in the cloud.

​
Prerequisites

​
Environment Variables

Set the following environment variable before running cloud agents:

  • GITHUB_PERSONAL_ACCESS_TOKEN: (string, required) Your GitHub personal access token.

​
Steps

  1. Install the Meshagent CLI and toolkit libraries:

    pip install "meshagent[all]"

  2. Sign up and authenticate with Meshagent CLI:

    meshagent auth login
# Or follow instructions at https://docs.meshagent.com/cli/getting_started

  3. Start an MCP GitHub service as an agent in a Meshagent Room:

    meshagent service test \
  --room=test \
  --role=agent \
  --image=meshagent/mcp-github:latest \
  --env GITHUB_PERSONAL_ACCESS_TOKEN=<YOUR_TOKEN> \
  --env MESHAGENT_PORT=8001 \
  --port="num=8001 path=/webhook liveness=/ type=meshagent.callable" \
  --name=mcp-github-service
    • This command launches the MCP server in a Meshagent Room (test).
    • Rooms are ephemeral by default and close if they go inactive.

  4. Start a chatbot in the Room with GitHub tools:

    meshagent chatbot join \
  --room=test \
  --agent-name=sample \
  --name=sample \
  --toolkit=mcp-github
    • This launches a chatbot in the same Room, enabling use of the GitHub toolkit.
    • Multiple toolkits and agents can coexist in one Room.
    • The command output shows a link to interact with the Room via browser.

​
Tools Available

Tools for interacting with the GitHub API, enabling file operations, repository management, search functionality, and more.

​
Tools Provided

ToolShort Description
add_issue_commentAdd a comment to an existing issue
create_branchCreate a new branch in a GitHub repository
create_issueCreate a new issue in a GitHub repository
create_or_update_fileCreate or update a single file in a GitHub repository
create_pull_requestCreate a new pull request in a GitHub repository
create_pull_request_reviewCreate a review on a pull request
create_repositoryCreate a new GitHub repository in your account
fork_repositoryFork a GitHub repository to your account or org
get_file_contentsGet contents of file/directory from a repo
get_issueGet details of a specific issue
get_pull_requestGet details of a specific pull request
get_pull_request_commentsGet the review comments on a pull request
get_pull_request_filesGet files changed in a pull request
get_pull_request_reviewsGet reviews on a pull request
get_pull_request_statusGet combined status of all status checks for a pull request
list_commitsList commits of a branch
list_issuesList issues in a repository
list_pull_requestsList and filter pull requests
merge_pull_requestMerge a pull request
push_filesPush multiple files in a single commit
search_codeSearch for code across repos
search_issuesSearch issues and pull requests across GitHub
search_repositoriesSearch for repositories
search_usersSearch for users
update_issueUpdate an existing issue
update_pull_request_branchUpdate a pull request branch with latest changes

​
Tool Details

​
Meshagent Resources