github

name

github

description

GitHub is a code hosting and collaboration platform that enables developers to work together on projects, manage version control using Git, and deploy code with integrated CI/CD tools. Read and write GitHub data through One: repositories, issues, teams, codespaces, gists, attestations and more, 1093 actions with real parameter documentation. Use whenever the user asks to look something up in GitHub, create or update a record there, or build code against the GitHub API.

GitHub through One

GitHub is a code hosting and collaboration platform that enables developers to work together on projects, manage version control using Git, and deploy code with integrated CI/CD tools.

One exposes GitHub through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform github if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm GitHub is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real GitHub account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Repositories

Action	Method	Path	Action id
Check if Vulnerability Alerts Are Enabled for a Repository	GET	/repos/{{owner}}/{{repo}}/vulnerability-alerts	conn_mod_def::GJ3Z2zdE7UA::zs9-IUViQOS_jTSOCTec9g
Get a Repository	GET	/repos/{{owner}}/{{repo}}	conn_mod_def::GJ3Z__SN0V0::ucGQ66izT_y_Xjjd2mqxtA
List a User’s Repositories	GET	/users/{{username}}/repos	conn_mod_def::GJ3aJf8_YDY::AT5O656ISq-Cu-oK_o6iwg
List an Organization Team’s Repositories	GET	/orgs/{{org}}/teams/{{teamSlug}}/repos	conn_mod_def::GJ3aW12kd0s::ClWylhJJQGqwyVBGHseVnA
List an Organization’s Repositories	GET	/orgs/{{org}}/repos	conn_mod_def::GJ3aImbME-4::YOGUy_fSTwG_O0tjcZvLPQ
List Public Repositories	GET	/repositories	conn_mod_def::GJ3aI7VUveU::c9xSM0j9SZKohYowBNP9tQ
List Repositories for an Authenticated User Migration	GET	/user/migrations/{{migrationId}}/repositories	conn_mod_def::GJ3ZXSkWPu8::9dhlyevyR7qzZZ8jwoBGAA
List Repositories for the Authenticated User	GET	/user/repos	conn_mod_def::GJ3aJv0FLn0::-lTycDc4TMG2EV3FIxpXVA
Search Repositories	GET	/search/repositories	conn_mod_def::GJ3aQlvgUK8::J8cbD6_UTzK4GCP9MEJFIw
Create a Repository for the Authenticated User	POST	/user/repos	conn_mod_def::GJ3Z4tE4G5A::lTHBrlzlSouqu-x8AHeT3Q
Create a Repository Using a Template	POST	/repos/{{templateOwner}}/{{templateRepo}}/generate	conn_mod_def::GJ3Z4-moP9Q::5l2pvnlPSZqndVlJwFVUTQ

8 more Repositories actions are available through search.

Issues

Action	Method	Path	Action id
Get a Repository Issue	GET	/repos/{{owner}}/{{repo}}/issues/{{issue_number}}	conn_mod_def::GJ3ZPdCHwHA::Q4jcBemHQrqbLH99sC0cPQ
Get a Repository Issue’s Parent Issue	GET	/repos/{{owner}}/{{repo}}/issues/{{issue_number}}/parent	conn_mod_def::GJ3ZP0XI0BE::r9_ZZ8ZNT7SJrkTZQLtXWA
List a Repository’s Issues	GET	/repos/{{owner}}/{{repo}}/issues	conn_mod_def::GJ3ZSGEEgYo::s9O90_JUTgGLK5TSNPlZxw
List an Issue’s Sub-Issues	GET	/repos/{{owner}}/{{repo}}/issues/{{issue_number}}/sub_issues	conn_mod_def::GJ3ZSOzCznc::1R73ort3RICOViG76M0ZOw
List Dependencies an Issue Is Blocking	GET	/repos/{{owner}}/{{repo}}/issues/{{issueNumber}}/dependencies/blocking	conn_mod_def::GJ3ZQN0mmSU::9b6dfUE0S9SNoAp_d_S2iA
List Issues Assigned to the Authenticated User	GET	/issues	conn_mod_def::GJ3ZRK0QX5o::6KJNkfJsTq-Xg6GbV2YeXQ
List Issues for the Authenticated User	GET	/user/issues	conn_mod_def::GJ3ZSjn5AFI::n22CC9-AS-OClqbfc9nQaw
Add a Sub-Issue to an Issue	POST	/repos/{{owner}}/{{repo}}/issues/{{issueNumber}}/sub_issues	conn_mod_def::GJ3ZN2f7jXQ::yAvab5w4RAqahErzOtbXjg
Add Assignees to a Repository Issue	POST	/repos/{{owner}}/{{repo}}/issues/{{issueNumber}}/assignees	conn_mod_def::GJ3ZNcQOZCE::sp4gI7LVS8K40RI9_8gfzA
Create an Issue for a Repository	POST	/repos/{{owner}}/{{repo}}/issues	conn_mod_def::GJ3ZOgmKVac::6mksPa9nTK-WqE9cw3w6sg
Lock a Repository Issue or Pull Request Conversation	PUT	/repos/{{owner}}/{{repo}}/issues/{{issueNumber}}/lock

6 more Issues actions are available through search.

Teams

Action	Method	Path	Action id
Check a Team’s Permissions for a Repository (Legacy)	GET	/teams/{{teamId}}/repos/{{owner}}/{{repo}}	conn_mod_def::GJ3aU36k8Ag::peANNuxdSxGAxoOIaF2gLw
Get a Legacy Team by ID	GET	/teams/{{teamId}}	conn_mod_def::GJ3aVWrLsbw::DCU3Us-DQlmGqwG4k8fWbw
Get a Legacy Team Member	GET	/teams/{{teamId}}/members/{{username}}	conn_mod_def::GJ3aVlKv4Mw::EEHCvTe3TCSi8ac0d0VnMA
Get a Team by Name (Org + Team Slug)	GET	/orgs/{{org}}/teams/{{teamSlug}}	conn_mod_def::GJ3aVdswEFQ::gbv0BXs_R3-WW4oyDbrP0Q
List a Team’s Child Teams (Legacy)	GET	/teams/{{teamId}}/teams	conn_mod_def::GJ3aWHo9VAI::iN_ispBST7uqrVyibcV0zQ
List an Organization Team’s Child Teams	GET	/orgs/{{org}}/teams/{{teamSlug}}/teams	conn_mod_def::GJ3aV_LSrhk::1p3rYQ9mRd-tv5q0Ab3wDg
List an Organization’s Teams	GET	/orgs/{{org}}/teams	conn_mod_def::GJ3aXGxO-q8::I74wmqvNTveBorEgUpL0_A
List Teams for the Authenticated User	GET	/user/teams	conn_mod_def::GJ3aXQqLOwA::vOwOMKCRSFq4LIE98z0a4w
List Teams with Access to a Protected Branch (Repository)	GET	/repos/{{owner}}/{{repo}}/branches/{{branch}}/protection/restrictions/teams	conn_mod_def::GJ3aElMO_Fw::Te9-vBNASo6m6csZI9kGrQ
Add or Update a Team’s Repository Permissions in an Organization	PUT	/orgs/{{org}}/teams/{{teamSlug}}/repos/{{owner}}/{{repo}}	conn_mod_def::GJ3aUW7UrHA::8T06pWRIRK-jnl4SeBaWRQ
Create an Organization Team	POST	/orgs/{{org}}/teams

5 more Teams actions are available through search.

Codespaces

Action	Method	Path	Action id
Check a Devcontainer Permission Acceptance for a Repository	GET	/repos/{{owner}}/{{repo}}/codespaces/permissions_check	conn_mod_def::GJ3Y5eQo_jI::feeFOfuXR9-9VMKOZFrvLQ
Get an Authenticated User's Codespace	GET	/user/codespaces/{{codespaceName}}	conn_mod_def::GJ3Y7TGaU_Q::giSFi86lS9uHhK3TyAzkng
Get Default Attributes for a New Codespace in a Repository	GET	/repos/{{owner}}/{{repo}}/codespaces/new	conn_mod_def::GJ3Y8CF96fw::R3RpdRXvRe2VOin-IvOymg
List a User's Codespaces in an Organization	GET	/orgs/{{org}}/members/{{username}}/codespaces	conn_mod_def::GJ3Y8jGlf7A::sxSR3fsPRYGT-2malzz5FQ
List an Organization’s Codespaces	GET	/orgs/{{org}}/codespaces	conn_mod_def::GJ3Y80U7fyY::l_wQIUN7R5mMAV29WhO1hQ
List Codespaces in a Repository for the Authenticated User	GET	/repos/{{owner}}/{{repo}}/codespaces	conn_mod_def::GJ3Y89m8a-E::_D0vlj8GTeuMiYPeRx-gkA
List the Authenticated User’s Codespaces	GET	/user/codespaces	conn_mod_def::GJ3Y8r8-Tyg::7DY0bi9BTkGu90OeE5yAjw
Create a Codespace for a Pull Request (Authenticated User)	POST	/repos/{{owner}}/{{repo}}/pulls/{{pullNumber}}/codespaces	conn_mod_def::GJ3Y5xDxlQQ::ZHiWi98rQF-S9VWHDaZYJQ
Create a Codespace for the Authenticated User	POST	/user/codespaces	conn_mod_def::GJ3Y5lolKEA::iDP7BBk3TOe1Mi7UnKye1g
Create a Repository Codespace (Authenticated User)	POST	/repos/{{owner}}/{{repo}}/codespaces	conn_mod_def::GJ3Y57YgEcY::MTN4KULyT4CTKup6FrI_FA
Delete an Organization Member's Codespace

5 more Codespaces actions are available through search.

Gists

Action	Method	Path	Action id
Check if a Gist is Starred	GET	/gists/{{gistId}}/star	conn_mod_def::GJ3ZHGrmsPM::kTTDKxh8S8uO1h5NCn4phQ
Get a Gist	GET	/gists/{{gistId}}	conn_mod_def::GJ3ZHzEfRbI::Qnt9OGxRT069zN2-dva0xw
Get a Gist Revision	GET	/gists/{{gistId}}/{{sha}}	conn_mod_def::GJ3ZICDZqHs::ELENMAc2RAqa8Mg3xdXL9g
List a User’s Gists	GET	/users/{{username}}/gists	conn_mod_def::GJ3ZImTmPCo::niKw0zzmR_Odd49__qyZkQ
List Public Gists	GET	/gists/public	conn_mod_def::GJ3ZI1OXeGM::G-YUfoBnSIiUt2TjV819xQ
List the Authenticated User’s Gists	GET	/gists	conn_mod_def::GJ3ZIt6fyiE::Bw3uM-gYRAu8EzrS6WLngQ
List the Authenticated User’s Starred Gists	GET	/gists/starred	conn_mod_def::GJ3ZI9YQ2ww::n3Mvyo3vTsSEc8-XAbUewA
Create a Gist	POST	/gists	conn_mod_def::GJ3ZHOF9UwA::kVcwmUEwTvW6ELWRkw51tA
Delete a Gist	DELETE	/gists/{{gistId}}	conn_mod_def::GJ3ZHcApGV4::trJ7IyykRkejX_d3cgi7ZA
Fork a Gist	POST	/gists/{{gistId}}/forks	conn_mod_def::GJ3ZHrjaGrM::2UOLALlpR0uF_up9xopNLA
Star a Gist	PUT	/gists/{{gistId}}/star	conn_mod_def::GJ3ZJGB8PT0::kWkVc7ngQeeTQkWO_NKuJw
Unstar a Gist	DELETE	/gists/{{gistId}}/star	conn_mod_def::GJ3ZJMw4gbI::rQfsk7oZRq-3IhYwJ80aRQ

1 more Gists actions are available through search.

Attestations

Action	Method	Path	Action id
List a Repository’s Attestations by Subject Digest	GET	/repos/{{owner}}/{{repo}}/attestations/{{subjectDigest}}	conn_mod_def::GJ3aGHlZnD8::SzKByoU4Rkyn9poWJ6qn_g
List a User’s Attestations for a Subject Digest	GET	/users/{{username}}/attestations/{{subjectDigest}}	conn_mod_def::GJ3abgkS9sw::sk9uBpwnSs-wH8pWARN2Hg
List an Organization's Attestations by Subject Digest	GET	/orgs/{{org}}/attestations/{{subjectDigest}}	conn_mod_def::GJ3Zg22K_0k::2wW-hxPlTF-uoHkKYnt9bw
Create a Repository Attestation	POST	/repos/{{owner}}/{{repo}}/attestations	conn_mod_def::GJ3Z5PVS8sg::uUzhekANSr-0VrB-HasP1w
Delete a User's Attestation by ID	DELETE	/users/{{username}}/attestations/{{attestationId}}	conn_mod_def::GJ3aZ7owNSw::HNuV1fRYShaK7yvwUjNfgA
Delete a User's Attestations by Subject Digest	DELETE	/users/{{username}}/attestations/digest/{{subjectDigest}}	conn_mod_def::GJ3aaDs0OfA::CVuvD0R4SuakQreQgMalWQ
Delete a User’s Attestations in Bulk	POST	/users/{{username}}/attestations/delete-request	conn_mod_def::GJ3aaOFtqyY::UKYcpeHzQWmy-imMyfzeyQ
Delete an Organization’s Attestation by ID	DELETE	/orgs/{{org}}/attestations/{{attestationId}}	conn_mod_def::GJ3ZcJMo-50::9_fWWsQORHWfrvdeIwIqnQ
Delete an Organization's Attestations by Subject Digest	DELETE	/orgs/{{org}}/attestations/digest/{{subjectDigest}}	conn_mod_def::GJ3ZcQ-Zwuk::IwoD1N4nQu6L5Jng6yYr5g
Delete an Organization’s Attestations in Bulk (Delete Request)	POST	/orgs/{{org}}/attestations/delete-request	conn_mod_def::GJ3ZcaJAldw::zfk9qXHKSjKATohRnmEbog

CodespacesSecrets

Action	Method	Path	Action id
Get a Repository Codespaces Secret	GET	/repos/{{owner}}/{{repo}}/codespaces/secrets/{{secretName}}	conn_mod_def::GJ3Y7hONICM::x0BVqDZOQS6Zxxz-2qQ9vQ
Get an Authenticated User's Codespaces Secret	GET	/user/codespaces/secrets/{{secretName}}	conn_mod_def::GJ3Y7ozO-_o::Ww0HgGO0RCmZGYQGS4mVbA
List a Repository's Codespaces Secrets	GET	/repos/{{owner}}/{{repo}}/codespaces/secrets	conn_mod_def::GJ3Y9d6FHyk::zhyQPnSQRQu1TQixpDODFg
List an Organization’s Codespaces Secrets	GET	/orgs/{{org}}/codespaces/secrets	conn_mod_def::GJ3Y9Ua9zMI::P8SwKQhTRXCILZHK8SBxkg
List Codespaces Secrets for the Authenticated User	GET	/user/codespaces/secrets	conn_mod_def::GJ3Y9lsJh1Y::Vu3MaJQLSTeg73L14Ljlrg
Add a Selected Repository to an Authenticated User Codespaces Secret	PUT	/user/codespaces/secrets/{{secretName}}/repositories/{{repositoryId}}	conn_mod_def::GJ3Y5Gv092w::BjY_vSl3RXqvxuGyy_TwIg
Create or Update a Codespaces Secret for the Authenticated User	PUT	/user/codespaces/secrets/{{secretName}}	conn_mod_def::GJ3Y6UBeTb0::CSawkGY9SYm-8H0TzcRWIw
Create or Update a Repository Codespaces Secret	PUT	/repos/{{owner}}/{{repo}}/codespaces/secrets/{{secretName}}	conn_mod_def::GJ3Y6L6yme4::gfrafSROTWSesUwE-UseWA
Delete a Repository Codespaces Secret	DELETE	/repos/{{owner}}/{{repo}}/codespaces/secrets/{{secret_name}}	conn_mod_def::GJ3Y6yKgp8Q::sFvw4r83QT2_EQTsbDgrgA
Delete an Authenticated User's Codespaces Secret	DELETE	/user/codespaces/secrets/{{secretName}}	conn_mod_def::GJ3Y65xaFJQ::OwpPMqM1TwC7o_okkEK_nA

CodeSecurityConfigurations

Action	Method	Path	Action id
Get an Organization’s Code Security Configuration	GET	/orgs/{{org}}/code-security/configurations/{{configurationId}}	conn_mod_def::GJ3Y3H3OG8w::DAJAt5xmRzKUkhYRNdRmBA
Get an Organization’s Default Code Security Configurations	GET	/orgs/{{org}}/code-security/configurations/defaults	conn_mod_def::GJ3Y3g5hXBk::ltgd9uq0QHOu2pxbB1rqlA
List an Enterprise’s Code Security Configurations	GET	/enterprises/{{enterprise}}/code-security/configurations	conn_mod_def::GJ3Y3QNGfzw::3CQq3B7CSVajAbaYIFnV6Q
List an Organization's Code Security Configurations	GET	/orgs/{{org}}/code-security/configurations	conn_mod_def::GJ3Y3ZfdKg8::_qx-1hsMQdqzna2v2NfeRg
Attach a Code Security Configuration to an Organization’s Repositories	POST	/orgs/{{org}}/code-security/configurations/{{configurationId}}/attach	conn_mod_def::GJ3Y2RfqJaY::yUKAouQqRkytx2WCpqDgjQ
Create an Enterprise Code Security Configuration	POST	/enterprises/{{enterprise}}/code-security/configurations	conn_mod_def::GJ3Y2qcyudg::gNRrreEyTxOwgikl4PbdTQ

5 more CodeSecurityConfigurations actions are available through search.

This lists 90 of 1093 actions. For anything not here, call search_one_platform_actions with platform github. The full catalog is at https://www.withone.ai/knowledge/github.

When a call fails

The error comes from GitHub, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/github

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.