Skip to content

Commit 4ec44a2

Browse files
tmelliottjrtmelliottjr
committed
consolidate tools
1 parent 4552ede commit 4ec44a2

5 files changed

Lines changed: 901 additions & 2176 deletions

File tree

‎pkg/github/__toolsnaps__/project_read.snap‎

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
{
2+
"annotations": {
3+
"title": "Read project information",
4+
"readOnlyHint": true
5+
},
6+
"description": "Perform read operations on GitHub Projects V2 for a user or organization.\n\nAvailable methods:\n- get_project: Get details of a specific project\n- list_projects: List all projects for a user or organization\n- get_project_field: Get details of a specific project field\n- list_project_fields: List all fields in a project\n- get_project_item: Get details of a specific project item\n- list_project_items: List all items in a project with optional filtering\n\n**Recommended workflow:**\n1. Use list_projects to discover available projects\n2. Use list_project_fields to get field definitions and IDs (essential for step 3)\n3. Use list_project_items with 'fields' parameter (using IDs from step 2) to get items with custom field values\n4. Optionally use 'query' parameter to filter items (e.g., 'is:open', 'assignee:@me', '-is:archived')\n\nAll methods require owner and owner_type parameters. Additional parameters vary by method.",
7+
"inputSchema": {
8+
"properties": {
9+
"after": {
10+
"description": "Cursor for pagination. Use the endCursor from the previous page's PageInfo for GraphQL APIs.",
11+
"type": "string"
12+
},
13+
"field_id": {
14+
"description": "The field's ID. Required for: get_project_field.",
15+
"type": "number"
16+
},
17+
"fields": {
18+
"description": "Specific list of field IDs to include in the response (e.g. [\"102589\", \"985201\", \"169875\"]). If not provided, only the title field is included. Used by: get_project_item, list_project_items.\n\n**Important:** To get field IDs, you must first call this tool with method=\"list_project_fields\" to retrieve all available fields and their IDs for the project. Then use those field IDs here to include field values in item responses. Without specifying field IDs, you won't get custom field values like Status, Priority, etc.",
19+
"items": {
20+
"type": "string"
21+
},
22+
"type": "array"
23+
},
24+
"item_id": {
25+
"description": "The item's ID. Required for: get_project_item.",
26+
"type": "number"
27+
},
28+
"method": {
29+
"description": "The read operation to perform.\nOptions are:\n- get_project: Get details of a specific project (requires: project_number)\n- list_projects: List projects (optional: query, per_page)\n- get_project_field: Get a specific field (requires: project_number, field_id)\n- list_project_fields: List project fields (requires: project_number, optional: per_page) - **Call this first before list_project_items to obtain field IDs**\n- get_project_item: Get a specific item (requires: project_number, item_id, optional: fields)\n- list_project_items: List project items (requires: project_number, optional: query, per_page, fields) - **Use 'fields' parameter with IDs from list_project_fields to include custom field values**\n",
30+
"enum": [
31+
"get_project",
32+
"list_projects",
33+
"get_project_field",
34+
"list_project_fields",
35+
"get_project_item",
36+
"list_project_items"
37+
],
38+
"type": "string"
39+
},
40+
"owner": {
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+
"type": "string"
43+
},
44+
"owner_type": {
45+
"description": "Owner type: 'user' or 'org'",
46+
"enum": [
47+
"user",
48+
"org"
49+
],
50+
"type": "string"
51+
},
52+
"perPage": {
53+
"description": "Results per page for pagination (min 1, max 100)",
54+
"maximum": 100,
55+
"minimum": 1,
56+
"type": "number"
57+
},
58+
"per_page": {
59+
"description": "Number of results per page (max 100, default: 30). Used by: list_projects, list_project_fields, list_project_items.",
60+
"type": "number"
61+
},
62+
"project_number": {
63+
"description": "The project's number. Required for: get_project, get_project_field, list_project_fields, get_project_item, list_project_items.",
64+
"type": "number"
65+
},
66+
"query": {
67+
"description": "Search query to filter results. Used by: list_projects (matches title and description), list_project_items (filters items using GitHub's project query syntax).\n\nFor list_project_items, supports:\n- State filters: 'is:open', 'is:closed', '-is:archived' (use '-' to negate)\n- Assignee filters: 'assignee:@me', 'assignee:username', 'no:assignee'\n- Label filters: 'label:bug', 'label:\"needs review\"'\n- Field filters: 'status:\"In Progress\"', 'priority:high'\n- Combining filters: 'assignee:@me status:\"In Progress\" is:open'\nExamples: 'is:open -is:archived', 'assignee:@me is:open', 'label:bug status:todo'",
68+
"type": "string"
69+
}
70+
},
71+
"required": [
72+
"method",
73+
"owner_type",
74+
"owner"
75+
],
76+
"type": "object"
77+
},
78+
"name": "project_read"
79+
}

‎pkg/github/__toolsnaps__/project_write.snap‎

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
{
2+
"annotations": {
3+
"title": "Modify project items",
4+
"readOnlyHint": false
5+
},
6+
"description": "Perform write operations on GitHub Projects V2 for a user or organization.\n\nAvailable methods:\n- add_project_item: Add an issue or pull request to a project\n- update_project_item: Update field values for a project item\n- delete_project_item: Remove an item from a project\n\nAll methods require owner, owner_type, project_number, and item_id parameters (except add_project_item which uses item_id as the issue/PR ID to add).",
7+
"inputSchema": {
8+
"properties": {
9+
"item_id": {
10+
"description": "For add_project_item: The numeric ID of the issue or pull request to add. For update_project_item and delete_project_item: The unique identifier of the project item (not the issue/PR ID).",
11+
"type": "number"
12+
},
13+
"item_type": {
14+
"description": "The type of item to add: 'issue' or 'pull_request'. Required for: add_project_item.",
15+
"enum": [
16+
"issue",
17+
"pull_request"
18+
],
19+
"type": "string"
20+
},
21+
"method": {
22+
"description": "The write operation to perform.\nOptions are:\n- add_project_item: Add an issue or pull request to a project (requires: item_type, item_id)\n- update_project_item: Update field values for an item (requires: item_id, updated_field)\n- delete_project_item: Remove an item from a project (requires: item_id)\n",
23+
"enum": [
24+
"add_project_item",
25+
"update_project_item",
26+
"delete_project_item"
27+
],
28+
"type": "string"
29+
},
30+
"owner": {
31+
"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.",
32+
"type": "string"
33+
},
34+
"owner_type": {
35+
"description": "Owner type: 'user' or 'org'",
36+
"enum": [
37+
"user",
38+
"org"
39+
],
40+
"type": "string"
41+
},
42+
"project_number": {
43+
"description": "The project's number.",
44+
"type": "number"
45+
},
46+
"updated_field": {
47+
"description": "Object with the field ID and new value. Required for: update_project_item. Format: {\"id\": 123456, \"value\": \"New Value\"}. To clear a field, set value to null. Value types vary by field type: text fields use strings, single-select fields use option IDs (numbers), date fields use ISO date strings, number fields use numbers.",
48+
"properties": {},
49+
"type": "object"
50+
}
51+
},
52+
"required": [
53+
"method",
54+
"owner_type",
55+
"owner",
56+
"project_number",
57+
"item_id"
58+
],
59+
"type": "object"
60+
},
61+
"name": "project_write"
62+
}

0 commit comments

Comments
 (0)