GitHub MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on GitHub: 46 typed functions through one MCP server. No GitHub API key needed.
- Site
- github.com
- Functions
- 46
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for GitHub alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/githubOne MCP server for GitHub and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
compareCommitsCompares two refs of a public repo.Arguments
Name Type Required ownerstringYes repostringYes basestringYes headstringYes Returns
GithubCompareResultinterface GithubComparedFile { filename: string; status: string; additions: number; deletions: number; changes: number; patch: string | null; } interface GithubCompareResult { /** ahead / behind / diverged / identical */ status: string; aheadBy: number; behindBy: number; totalCommits: number; commits: { sha: string; authorName: string; date: string; message: string; url: string }[]; files: GithubComparedFile[]; url: string; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/compareCommitsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.compareCommits("octocat", "Hello-World", "master", "test");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.compareCommits("octocat", "Hello-World", "master", "test"))curl -X POST https://api.bowmark.ai/v1/sites/github/compareCommits \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"octocat","repo":"Hello-World","base":"master","head":"test"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.compareCommits("octocat", "Hello-World", "master", "test");getFileContentsReads any file in a public repository decoded to text, or lists a directory.Arguments
Name Type Required ownerstringYes repostringYes pathstringYes options.refstringNo Returns
GithubFileContentsinterface GithubDirectoryEntry { name: string; path: string; type: string; size: number; url: string; } interface GithubFileContents { kind: "file" | "directory"; path: string; content: string | null; size: number; url: string; downloadUrl: string | null; entries: GithubDirectoryEntry[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/getFileContentsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.getFileContents("octocat", "Hello-World", "README");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.getFileContents("octocat", "Hello-World", "README"))curl -X POST https://api.bowmark.ai/v1/sites/github/getFileContents \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"octocat","repo":"Hello-World","path":"README"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.getFileContents("octocat", "Hello-World", "README");getIssueReturns the full details of one issue.Arguments
Name Type Required ownerstringYes repostringYes issueNumbernumberYes Returns
GithubIssueDetailinterface GithubIssue { number: number; title: string; body: string | null; creator: string; assignees: string[]; labels: string[]; state: string; comments: number; createdAt: string; updatedAt: string; closedAt: string | null; url: string; } interface GithubIssueReactions { total: number; plusOne: number; minusOne: number; laugh: number; hooray: number; confused: number; heart: number; rocket: number; eyes: number; } interface GithubIssueDetail extends GithubIssue { locked: boolean; closedBy: string | null; reactions: GithubIssueReactions; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/getIssueCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.getIssue("octocat", "Hello-World", 349);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.getIssue("octocat", "Hello-World", 349))curl -X POST https://api.bowmark.ai/v1/sites/github/getIssue \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"octocat","repo":"Hello-World","issueNumber":349}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.getIssue("octocat", "Hello-World", 349);getOrganizationReturns an organization's public metadata.Arguments
Name Type Required orgstringYes Returns
GithubOrganizationinterface GithubOrganization { login: string; id: number; avatarUrl: string; profileUrl: string; name: string | null; blog: string; location: string | null; email: string | null; description: string | null; publicRepos: number; createdAt: string; updatedAt: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/getOrganizationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.getOrganization("kubernetes");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.getOrganization("kubernetes"))curl -X POST https://api.bowmark.ai/v1/sites/github/getOrganization \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"org":"kubernetes"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.getOrganization("kubernetes");getProfileReadmeReads a person's GitHub profile.Arguments
Name Type Required handlestringYes Returns
GithubProfileReadmeinterface GithubProfileReadme { login: string; name: string | null; company: string | null; blog: string | null; bio: string | null; twitterUsername: string | null; profileUrl: string; readme: string | null; readmeUrl: string | null; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/getProfileReadmeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.getProfileReadme("mattpocock");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.getProfileReadme("mattpocock"))curl -X POST https://api.bowmark.ai/v1/sites/github/getProfileReadme \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"handle":"mattpocock"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.getProfileReadme("mattpocock");getPullRequestReturns the full details of one pull request.Arguments
Name Type Required ownerstringYes repostringYes pullRequestNumbernumberYes Returns
GithubPullRequestDetailinterface GithubPullRequest { number: number; title: string; body: string | null; creator: string; state: string; draft: boolean; merged: boolean; mergedAt: string | null; baseBranch: string; headBranch: string; createdAt: string; updatedAt: string; closedAt: string | null; url: string; } interface GithubPullRequestReactions { total: number; plusOne: number; minusOne: number; laugh: number; hooray: number; confused: number; heart: number; rocket: number; eyes: number; } interface GithubPullRequestDetail extends GithubPullRequest { locked: boolean; closedBy: string | null; reactions: GithubPullRequestReactions; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/getPullRequestCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.getPullRequest("octocat", "Hello-World", 1);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.getPullRequest("octocat", "Hello-World", 1))curl -X POST https://api.bowmark.ai/v1/sites/github/getPullRequest \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"octocat","repo":"Hello-World","pullRequestNumber":1}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.getPullRequest("octocat", "Hello-World", 1);getReadmeReturns a public repository's README decoded to text, whatever its filename.Arguments
Name Type Required ownerstringYes repostringYes Returns
GithubReadmeinterface GithubReadme { name: string; path: string; size: number; content: string; url: string; downloadUrl: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/getReadmeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.getReadme("octocat", "Hello-World");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.getReadme("octocat", "Hello-World"))curl -X POST https://api.bowmark.ai/v1/sites/github/getReadme \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"octocat","repo":"Hello-World"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.getReadme("octocat", "Hello-World");getRepoReturns a public repository's own metadata.Arguments
Name Type Required ownerstringYes repostringYes Returns
GithubRepositoryinterface GithubRepository { name: string; description: string | null; defaultBranch: string; stars: number; forks: number; openIssues: number; language: string | null; license: string | null; homepage: string | null; createdAt: string; updatedAt: string; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/getRepoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.getRepo("octocat", "Hello-World");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.getRepo("octocat", "Hello-World"))curl -X POST https://api.bowmark.ai/v1/sites/github/getRepo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"octocat","repo":"Hello-World"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.getRepo("octocat", "Hello-World");getSocialAccountsLists the social links a user put on their profile.Arguments
Name Type Required usernamestringYes Returns
GithubSocialAccountsResultinterface GithubSocialAccount { provider: string; // "twitter", "linkedin", "mastodon", "bluesky", "youtube", … or "generic" url: string; } interface GithubSocialAccountsResult { login: string; accounts: GithubSocialAccount[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/getSocialAccountsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.getSocialAccounts("erikbern");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.getSocialAccounts("erikbern"))curl -X POST https://api.bowmark.ai/v1/sites/github/getSocialAccounts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"erikbern"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.getSocialAccounts("erikbern");getSponsorPageReturns a person's public GitHub Sponsors page.Arguments
Name Type Required handlestringYes Returns
GithubSponsorPageinterface GithubSponsorTier { /** The tier's monthly price in whole dollars, GitHub Sponsors has no sub-dollar tiers. */ amount: number; /** The tier's own reward text, GitHub's rendered HTML stripped to plain text. */ description: string; } interface GithubSponsorPage { handle: string; name: string; bio: string | null; location: string | null; sponsorCount: number; tiers: GithubSponsorTier[]; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/getSponsorPageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.getSponsorPage("mattpocock");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.getSponsorPage("mattpocock"))curl -X POST https://api.bowmark.ai/v1/sites/github/getSponsorPage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"handle":"mattpocock"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.getSponsorPage("mattpocock");getUserReturns a person's public GitHub profile metadata.Arguments
Name Type Required usernamestringYes Returns
GithubUserinterface GithubUser { login: string; id: number; avatarUrl: string; profileUrl: string; type: string; name: string | null; company: string | null; blog: string; location: string | null; email: string | null; bio: string | null; twitterUsername: string | null; publicRepos: number; followers: number; following: number; createdAt: string; updatedAt: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/getUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.getUser("octocat");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.getUser("octocat"))curl -X POST https://api.bowmark.ai/v1/sites/github/getUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"octocat"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.getUser("octocat");getUserRepositoriesLists every public repository a user owns.Arguments
Name Type Required usernamestringYes options.sort"created" | "updated" | "pushed" | "full_name"No options.direction"asc" | "desc"No options.per_pagenumberNo options.pagenumberNo Returns
GithubGetUserRepositoriesResultinterface GithubUserRepository { name: string; fullName: string; description: string | null; fork: boolean; archived: boolean; defaultBranch: string; stars: number; forks: number; language: string | null; url: string; updatedAt: string; pushedAt: string | null; } interface GithubGetUserRepositoriesResult { repositories: GithubUserRepository[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/getUserRepositoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.getUserRepositories("octocat", { per_page: 2 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.getUserRepositories("octocat", {"per_page": 2}))curl -X POST https://api.bowmark.ai/v1/sites/github/getUserRepositories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"octocat","options":{"per_page":2}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.getUserRepositories("octocat", { per_page: 2 });listCommitsReturns a repository's commit log.Arguments
Name Type Required ownerstringYes repostringYes options.shastringNo options.sincestringNo options.untilstringNo options.authorstringA login or an email: only commits by that author.No options.per_pagenumberNo options.pagenumberNo Returns
GithubListCommitsResultinterface GithubCommit { sha: string; authorName: string; authorEmail: string; date: string; message: string; url: string; authorLogin?: string | null; // the GitHub account the commit is linked to, or null } interface GithubListCommitsResult { commits: GithubCommit[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/listCommitsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.listCommits("octocat", "Hello-World", { per_page: 2 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.listCommits("octocat", "Hello-World", {"per_page": 2}))curl -X POST https://api.bowmark.ai/v1/sites/github/listCommits \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"octocat","repo":"Hello-World","options":{"per_page":2}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.listCommits("octocat", "Hello-World", { per_page: 2 });listContributorsLists who has contributed to a public repository, most commits first.Arguments
Name Type Required ownerstringYes repostringYes options.per_pagenumberNo options.pagenumberNo Returns
GithubListContributorsResultinterface GithubContributor { login: string; id: number; type: string; contributions: number; avatarUrl: string; profileUrl: string; } interface GithubListContributorsResult { contributors: GithubContributor[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/listContributorsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.listContributors("octocat", "Hello-World", { per_page: 2 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.listContributors("octocat", "Hello-World", {"per_page": 2}))curl -X POST https://api.bowmark.ai/v1/sites/github/listContributors \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"octocat","repo":"Hello-World","options":{"per_page":2}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.listContributors("octocat", "Hello-World", { per_page: 2 });listIssueCommentsReads the comment thread on an issue or pull request.Arguments
Name Type Required ownerstringYes repostringYes issueNumbernumberYes options.sincestringNo options.per_pagenumberNo options.pagenumberNo Returns
GithubListIssueCommentsResultinterface GithubIssueComment { id: number; author: string | null; body: string; createdAt: string; updatedAt: string; authorAssociation: string; url: string; } interface GithubListIssueCommentsResult { comments: GithubIssueComment[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/listIssueCommentsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.listIssueComments("octocat", "Hello-World", 1, { per_page: 2 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.listIssueComments("octocat", "Hello-World", 1, {"per_page": 2}))curl -X POST https://api.bowmark.ai/v1/sites/github/listIssueComments \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"octocat","repo":"Hello-World","issueNumber":1,"options":{"per_page":2}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.listIssueComments("octocat", "Hello-World", 1, { per_page: 2 });listIssuesLists issues on a repository, optionally filtered by state (open/closed), assignee, label, and milestone.Arguments
Name Type Required ownerstringYes repostringYes options.state"open" | "closed" | "all"No options.assigneestringNo options.labelsstringNo options.milestonestringNo options.per_pagenumberNo options.pagenumberNo Returns
GithubListIssuesResultinterface GithubIssue { number: number; title: string; body: string | null; creator: string; assignees: string[]; labels: string[]; state: string; comments: number; createdAt: string; updatedAt: string; closedAt: string | null; url: string; } interface GithubListIssuesResult { issues: GithubIssue[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/listIssuesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.listIssues("microsoft", "vscode", { per_page: 30, state: "open" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.listIssues("microsoft", "vscode", {"per_page": 30, "state": "open"}))curl -X POST https://api.bowmark.ai/v1/sites/github/listIssues \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"microsoft","repo":"vscode","options":{"per_page":30,"state":"open"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.listIssues("microsoft", "vscode", { per_page: 30, state: "open" });listMarketplaceActionsLists GitHub Actions available on the marketplace, optionally filtered by category or search query.Arguments
Name Type Required querystringFree-text search, matching GitHub's own marketplace search box.No categorystringA marketplace category slug, e.g. "deployment", "code-quality".No pagenumber1-based page number.No Returns
GithubListMarketplaceActionsResultinterface GithubMarketplaceAction { slug: string; name: string; description: string; listingType: string; // the site's own labels, read the values off a result, never guess one from prose url: string; } interface GithubListMarketplaceActionsResult { actions: GithubMarketplaceAction[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/listMarketplaceActionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.listMarketplaceActions({ query: "deploy" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.listMarketplaceActions({"query": "deploy"}))curl -X POST https://api.bowmark.ai/v1/sites/github/listMarketplaceActions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"options":{"query":"deploy"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.listMarketplaceActions({ query: "deploy" });listNotificationsLists the signed-in caller's GitHub notifications inbox, 25 per page.Arguments
Name Type Required querystringGithub.com's own filter: "is:unread", "reason:mention", "repo:owner/name".No afterstringA previous page's nextCursor.No Returns
GithubListNotificationsResultinterface GithubNotification { id: string; repository: string; // "owner/repo" number: number | null; // null for a thread with none (a Dependabot alert, a release) title: string; type: string; // "PullRequest" | "Issue" | "Discussion" | "Commit" | "Release" | "SecurityAlert" | github.com's own thread_type reason: string | null; // github.com's words: "author", "mention", "subscribed", "review requested", "security alert", … unread: boolean; updatedAt: string | null; url: string; } interface GithubListNotificationsResult { login: string; // the signed-in account notifications: GithubNotification[]; // 25 per page, newest first totalCount: number | null; // github.com's own total for this filter nextCursor: string | null; // null on the last page }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/listNotificationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.listNotifications();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.listNotifications())curl -X POST https://api.bowmark.ai/v1/sites/github/listNotifications \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.listNotifications();listOrganizationMembersLists an organization's public members.Arguments
Name Type Required orgstringYes options.per_pagenumberNo options.pagenumberNo Returns
GithubListOrganizationMembersResultinterface GithubOrgMember { login: string; id: number; avatarUrl: string; profileUrl: string; type: string; } interface GithubListOrganizationMembersResult { members: GithubOrgMember[]; // PUBLIC members only warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/listOrganizationMembersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.listOrganizationMembers("kubernetes", { per_page: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.listOrganizationMembers("kubernetes", {"per_page": 5}))curl -X POST https://api.bowmark.ai/v1/sites/github/listOrganizationMembers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"org":"kubernetes","options":{"per_page":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.listOrganizationMembers("kubernetes", { per_page: 5 });listOrganizationRepositoriesLists an organization's public repositories.Arguments
Name Type Required orgstringYes options.type"all" | "public" | "sources" | "forks" | "member"No options.sort"created" | "updated" | "pushed" | "full_name"No options.direction"asc" | "desc"No options.per_pagenumberNo options.pagenumberNo Returns
GithubGetUserRepositoriesResultinterface GithubUserRepository { name: string; fullName: string; description: string | null; fork: boolean; archived: boolean; defaultBranch: string; stars: number; forks: number; language: string | null; url: string; updatedAt: string; pushedAt: string | null; } interface GithubGetUserRepositoriesResult { repositories: GithubUserRepository[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/listOrganizationRepositoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.listOrganizationRepositories("kubernetes", { per_page: 2 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.listOrganizationRepositories("kubernetes", {"per_page": 2}))curl -X POST https://api.bowmark.ai/v1/sites/github/listOrganizationRepositories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"org":"kubernetes","options":{"per_page":2}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.listOrganizationRepositories("kubernetes", { per_page: 2 });listPullRequestFilesLists what a pull request changes.Arguments
Name Type Required ownerstringYes repostringYes pullNumbernumberYes options.per_pagenumberNo options.pagenumberNo Returns
GithubListPullRequestFilesResultinterface GithubPullRequestFile { filename: string; /** GitHub's own file status: "added", "modified", "removed", "renamed" (also "copied", "changed", "unchanged"). */ status: string; additions: number; deletions: number; changes: number; patch: string | null; previousFilename: string | null; url: string; } interface GithubListPullRequestFilesResult { files: GithubPullRequestFile[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/listPullRequestFilesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.listPullRequestFiles("octocat", "Hello-World", 1);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.listPullRequestFiles("octocat", "Hello-World", 1))curl -X POST https://api.bowmark.ai/v1/sites/github/listPullRequestFiles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"octocat","repo":"Hello-World","pullNumber":1}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.listPullRequestFiles("octocat", "Hello-World", 1);listPullRequestsLists pull requests on a repository, optionally filtered by state (open/closed/all), base branch, and head branch.Arguments
Name Type Required ownerstringYes repostringYes options.state"open" | "closed" | "all"No options.basestringNo options.headstringNo options.per_pagenumberNo options.pagenumberNo Returns
GithubListPullRequestsResultinterface GithubPullRequest { number: number; title: string; body: string | null; creator: string; state: string; draft: boolean; merged: boolean; mergedAt: string | null; baseBranch: string; headBranch: string; createdAt: string; updatedAt: string; closedAt: string | null; url: string; } interface GithubListPullRequestsResult { pullRequests: GithubPullRequest[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/listPullRequestsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.listPullRequests("microsoft", "vscode", { per_page: 2, state: "open" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.listPullRequests("microsoft", "vscode", {"per_page": 2, "state": "open"}))curl -X POST https://api.bowmark.ai/v1/sites/github/listPullRequests \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"microsoft","repo":"vscode","options":{"per_page":2,"state":"open"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.listPullRequests("microsoft", "vscode", { per_page: 2, state: "open" });listReleasesReturns a public repository's release history.Arguments
Name Type Required ownerstringYes repostringYes options.per_pagenumberNo options.pagenumberNo Returns
GithubListReleasesResultinterface GithubRelease { tag: string; name: string; draft: boolean; prerelease: boolean; createdAt: string; publishedAt: string | null; notes: string; url: string; } interface GithubListReleasesResult { releases: GithubRelease[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/listReleasesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.listReleases("microsoft", "TypeScript", { per_page: 2 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.listReleases("microsoft", "TypeScript", {"per_page": 2}))curl -X POST https://api.bowmark.ai/v1/sites/github/listReleases \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"microsoft","repo":"TypeScript","options":{"per_page":2}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.listReleases("microsoft", "TypeScript", { per_page: 2 });listSecurityAdvisoriesLists known security advisories for a package (GitHub's global advisory database) or a repository's own published advisories.Arguments
Name Type Required ecosystemstringGlobal database: npm, pip, maven, go, rubygems, nuget, composer, rust, …No packagestringGlobal database: a package name, or name@version to keep only advisories affecting that version.No ownerstringA repository's own published advisories instead.No repostringNo severitystringNo per_pagenumberNo Returns
GithubListSecurityAdvisoriesResultinterface GithubAdvisory { ghsaId: string; cveId: string | null; severity: string; summary: string; description: string; vulnerabilities: { ecosystem: string | null; package: string | null; vulnerableVersionRange: string | null; patchedVersions: string | null; }[]; publishedAt: string | null; url: string; } interface GithubListSecurityAdvisoriesResult { advisories: GithubAdvisory[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/listSecurityAdvisoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.listSecurityAdvisories({ ecosystem: "npm", package: "axios", per_page: 2 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.listSecurityAdvisories({"ecosystem": "npm", "package": "axios", "per_page": 2}))curl -X POST https://api.bowmark.ai/v1/sites/github/listSecurityAdvisories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"options":{"ecosystem":"npm","package":"axios","per_page":2}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.listSecurityAdvisories({ ecosystem: "npm", package: "axios", per_page: 2 });listStarredRepositoriesLists repositories the signed-in caller has starred.Arguments
Name Type Required options{ per_page?: number; page?: number }No Returns
GithubListStarredRepositoriesResultinterface GithubStarredRepository { name: string; fullName: string; description: string | null; stars: number; url: string; } interface GithubListStarredRepositoriesResult { login: string; // the signed-in account whose stars these are repositories: GithubStarredRepository[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/listStarredRepositoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.listStarredRepositories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.listStarredRepositories())curl -X POST https://api.bowmark.ai/v1/sites/github/listStarredRepositories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.listStarredRepositories();listTopicsLists topics from GitHub's public topics page.Arguments
None.
Returns
GithubListTopicsResultinterface GithubTopic { name: string; url: string; } interface GithubListTopicsResult { topics: GithubTopic[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/listTopicsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.listTopics();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.listTopics())curl -X POST https://api.bowmark.ai/v1/sites/github/listTopics \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.listTopics();listTrendingRepositoriesLists repositories trending on GitHub by stars in a time window (daily/weekly/monthly), optionally filtered by language.Arguments
Name Type Required opts{ since?: "daily" | "weekly" | "monthly"; language?: string }No Returns
GithubListTrendingRepositoriesResultinterface GithubTrendingRepository { handle: string; description: string; language: string | null; stars: number; forks: number; trendingStarsToday: number; url: string; } interface GithubListTrendingRepositoriesResult { since: "daily" | "weekly" | "monthly"; language: string | null; repositories: GithubTrendingRepository[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/listTrendingRepositoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.listTrendingRepositories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.listTrendingRepositories())curl -X POST https://api.bowmark.ai/v1/sites/github/listTrendingRepositories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.listTrendingRepositories();listWorkflowRunsLists a public repo's GitHub Actions workflow runs.Arguments
Name Type Required ownerstringYes repostringYes options.branchstringNo options.eventstringNo options.statusstringA status (completed, in_progress) or a conclusion (success, failure).No options.per_pagenumberNo options.pagenumberNo Returns
GithubListWorkflowRunsResultinterface GithubWorkflowRun { id: number; workflow: string; title: string; runNumber: number; branch: string | null; headSha: string; event: string; status: string | null; // the site's own labels, read the values off a result, never guess one from prose conclusion: string | null; createdAt: string; updatedAt: string; url: string; } interface GithubListWorkflowRunsResult { totalCount: number; runs: GithubWorkflowRun[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/listWorkflowRunsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.listWorkflowRuns("axios", "axios", { per_page: 2 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.listWorkflowRuns("axios", "axios", {"per_page": 2}))curl -X POST https://api.bowmark.ai/v1/sites/github/listWorkflowRuns \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"axios","repo":"axios","options":{"per_page":2}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.listWorkflowRuns("axios", "axios", { per_page: 2 });searchCodeSearches for code across public repositories, off github.com's own rendered code-search results page.Arguments
Name Type Required querystringYes Returns
GithubSearchCodeResultinterface GithubSearchCodeResult { // github.com's own blackbirdSearchRoute payload, raw, the signed-in field // from), so this is not narrowed to invented field names. Read it defensively. totalCount: number; results: unknown[]; raw: Record<string, unknown>; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/searchCodeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.searchCode("useState");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.searchCode("useState"))curl -X POST https://api.bowmark.ai/v1/sites/github/searchCode \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"useState"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.searchCode("useState");searchIssuesFree-text search over issues and pull requests across GitHub.Arguments
Name Type Required querystringYes options.sort"comments" | "reactions" | "created" | "updated"No options.order"asc" | "desc"No options.per_pagenumberNo options.pagenumberNo Returns
GithubSearchIssuesResultinterface GithubIssueSearchHit { number: number; title: string; state: string; isPullRequest: boolean; author: string | null; labels: string[]; comments: number; createdAt: string; updatedAt: string; closedAt: string | null; repository: string; url: string; } interface GithubSearchIssuesResult { totalCount: number; issues: GithubIssueSearchHit[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/searchIssuesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.searchIssues("repo:microsoft/vscode is:issue terminal crash", { per_page: 2 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.searchIssues("repo:microsoft/vscode is:issue terminal crash", {"per_page": 2}))curl -X POST https://api.bowmark.ai/v1/sites/github/searchIssues \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"repo:microsoft/vscode is:issue terminal crash","options":{"per_page":2}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.searchIssues("repo:microsoft/vscode is:issue terminal crash", { per_page: 2 });searchRepositoriesSearches across all public repositories by name, language, topic, star count and other filters.Arguments
Name Type Required querystringYes options.sort"stars" | "forks" | "help-wanted-issues" | "updated"No options.order"asc" | "desc"No options.per_pagenumberNo options.pagenumberNo Returns
GithubSearchRepositoriesResultinterface GithubRepositorySearchResult { fullName: string; owner: string; description: string | null; stars: number; forks: number; language: string | null; url: string; updatedAt: string; } interface GithubSearchRepositoriesResult { totalCount: number; repositories: GithubRepositorySearchResult[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/searchRepositoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.searchRepositories("stars:>50000 language:typescript", { per_page: 2 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.searchRepositories("stars:>50000 language:typescript", {"per_page": 2}))curl -X POST https://api.bowmark.ai/v1/sites/github/searchRepositories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"stars:>50000 language:typescript","options":{"per_page":2}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.searchRepositories("stars:>50000 language:typescript", { per_page: 2 });searchUsersSearches GitHub accounts by display name (fullname:), location, followers and other qualifiers.Arguments
Name Type Required querystringYes options.sort"followers" | "repositories" | "joined"No options.order"asc" | "desc"No options.per_pagenumberNo options.pagenumberNo Returns
GithubSearchUsersResultinterface GithubUserHit { login: string; id: number; avatarUrl: string; profileUrl: string; type: string; // "User" or "Organization" score: number; // GitHub's own relevance score } interface GithubSearchUsersResult { totalCount: number; // GitHub's own match count; may exceed the page users: GithubUserHit[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/searchUsersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.searchUsers("fullname:\"Erik Bernhardsson\"", { per_page: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.searchUsers("fullname:\"Erik Bernhardsson\"", {"per_page": 5}))curl -X POST https://api.bowmark.ai/v1/sites/github/searchUsers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"fullname:\"Erik Bernhardsson\"","options":{"per_page":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.searchUsers("fullname:\"Erik Bernhardsson\"", { per_page: 5 });
createCommentAdds a comment to an issue or pull request, off github.com's own issue-viewer web mutation (POST…Arguments
Name Type Required ownerstringYes repostringYes issueNumbernumberYes bodystringYes Returns
GithubCommentResultinterface GithubCommentResult { comment: { body: string; [key: string]: unknown }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/createCommentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.createComment("<owner>", "<repo>", 1, "<body>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.createComment("<owner>", "<repo>", 1, "<body>"))curl -X POST https://api.bowmark.ai/v1/sites/github/createComment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"<owner>","repo":"<repo>","issueNumber":1,"body":"<body>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.createComment("<owner>", "<repo>", 1, "<body>");createIssueOpens a new issue on a repository, off github.com's own issue-creation mutation (POST /_ghui/issues?queryId=..., the persisted-GraphQL door the…Arguments
Name Type Required ownerstringYes repostringYes titlestringYes options{ body?: string; repositoryId?: string }No Returns
GithubCreateIssueResultinterface GithubCreateIssueResult { issue: { number?: number; title?: string; [key: string]: unknown }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/createIssueCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.createIssue("<owner>", "<repo>", "<title>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.createIssue("<owner>", "<repo>", "<title>"))curl -X POST https://api.bowmark.ai/v1/sites/github/createIssue \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"<owner>","repo":"<repo>","title":"<title>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.createIssue("<owner>", "<repo>", "<title>");createPullRequestOpens a pull request from head into base for the signed-in caller, off github.com's own compare page: it loads…Arguments
Name Type Required ownerstringYes repostringYes titlestringYes headstringYes basestringYes options{ body?: string; draft?: boolean }No Returns
GithubPullRequestCreatedinterface GithubPullRequestCreated { number: number; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/createPullRequestCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.createPullRequest("<owner>", "<repo>", "<title>", "<head>", "<base>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.createPullRequest("<owner>", "<repo>", "<title>", "<head>", "<base>"))curl -X POST https://api.bowmark.ai/v1/sites/github/createPullRequest \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"<owner>","repo":"<repo>","title":"<title>","head":"<head>","base":"<base>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.createPullRequest("<owner>", "<repo>", "<title>", "<head>", "<base>");createReviewSubmits a review on a pull request for the signed-in caller (approve, request changes, or comment), off github.com's own review box (PUT…Arguments
Name Type Required ownerstringYes repostringYes pullNumbernumberYes review{ event: 'approve' | 'request_changes' | 'comment'; body?: string; headSha?: string }Yes Returns
GithubReviewResultinterface GithubReviewResult { repository: string; pullNumber: number; event: "APPROVE" | "REQUEST_CHANGES" | "COMMENT"; submitted: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/createReviewCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.createReview("<owner>", "<repo>", 1, {});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.createReview("<owner>", "<repo>", 1, {}))curl -X POST https://api.bowmark.ai/v1/sites/github/createReview \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"<owner>","repo":"<repo>","pullNumber":1,"review":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.createReview("<owner>", "<repo>", 1, {});createReviewCommentAdds an inline comment to a line, a line range or a whole file in a pull request's diff for the signed-in caller, off github.com's own Files-changed…Arguments
Name Type Required ownerstringYes repostringYes pullNumbernumberYes comment{ body: string; path: string; line?: number; side?: 'left' | 'right'; startLine?: number; startSide?: 'left' | 'right'; headSha?: string; baseSha?: string }Yes Returns
GithubReviewCommentResultinterface GithubReviewCommentResult { repository: string; pullNumber: number; path: string; line: number | null; // null for a comment on the whole file comment: unknown; // GitHub's own comment payload when the reply carried one, else null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/createReviewCommentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.createReviewComment("<owner>", "<repo>", 1, {});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.createReviewComment("<owner>", "<repo>", 1, {}))curl -X POST https://api.bowmark.ai/v1/sites/github/createReviewComment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"<owner>","repo":"<repo>","pullNumber":1,"comment":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.createReviewComment("<owner>", "<repo>", 1, {});deleteCommentDeletes a comment on an issue or pull request, off github.com's own issue-viewer web mutation (DELETE…Arguments
Name Type Required ownerstringYes repostringYes issueNumbernumberYes commentIdnumberYes Returns
GithubCommentResultinterface GithubCommentResult { comment: { body: string; [key: string]: unknown }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/deleteCommentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.deleteComment("<owner>", "<repo>", 1, 1);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.deleteComment("<owner>", "<repo>", 1, 1))curl -X POST https://api.bowmark.ai/v1/sites/github/deleteComment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"<owner>","repo":"<repo>","issueNumber":1,"commentId":1}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.deleteComment("<owner>", "<repo>", 1, 1);mergePullRequestMerges a pull request into its base branch for the signed-in caller, off github.com's own merge box (POST…Arguments
Name Type Required ownerstringYes repostringYes pullNumbernumberYes options{ mergeMethod?: 'merge' | 'squash' | 'rebase'; commitTitle?: string; commitMessage?: string }No Returns
GithubMergeResultinterface GithubMergeResult { repository: string; pullNumber: number; mergeMethod: "MERGE" | "SQUASH" | "REBASE"; merged: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/mergePullRequestCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.mergePullRequest("<owner>", "<repo>", 1);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.mergePullRequest("<owner>", "<repo>", 1))curl -X POST https://api.bowmark.ai/v1/sites/github/mergePullRequest \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"<owner>","repo":"<repo>","pullNumber":1}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.mergePullRequest("<owner>", "<repo>", 1);starRepositoryStars a repository for the signed-in caller, off github.com's own star form (POST /{owner}/{repo}/star).Arguments
Name Type Required ownerstringYes repostringYes Returns
GithubStarResultinterface GithubStarResult { repository: string; starred: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/starRepositoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.starRepository("<owner>", "<repo>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.starRepository("<owner>", "<repo>"))curl -X POST https://api.bowmark.ai/v1/sites/github/starRepository \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"<owner>","repo":"<repo>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.starRepository("<owner>", "<repo>");unstarRepositoryUnstars a repository for the signed-in caller, off github.com's own unstar form (POST /{owner}/{repo}/unstar).Arguments
Name Type Required ownerstringYes repostringYes Returns
GithubStarResultinterface GithubStarResult { repository: string; starred: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/unstarRepositoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.unstarRepository("<owner>", "<repo>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.unstarRepository("<owner>", "<repo>"))curl -X POST https://api.bowmark.ai/v1/sites/github/unstarRepository \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"<owner>","repo":"<repo>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.unstarRepository("<owner>", "<repo>");unwatchRepositoryStops watching a repository for the signed-in caller, returning it to GitHub's default 'participating and @mentions' state (POST…Arguments
Name Type Required ownerstringYes repostringYes Returns
GithubSubscriptionResultinterface GithubSubscriptionResult { repository: string; subscription: "subscribed" | "included"; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/unwatchRepositoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.unwatchRepository("<owner>", "<repo>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.unwatchRepository("<owner>", "<repo>"))curl -X POST https://api.bowmark.ai/v1/sites/github/unwatchRepository \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"<owner>","repo":"<repo>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.unwatchRepository("<owner>", "<repo>");updateCommentEdits an existing comment on an issue or pull request, off github.com's own issue-viewer web mutation (PATCH…Arguments
Name Type Required ownerstringYes repostringYes issueNumbernumberYes commentIdnumberYes bodystringYes Returns
GithubCommentResultinterface GithubCommentResult { comment: { body: string; [key: string]: unknown }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/updateCommentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.updateComment("<owner>", "<repo>", 1, 1, "<body>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.updateComment("<owner>", "<repo>", 1, 1, "<body>"))curl -X POST https://api.bowmark.ai/v1/sites/github/updateComment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"<owner>","repo":"<repo>","issueNumber":1,"commentId":1,"body":"<body>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.updateComment("<owner>", "<repo>", 1, 1, "<body>");updateIssueRenames an issue's TITLE off github.com's own issue-viewer web mutation (PUT /{owner}/{repo}/issues/{number}/title).Arguments
Name Type Required ownerstringYes repostringYes issueNumbernumberYes updates{ title: string }Yes Returns
GithubUpdateIssueTitleResultinterface GithubUpdateIssueTitleResult { issue: { title: string; [key: string]: unknown }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/updateIssueCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.updateIssue("<owner>", "<repo>", 1, {});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.updateIssue("<owner>", "<repo>", 1, {}))curl -X POST https://api.bowmark.ai/v1/sites/github/updateIssue \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"<owner>","repo":"<repo>","issueNumber":1,"updates":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.updateIssue("<owner>", "<repo>", 1, {});updatePullRequestRenames a pull request's TITLE, off the same issue-viewer web mutation (PUT /{owner}/{repo}/issues/{number}/title) updateIssue uses.Arguments
Name Type Required ownerstringYes repostringYes pullNumbernumberYes updates{ title: string }Yes Returns
GithubUpdateIssueTitleResultinterface GithubUpdateIssueTitleResult { issue: { title: string; [key: string]: unknown }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/updatePullRequestCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.updatePullRequest("<owner>", "<repo>", 1, {});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.updatePullRequest("<owner>", "<repo>", 1, {}))curl -X POST https://api.bowmark.ai/v1/sites/github/updatePullRequest \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"<owner>","repo":"<repo>","pullNumber":1,"updates":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.updatePullRequest("<owner>", "<repo>", 1, {});watchRepositoryWatches a repository (all activity) for the signed-in caller, off github.com's own watch-dropdown mutation (POST /notifications/subscribe…Arguments
Name Type Required ownerstringYes repostringYes Returns
GithubSubscriptionResultinterface GithubSubscriptionResult { repository: string; subscription: "subscribed" | "included"; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/github/watchRepositoryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.github.watchRepository("<owner>", "<repo>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.github.watchRepository("<owner>", "<repo>"))curl -X POST https://api.bowmark.ai/v1/sites/github/watchRepository \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"owner":"<owner>","repo":"<repo>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.github.watchRepository("<owner>", "<repo>");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/github/<function> - OpenAPI
/v1/sites/github/openapi.json