GitHub Repo Browser - Read Only

Function

Available ActionsEach successful request consumes credits as outlined below.

list_my_repos^5crlist_org_repos^5crget_repo^5crlist_branches^5crlist_commits^5crget_commit^5crlist_directory^5crget_file^5crget_readme^5crsearch_repositories^5crsearch_code^5crdownload_to_storage^5crdownload_repo_to_storage^5cr

Details

Give your AI agent secure, read-only access to your GitHub repositories. Browse your personal repos, organization repos, and any public project on GitHub. Explore folder structures, read source files and READMEs, view branches and commit history, and search across repositories or code. Download individual files or entire repository archives directly to file storage with integrity verification — perfect for downstream processing, attestation, or analysis. No risk of accidental writes, pushes, or deletions. Connects to your GitHub account so agents can access your private repos alongside any public repository on GitHub.

Use Cases

Browse your private GitHub repositories from a chat agent, Explore any public repository's folder structure and source files, Read README files and documentation from any repo, Search for code patterns across your repositories or any public project, Review recent commit history and see what changed in each commit, List branches and compare code across different branches, Audit dependencies by reading package.json or requirements.txt files, Gather code context for debugging without leaving your workflow, Onboard to unfamiliar codebases by exploring structure and reading key files, Research how open source projects implement specific features, Download individual files with integrity verification for processing or attestation, Download entire repository archives or specific subdirectories as .tar.gz files, Pull code snapshots from specific branches or tags for analysis

Connect Your Agent In 5 Min

Watch the setup guide for your platform

Or Install Locally

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to https://api.agentpmt.com/mcp. All tool execution happens in the cloud and the server cannot edit any files on your computer.

npm install -g @agentpmt/mcp-routeragentpmt-setup

Actions(13)

list_my_repos^5cr7 params

List repositories the connected GitHub account can access, with pagination and sorting.

visibilitystring

Repository visibility filter.

Values:

allpublicprivate

affiliationstring

Comma-separated affiliation filter such as owner,collaborator,organization_member.

sortstring

Sort field.

Values:

createdupdatedpushedfull_name

directionstring

Sort direction.

Values:

ascdesc

per_pageinteger

Items per page.

Range: 1 - 100

pageinteger

Page number.

Range: 1 - 1000

timeout_secondsinteger

HTTP timeout in seconds.

Range: 5 - 120

list_org_repos^5cr7 params(1 required)

List repositories for an organization the connected account can access.

orgrequiredstring

Organization login.

type_filterstring

Repository type filter.

Values:

allpublicprivateforkssourcesmember

sortstring

Sort field.

Values:

createdupdatedpushedfull_name

directionstring

Sort direction.

Values:

ascdesc

per_pageinteger

Items per page.

Range: 1 - 100

pageinteger

Page number.

Range: 1 - 1000

timeout_secondsinteger

HTTP timeout in seconds.

Range: 5 - 120

get_repo^5cr3 params(2 required)

Fetch repository metadata, default branch, permissions, and URLs.

ownerrequiredstring

Repository owner.

reporequiredstring

Repository name.

timeout_secondsinteger

HTTP timeout in seconds.

Range: 5 - 120

list_branches^5cr6 params(2 required)

List repository branches with pagination.

ownerrequiredstring

Repository owner.

reporequiredstring

Repository name.

protected_onlyboolean

When true, list only protected branches.

per_pageinteger

Items per page.

Range: 1 - 100

pageinteger

Page number.

Range: 1 - 1000

timeout_secondsinteger

HTTP timeout in seconds.

Range: 5 - 120

list_commits^5cr8 params(2 required)

List commits for a repository, optionally scoped to a branch and filtered to the last N hours. Results are returned newest first.

ownerrequiredstring

Repository owner.

reporequiredstring

Repository name.

refstring

Branch, tag, or commit SHA to scope the commit list.

pathstring

Optional file or directory path to filter commits.

since_hoursinteger

Only include commits from the last N hours.

Range: 1 - 720

per_pageinteger

Items per page.

Range: 1 - 100

pageinteger

Page number.

Range: 1 - 1000

timeout_secondsinteger

HTTP timeout in seconds.

Range: 5 - 120

get_commit^5cr4 params(3 required)

Fetch a specific commit by SHA, including changed files and commit stats.

ownerrequiredstring

Repository owner.

reporequiredstring

Repository name.

commit_sharequiredstring

Commit SHA to fetch.

timeout_secondsinteger

HTTP timeout in seconds.

Range: 5 - 120

list_directory^5cr5 params(2 required)

List the contents of a repository directory at a branch, tag, or commit.

ownerrequiredstring

Repository owner.

reporequiredstring

Repository name.

pathstring

Directory path. Omit or use empty string for repository root.

refstring

Branch, tag, or commit SHA. Defaults to repository default branch.

timeout_secondsinteger

HTTP timeout in seconds.

Range: 5 - 120

get_file^5cr5 params(3 required)

Read a text file from a repository at a branch, tag, or commit. Binary and oversized files are rejected.

ownerrequiredstring

Repository owner.

reporequiredstring

Repository name.

pathrequiredstring

File path to read.

refstring

Branch, tag, or commit SHA. Defaults to repository default branch.

timeout_secondsinteger

HTTP timeout in seconds.

Range: 5 - 120

get_readme^5cr4 params(2 required)

Fetch the repository README content and metadata.

ownerrequiredstring

Repository owner.

reporequiredstring

Repository name.

refstring

Branch, tag, or commit SHA. Defaults to repository default branch.

timeout_secondsinteger

HTTP timeout in seconds.

Range: 5 - 120

search_repositories^5cr6 params(1 required)

Search repositories visible to the connected account.

queryrequiredstring

GitHub repository search query.

sortstring

Search sort field.

Values:

starsforkshelp-wanted-issuesupdated

orderstring

Search order.

Values:

ascdesc

per_pageinteger

Items per page.

Range: 1 - 100

pageinteger

Page number.

Range: 1 - 100

timeout_secondsinteger

HTTP timeout in seconds.

Range: 5 - 120

search_code^5cr8 params(1 required)

Search code visible to the connected account, optionally scoped to a specific repository.

queryrequiredstring

GitHub code search query. You can include qualifiers like language:python or path:src.

ownerstring

Optional repository owner to scope the search.

repostring

Optional repository name to scope the search; requires owner when provided.

sortstring

Search sort field when supported.

Values:

indexed

orderstring

Search order.

Values:

ascdesc

per_pageinteger

Items per page.

Range: 1 - 100

pageinteger

Page number.

Range: 1 - 100

timeout_secondsinteger

HTTP timeout in seconds.

Range: 5 - 120

download_to_storage^5cr5 params(3 required)

Download a single file from a GitHub repository and save it to file storage with SHA1 integrity verification. Returns a file_id and signed_url. Supports files up to 100 MB including binary files.

ownerrequiredstring

Repository owner.

reporequiredstring

Repository name.

pathrequiredstring

File path to download.

refstring

Branch, tag, or commit SHA. Defaults to repository default branch.

timeout_secondsinteger

HTTP timeout in seconds.

Range: 5 - 120

download_repo_to_storage^5cr5 params(2 required)

Download a repository archive as a .tar.gz file and save it to file storage. Use ref to select a branch, tag, or commit. Use path to optionally filter to a specific subdirectory. Archives up to 100 MB are supported.

ownerrequiredstring

Repository owner.

reporequiredstring

Repository name.

refstring

Branch, tag, or commit SHA. Defaults to repository default branch.

pathstring

Subdirectory to filter the archive to. Only files under this path will be included.

timeout_secondsinteger

HTTP timeout in seconds.

Range: 5 - 120

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "69c304d6385f218fb97453fb",
    "parameters": {
      "action": "list_my_repos"
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "69c304d6385f218fb97453fb",
    "parameters": {
        "action": "list_my_repos"
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "69c304d6385f218fb97453fb",
  parameters: {
    "action": "list_my_repos"
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "69c304d6385f218fb97453fb",
  parameters: {
    "action": "list_my_repos"
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

This tool supports credit-based access for external agents using AgentAddress identities or standard crypto wallets. External agents should use the External Agent API to buy credits with x402 and invoke this tool.

1. Buy Credits

Purchase credits via x402 payment (500 credit minimum, 100 credits = $1).

# Request payment requirements (returns 402 + PAYMENT-REQUIRED header)
curl -i -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

# Sign the EIP-3009 authorization, then retry with signature header
curl -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <base64-json>" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

2. Create a Session Nonce (nonce used in signed balance/invoke)

curl -s -X POST "https://www.agentpmt.com/api/external/auth/session" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET" }'

3. Invoke This Tool

Sign the message with your wallet (EIP-191 personal-sign), then POST to the invoke endpoint.

# Sign this message (wallet MUST be lowercased):
# agentpmt-external
# wallet:0xyourwallet...
# session:<session_nonce>
# request:<request_id>
# action:invoke
# product:69c304d6385f218fb97453fb
# payload:<sha256(canonical_json(parameters))>

curl -s -X POST "https://www.agentpmt.com/api/external/tools/69c304d6385f218fb97453fb/invoke" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0xYOUR_WALLET",
    "session_nonce": "<session_nonce>",
    "request_id": "invoke-uuid",
    "signature": "0x<signature>",
    "parameters": {
      "action": "your_action",
      "your_param": "value"
    }
  }'

Usage Instructions

Usage guidance provided directly by the developer for this product.

GitHub Repo Browser

Read-only GitHub repository navigation for agents. Use it to browse accessible repositories, inspect repo structure, read files, fetch READMEs, search repositories or code, and download files or entire repo archives to file storage.

Actions

`list_my_repos`

List repositories the connected GitHub account can access.

Optional fields:

visibility: all, public, or private
affiliation: comma-separated GitHub affiliation filter such as owner,collaborator,organization_member
sort: created, updated, pushed, or full_name
direction: asc or desc
per_page: 1-100
page: 1+

{"action":"list_my_repos","visibility":"private","per_page":20,"page":1}

`list_org_repos`

List repositories in an organization the connected account can access.

Required fields:

org

Optional fields:

type_filter: all, public, private, forks, sources, or member
sort, direction, per_page, page

{"action":"list_org_repos","org":"acme","type_filter":"private","per_page":25}

`get_repo`

Fetch repository metadata including default branch, permissions, visibility, and URLs.

Required fields:

owner
repo

{"action":"get_repo","owner":"acme","repo":"platform"}

`list_branches`

List repository branches with pagination.

Required fields:

owner
repo

Optional fields:

protected_only
per_page
page

{"action":"list_branches","owner":"acme","repo":"platform","protected_only":true}

`list_commits`

List commits for a repository. You can scope the list to a branch, tag, or commit ancestry using ref, and filter to commits from the last N hours using since_hours. Results come back newest first.

Required fields:

owner
repo

Optional fields:

ref
path
since_hours
per_page
page

{"action":"list_commits","owner":"acme","repo":"platform","ref":"release/2026.03","since_hours":24,"per_page":20}

`get_commit`

Fetch a specific commit by SHA, including commit metadata, stats, and changed files.

Required fields:

owner
repo
commit_sha

{"action":"get_commit","owner":"acme","repo":"platform","commit_sha":"abc123def4567890abc123def4567890abc12345"}

`list_directory`

List the contents of a repository directory.

Required fields:

owner
repo

Optional fields:

path: omit for repository root
ref: branch, tag, or commit SHA

{"action":"list_directory","owner":"acme","repo":"platform","path":"src","ref":"main"}

`get_file`

Read a text file from a repository. Binary files and files larger than 1 MB are rejected.

Required fields:

owner
repo
path

Optional fields:

ref

{"action":"get_file","owner":"acme","repo":"platform","path":"src/app.py","ref":"main"}

`get_readme`

Fetch the repository README content and metadata.

Required fields:

owner
repo

Optional fields:

ref

{"action":"get_readme","owner":"acme","repo":"platform"}

`search_repositories`

Search repositories visible to the connected account.

Required fields:

query

Optional fields:

sort: stars, forks, help-wanted-issues, or updated
order: asc or desc
per_page
page

{"action":"search_repositories","query":"terraform language:hcl org:acme","sort":"updated","per_page":10}

`search_code`

Search code visible to the connected account. You can scope the search to a repository by providing owner and repo, or by including qualifiers directly in query.

Required fields:

query

Optional fields:

owner
repo
sort: indexed
order: asc or desc
per_page
page

{"action":"search_code","query":"OpenAI apiKey path:src language:typescript","owner":"acme","repo":"platform"}

`download_to_storage`

Download a file from a GitHub repository and save it to file storage. Returns a file_id and signed_url for downstream tools to access the exact bytes. Files up to 100 MB are supported. Downloaded bytes are integrity-verified against GitHub's git SHA before storage.

Required fields:

owner
repo
path

Optional fields:

ref

{"action":"download_to_storage","owner":"acme","repo":"platform","path":"assets/logo.png","ref":"main"}

`download_repo_to_storage`

Download a repository archive as a .tar.gz file and save it to file storage. Returns a file_id and signed_url. Use ref to select a specific branch, tag, or commit SHA. Use path to optionally filter the archive to a subdirectory.

Required fields:

owner
repo

Optional fields:

ref: branch, tag, or commit SHA (defaults to the repository's default branch)
path: subdirectory to filter the archive to

Download an entire repository:

{"action":"download_repo_to_storage","owner":"acme","repo":"platform","ref":"main"}

Download only a subdirectory:

{"action":"download_repo_to_storage","owner":"acme","repo":"platform","ref":"v2.1.0","path":"service"}

Notes

This tool is intentionally read-only. It does not support issue creation, pull request edits, pushes, or generic passthrough requests.
All actions require a connected GitHub account via the existing github_token software connection.
Pagination metadata includes page, per_page, next_page, prev_page, has_next_page, and has_prev_page when applicable.
list_commits uses GitHub's commit listing endpoint and applies the since_hours filter by converting it to a GitHub since timestamp.
get_file and get_readme return UTF-8 decoded text content for files up to 1 MB.
download_to_storage downloads raw bytes (any file type) up to 100 MB and verifies integrity via git SHA1 before uploading to file storage.
download_repo_to_storage downloads a full repository archive (or a filtered subdirectory) as a .tar.gz file up to 100 MB and uploads it to file storage.

GitHub Repo Browser - Read Only

Available ActionsEach successful request consumes credits as outlined below.

Details

Use Cases

Connect Your Agent In 5 Min

Or Install Locally

Actions(13)

1. Buy Credits

2. Create a Session Nonce (nonce used in signed balance/invoke)

3. Invoke This Tool

Usage Instructions

GitHub Repo Browser

Actions

`list_my_repos`

`list_org_repos`

`get_repo`

`list_branches`

`list_commits`

`get_commit`

`list_directory`

`get_file`

`get_readme`

`search_repositories`

`search_code`

`download_to_storage`

`download_repo_to_storage`

Notes

Related Content

AI DevOps: Give Your Agents Eyes on Every Codebase

Looking for help integrating AI into your business? Set up a free consultation.