Skip to content

Commit bdd21a5

Browse files
committed
initial projects consolidation
1 parent 63c7db0 commit bdd21a5

File tree

7 files changed

+1679
-9
lines changed

7 files changed

+1679
-9
lines changed

README.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -973,6 +973,35 @@ The following sets of tools are available:
973973
- `per_page`: Results per page (max 50) (number, optional)
974974
- `query`: Filter projects by title text and open/closed state; permitted qualifiers: is:open, is:closed; examples: "roadmap is:open", "is:open feature planning". (string, optional)
975975

976+
- **projects_get** - Get details of GitHub Projects resources
977+
- `field_id`: The field's ID. Required for 'get_project_field' method. (number, optional)
978+
- `fields`: Specific list of field IDs to include in the response when getting a project item (e.g. ["102589", "985201", "169875"]). If not provided, only the title field is included. Only used for 'get_project_item' method. (string[], optional)
979+
- `item_id`: The item's ID. Required for 'get_project_item' method. (number, optional)
980+
- `method`: The method to execute (string, required)
981+
- `owner`: If owner_type == user it is the handle for the GitHub user account. If owner_type == org it is the name of the organization. The name is not case sensitive. (string, required)
982+
- `owner_type`: Owner type (string, required)
983+
- `project_number`: The project's number. (number, required)
984+
985+
- **projects_list** - List GitHub Projects resources
986+
- `after`: Forward pagination cursor from previous pageInfo.nextCursor. (string, optional)
987+
- `before`: Backward pagination cursor from previous pageInfo.prevCursor (rare). (string, optional)
988+
- `fields`: Field IDs to include when listing project items (e.g. ["102589", "985201"]). CRITICAL: Always provide to get field values. Without this, only titles returned. Only used for 'list_project_items' method. (string[], optional)
989+
- `method`: The action to perform (string, required)
990+
- `owner`: If owner_type == user it is the handle for the GitHub user account. If owner_type == org it is the name of the organization. The name is not case sensitive. (string, required)
991+
- `owner_type`: Owner type (string, required)
992+
- `per_page`: Results per page (max 50) (number, optional)
993+
- `project_number`: The project's number. Required for 'list_project_fields' and 'list_project_items' methods. (number, optional)
994+
- `query`: Filter/query string. For list_projects: filter by title text and state (e.g. "roadmap is:open"). For list_project_items: advanced filtering using GitHub's project filtering syntax. (string, optional)
995+
996+
- **projects_write** - Modify GitHub Project items
997+
- `item_id`: The project item ID. Required for 'update_project_item' and 'delete_project_item' methods. For add_project_item, this is the numeric ID of the issue or pull request to add. (number, optional)
998+
- `item_type`: The item's type, either issue or pull_request. Required for 'add_project_item' method. (string, optional)
999+
- `method`: The method to execute (string, required)
1000+
- `owner`: If owner_type == user it is the handle for the GitHub user account. If owner_type == org it is the name of the organization. The name is not case sensitive. (string, required)
1001+
- `owner_type`: Owner type (string, required)
1002+
- `project_number`: The project's number. (number, required)
1003+
- `updated_field`: Object consisting of the ID of the project field to update and the new value for the field. To clear the field, set value to null. Example: {"id": 123456, "value": "New Value"}. Required for 'update_project_item' method. (object, optional)
1004+
9761005
- **update_project_item** - Update project item
9771006
- `item_id`: The unique identifier of the project item. This is not the issue or pull request ID. (number, required)
9781007
- `owner`: If owner_type == user it is the handle for the GitHub user account. If owner_type == org it is the name of the organization. The name is not case sensitive. (string, required)
Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
{
2+
"annotations": {
3+
"readOnlyHint": true,
4+
"title": "Get details of GitHub Projects resources"
5+
},
6+
"description": "Get details about specific GitHub Projects resources.\nUse this tool to get details about individual projects, project fields, and project items by their unique IDs.\n",
7+
"inputSchema": {
8+
"type": "object",
9+
"required": [
10+
"method",
11+
"owner_type",
12+
"owner",
13+
"project_number"
14+
],
15+
"properties": {
16+
"field_id": {
17+
"type": "number",
18+
"description": "The field's ID. Required for 'get_project_field' method."
19+
},
20+
"fields": {
21+
"type": "array",
22+
"description": "Specific list of field IDs to include in the response when getting a project item (e.g. [\"102589\", \"985201\", \"169875\"]). If not provided, only the title field is included. Only used for 'get_project_item' method.",
23+
"items": {
24+
"type": "string"
25+
}
26+
},
27+
"item_id": {
28+
"type": "number",
29+
"description": "The item's ID. Required for 'get_project_item' method."
30+
},
31+
"method": {
32+
"type": "string",
33+
"description": "The method to execute",
34+
"enum": [
35+
"get_project",
36+
"get_project_field",
37+
"get_project_item"
38+
]
39+
},
40+
"owner": {
41+
"type": "string",
42+
"description": "If owner_type == user it is the handle for the GitHub user account. If owner_type == org it is the name of the organization. The name is not case sensitive."
43+
},
44+
"owner_type": {
45+
"type": "string",
46+
"description": "Owner type",
47+
"enum": [
48+
"user",
49+
"org"
50+
]
51+
},
52+
"project_number": {
53+
"type": "number",
54+
"description": "The project's number."
55+
}
56+
}
57+
},
58+
"name": "projects_get"
59+
}
Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
{
2+
"annotations": {
3+
"readOnlyHint": true,
4+
"title": "List GitHub Projects resources"
5+
},
6+
"description": "Tools for listing GitHub Projects resources.\nUse this tool to list projects for a user or organization, or list project fields and items for a specific project.\n",
7+
"inputSchema": {
8+
"type": "object",
9+
"required": [
10+
"method",
11+
"owner_type",
12+
"owner"
13+
],
14+
"properties": {
15+
"after": {
16+
"type": "string",
17+
"description": "Forward pagination cursor from previous pageInfo.nextCursor."
18+
},
19+
"before": {
20+
"type": "string",
21+
"description": "Backward pagination cursor from previous pageInfo.prevCursor (rare)."
22+
},
23+
"fields": {
24+
"type": "array",
25+
"description": "Field IDs to include when listing project items (e.g. [\"102589\", \"985201\"]). CRITICAL: Always provide to get field values. Without this, only titles returned. Only used for 'list_project_items' method.",
26+
"items": {
27+
"type": "string"
28+
}
29+
},
30+
"method": {
31+
"type": "string",
32+
"description": "The action to perform",
33+
"enum": [
34+
"list_projects",
35+
"list_project_fields",
36+
"list_project_items"
37+
]
38+
},
39+
"owner": {
40+
"type": "string",
41+
"description": "If owner_type == user it is the handle for the GitHub user account. If owner_type == org it is the name of the organization. The name is not case sensitive."
42+
},
43+
"owner_type": {
44+
"type": "string",
45+
"description": "Owner type",
46+
"enum": [
47+
"user",
48+
"org"
49+
]
50+
},
51+
"per_page": {
52+
"type": "number",
53+
"description": "Results per page (max 50)"
54+
},
55+
"project_number": {
56+
"type": "number",
57+
"description": "The project's number. Required for 'list_project_fields' and 'list_project_items' methods."
58+
},
59+
"query": {
60+
"type": "string",
61+
"description": "Filter/query string. For list_projects: filter by title text and state (e.g. \"roadmap is:open\"). For list_project_items: advanced filtering using GitHub's project filtering syntax."
62+
}
63+
}
64+
},
65+
"name": "projects_list"
66+
}
Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
{
2+
"annotations": {
3+
"destructiveHint": true,
4+
"title": "Modify GitHub Project items"
5+
},
6+
"description": "Add, update, or delete project items in a GitHub Project.",
7+
"inputSchema": {
8+
"type": "object",
9+
"required": [
10+
"method",
11+
"owner_type",
12+
"owner",
13+
"project_number"
14+
],
15+
"properties": {
16+
"item_id": {
17+
"type": "number",
18+
"description": "The project item ID. Required for 'update_project_item' and 'delete_project_item' methods. For add_project_item, this is the numeric ID of the issue or pull request to add."
19+
},
20+
"item_type": {
21+
"type": "string",
22+
"description": "The item's type, either issue or pull_request. Required for 'add_project_item' method.",
23+
"enum": [
24+
"issue",
25+
"pull_request"
26+
]
27+
},
28+
"method": {
29+
"type": "string",
30+
"description": "The method to execute",
31+
"enum": [
32+
"add_project_item",
33+
"update_project_item",
34+
"delete_project_item"
35+
]
36+
},
37+
"owner": {
38+
"type": "string",
39+
"description": "If owner_type == user it is the handle for the GitHub user account. If owner_type == org it is the name of the organization. The name is not case sensitive."
40+
},
41+
"owner_type": {
42+
"type": "string",
43+
"description": "Owner type",
44+
"enum": [
45+
"user",
46+
"org"
47+
]
48+
},
49+
"project_number": {
50+
"type": "number",
51+
"description": "The project's number."
52+
},
53+
"updated_field": {
54+
"type": "object",
55+
"description": "Object consisting of the ID of the project field to update and the new value for the field. To clear the field, set value to null. Example: {\"id\": 123456, \"value\": \"New Value\"}. Required for 'update_project_item' method."
56+
}
57+
}
58+
},
59+
"name": "projects_write"
60+
}

0 commit comments

Comments
 (0)