withoneai 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
- Find the action in the table below, or call
search_one_platform_actionswith platformgithubif it is not listed. - Call
get_one_action_knowledgewith the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters. - Call
execute_one_actionwith 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 |
| Create an Organization Repository | POST | /orgs/{{org}}/repos |
conn_mod_def::GJ3Z5epxmv8::TxvdRb8uQdqkblorOGCl0Q |
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 |
conn_mod_def::GJ3ZSr1g-Rc::It-wmVulR2S2xotoru3CHg |
| Remove a Dependency an Issue Is Blocked By (in a Repository) | DELETE | /repos/{{owner}}/{{repo}}/issues/{{issueNumber}}/dependencies/blocked_by/{{issueId}} |
conn_mod_def::GJ3ZTaACHbI::pFIUOJVKRteFNg06ZpIyVQ |
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 |
conn_mod_def::GJ3aU_fPyJQ::AMtfc0jvRvi7wd64dxa8jA |
| Delete a Team (Legacy) | DELETE | /teams/{{teamId}} |
conn_mod_def::GJ3aVN3gV1c::yLDLuOsuSZiIro9ZDum4fQ |
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 | DELETE | /orgs/{{org}}/members/{{username}}/codespaces/{{codespaceName}} |
conn_mod_def::GJ3Y6rFKAJ8::PVIKIwoOQ0yUY9I5sv0OPg |
| Delete the Authenticated User’s Codespace | DELETE | /user/codespaces/{{codespaceName}} |
conn_mod_def::GJ3Y6jgYbI4::Dg6Kc1IYQZKNcwqUK5ftFg |
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 |
| List a User’s Attestations by Bulk Subject Digests | POST | /users/{{username}}/attestations/bulk-list |
conn_mod_def::GJ3abqH2OoY::cHd3F6ElSrmhfxuQQ_kuKg |
| List an Organization’s Attestations by Bulk Subject Digests | POST | /orgs/{{org}}/attestations/bulk-list |
conn_mod_def::GJ3ZhBqUedM::Iq9-39RDRk2vy-tFc3m2_w |
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 |
| Remove a Repository from an Authenticated User's Codespaces Secret | DELETE | /user/codespaces/secrets/{{secretName}}/repositories/{{repositoryId}} |
conn_mod_def::GJ3Y-KBudnE::0F2JoVl5RMKlBJ_pHX-NGQ |
| Remove a Selected Repository from an Organization Codespaces Secret | DELETE | /orgs/{{org}}/codespaces/secrets/{{secret_name}}/repositories/{{repository_id}} |
conn_mod_def::GJ3Y-SovIRU::x6nO6abvSeGfqXd_HwWYwQ |
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.