adoptai-mcp 1.0.0

package/dist/integrations/github-users/tools.js

@@ -0,0 +1,1118 @@
+import axios from 'axios';
+import { buildAuthHeaders } from './auth.js';
+
+const BASE_URL = 'https://api.github.com';
+const APP_ID = 'github-users';
+
+function handleError(err) {
+  const status = err.response?.status;
+  const msg = err.response?.data?.message || err.response?.data?.error || err.message;
+  if (status === 401) throw new Error(`Token invalid.\nRun: npx adoptai-${APP_ID}-mcp --client cursor`);
+  if (status === 403) throw new Error('Insufficient permissions. Check your API key scopes.');
+  if (status === 404) throw new Error('Resource not found. Check your parameters.');
+  if (status === 429) throw new Error('Rate limit exceeded. Please wait and try again.');
+  throw new Error(msg || 'API request failed');
+}
+
+async function apiRequest(method, pathTemplate, params = {}, opts = {}) {
+  const { deleteSendsJsonBody = false } = opts;
+  const headers = buildAuthHeaders();
+  let url = BASE_URL + pathTemplate;
+  const pathKeys = [...pathTemplate.matchAll(/\{([^}]+)\}/g)].map((m) => m[1]);
+  for (const key of pathKeys) {
+    const value = params[key];
+    if (value !== undefined && value !== null) url = url.replace(`{${key}}`, encodeURIComponent(String(value)));
+  }
+  const rest = { ...params };
+  for (const key of pathKeys) delete rest[key];
+  const m = method.toUpperCase();
+  const useQuery = m === 'GET' || (m === 'DELETE' && !deleteSendsJsonBody);
+  const queryParams = {};
+  const bodyParams = {};
+  for (const [key, value] of Object.entries(rest)) {
+    if (value === undefined) continue;
+    if (useQuery) queryParams[key] = value; else bodyParams[key] = value;
+  }
+  try {
+    const res = await axios({
+      method: m,
+      url,
+      headers: { 'Content-Type': 'application/json', ...headers },
+      params: Object.keys(queryParams).length ? queryParams : undefined,
+      data: Object.keys(bodyParams).length ? bodyParams : undefined,
+      timeout: 30000,
+    });
+    if (res.status === 204 || res.data === '' || res.data === undefined) return { ok: true, status: res.status };
+    return res.data;
+  } catch (err) {
+    handleError(err);
+  }
+}
+
+const ENDPOINTS = [
+  {
+    "name": "users_get_authenticated",
+    "description": "Get the authenticated user",
+    "method": "GET",
+    "path": "/user",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {},
+      "required": []
+    }
+  },
+  {
+    "name": "users_update_authenticated",
+    "description": "Update the authenticated user",
+    "method": "PATCH",
+    "path": "/user",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The new name of the user."
+        },
+        "email": {
+          "type": "string",
+          "description": "The publicly visible email address of the user."
+        },
+        "blog": {
+          "type": "string",
+          "description": "The new blog URL of the user."
+        },
+        "twitter_username": {
+          "type": "string",
+          "description": "The new Twitter username of the user."
+        },
+        "company": {
+          "type": "string",
+          "description": "The new company of the user."
+        },
+        "location": {
+          "type": "string",
+          "description": "The new location of the user."
+        },
+        "hireable": {
+          "type": "boolean",
+          "description": "The new hiring availability of the user."
+        },
+        "bio": {
+          "type": "string",
+          "description": "The new short biography of the user."
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "users_list_blocked_by_authenticated_user",
+    "description": "List users blocked by the authenticated user",
+    "method": "GET",
+    "path": "/user/blocks",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "users_check_blocked",
+    "description": "Check if a user is blocked by the authenticated user",
+    "method": "GET",
+    "path": "/user/blocks/{username}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        }
+      },
+      "required": [
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "users_block",
+    "description": "Block a user",
+    "method": "PUT",
+    "path": "/user/blocks/{username}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        }
+      },
+      "required": [
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "users_unblock",
+    "description": "Unblock a user",
+    "method": "DELETE",
+    "path": "/user/blocks/{username}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        }
+      },
+      "required": [
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "users_set_primary_email_visibility_for_authenticated_user",
+    "description": "Set primary email visibility for the authenticated user",
+    "method": "PATCH",
+    "path": "/user/email/visibility",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "visibility": {
+          "type": "string",
+          "description": "Denotes whether an email is publicly visible.",
+          "enum": [
+            "public",
+            "private"
+          ]
+        }
+      },
+      "required": [
+        "visibility"
+      ]
+    }
+  },
+  {
+    "name": "users_list_emails_for_authenticated_user",
+    "description": "List email addresses for the authenticated user",
+    "method": "GET",
+    "path": "/user/emails",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "users_add_email_for_authenticated_user",
+    "description": "Add an email address for the authenticated user",
+    "method": "POST",
+    "path": "/user/emails",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {},
+      "required": []
+    }
+  },
+  {
+    "name": "users_delete_email_for_authenticated_user",
+    "description": "Delete an email address for the authenticated user",
+    "method": "DELETE",
+    "path": "/user/emails",
+    "deleteSendsJsonBody": true,
+    "inputSchema": {
+      "type": "object",
+      "properties": {},
+      "required": []
+    }
+  },
+  {
+    "name": "users_list_followers_for_authenticated_user",
+    "description": "List followers of the authenticated user",
+    "method": "GET",
+    "path": "/user/followers",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "users_list_followed_by_authenticated_user",
+    "description": "List the people the authenticated user follows",
+    "method": "GET",
+    "path": "/user/following",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "users_check_person_is_followed_by_authenticated",
+    "description": "Check if a person is followed by the authenticated user",
+    "method": "GET",
+    "path": "/user/following/{username}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        }
+      },
+      "required": [
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "users_follow",
+    "description": "Follow a user",
+    "method": "PUT",
+    "path": "/user/following/{username}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        }
+      },
+      "required": [
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "users_unfollow",
+    "description": "Unfollow a user",
+    "method": "DELETE",
+    "path": "/user/following/{username}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        }
+      },
+      "required": [
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "users_list_gpg_keys_for_authenticated_user",
+    "description": "List GPG keys for the authenticated user",
+    "method": "GET",
+    "path": "/user/gpg_keys",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "users_create_gpg_key_for_authenticated_user",
+    "description": "Create a GPG key for the authenticated user",
+    "method": "POST",
+    "path": "/user/gpg_keys",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "A descriptive name for the new key."
+        },
+        "armored_public_key": {
+          "type": "string",
+          "description": "A GPG key in ASCII-armored format."
+        }
+      },
+      "required": [
+        "armored_public_key"
+      ]
+    }
+  },
+  {
+    "name": "users_get_gpg_key_for_authenticated_user",
+    "description": "Get a GPG key for the authenticated user",
+    "method": "GET",
+    "path": "/user/gpg_keys/{gpg_key_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "gpg_key_id": {
+          "type": "number",
+          "description": "The unique identifier of the GPG key."
+        }
+      },
+      "required": [
+        "gpg_key_id"
+      ]
+    }
+  },
+  {
+    "name": "users_delete_gpg_key_for_authenticated_user",
+    "description": "Delete a GPG key for the authenticated user",
+    "method": "DELETE",
+    "path": "/user/gpg_keys/{gpg_key_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "gpg_key_id": {
+          "type": "number",
+          "description": "The unique identifier of the GPG key."
+        }
+      },
+      "required": [
+        "gpg_key_id"
+      ]
+    }
+  },
+  {
+    "name": "users_list_public_ssh_keys_for_authenticated_user",
+    "description": "List public SSH keys for the authenticated user",
+    "method": "GET",
+    "path": "/user/keys",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "users_create_public_ssh_key_for_authenticated_user",
+    "description": "Create a public SSH key for the authenticated user",
+    "method": "POST",
+    "path": "/user/keys",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "A descriptive name for the new key."
+        },
+        "key": {
+          "type": "string",
+          "description": "The public SSH key to add to your GitHub account."
+        }
+      },
+      "required": [
+        "key"
+      ]
+    }
+  },
+  {
+    "name": "users_get_public_ssh_key_for_authenticated_user",
+    "description": "Get a public SSH key for the authenticated user",
+    "method": "GET",
+    "path": "/user/keys/{key_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "key_id": {
+          "type": "number",
+          "description": "The unique identifier of the key."
+        }
+      },
+      "required": [
+        "key_id"
+      ]
+    }
+  },
+  {
+    "name": "users_delete_public_ssh_key_for_authenticated_user",
+    "description": "Delete a public SSH key for the authenticated user",
+    "method": "DELETE",
+    "path": "/user/keys/{key_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "key_id": {
+          "type": "number",
+          "description": "The unique identifier of the key."
+        }
+      },
+      "required": [
+        "key_id"
+      ]
+    }
+  },
+  {
+    "name": "users_list_public_emails_for_authenticated_user",
+    "description": "List public email addresses for the authenticated user",
+    "method": "GET",
+    "path": "/user/public_emails",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "users_list_social_accounts_for_authenticated_user",
+    "description": "List social accounts for the authenticated user",
+    "method": "GET",
+    "path": "/user/social_accounts",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "users_add_social_account_for_authenticated_user",
+    "description": "Add social accounts for the authenticated user",
+    "method": "POST",
+    "path": "/user/social_accounts",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "account_urls": {
+          "type": "array",
+          "description": "Full URLs for the social media profiles to add."
+        }
+      },
+      "required": [
+        "account_urls"
+      ]
+    }
+  },
+  {
+    "name": "users_delete_social_account_for_authenticated_user",
+    "description": "Delete social accounts for the authenticated user",
+    "method": "DELETE",
+    "path": "/user/social_accounts",
+    "deleteSendsJsonBody": true,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "account_urls": {
+          "type": "array",
+          "description": "Full URLs for the social media profiles to delete."
+        }
+      },
+      "required": [
+        "account_urls"
+      ]
+    }
+  },
+  {
+    "name": "users_list_ssh_signing_keys_for_authenticated_user",
+    "description": "List SSH signing keys for the authenticated user",
+    "method": "GET",
+    "path": "/user/ssh_signing_keys",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "users_create_ssh_signing_key_for_authenticated_user",
+    "description": "Create a SSH signing key for the authenticated user",
+    "method": "POST",
+    "path": "/user/ssh_signing_keys",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "A descriptive name for the new key."
+        },
+        "key": {
+          "type": "string",
+          "description": "The public SSH key to add to your GitHub account. For more information, see \"[Checking for existing SSH keys](https://docs.github.com/authentication/connecting-to-github-with-ssh/checking-for-existing-ssh-keys).\""
+        }
+      },
+      "required": [
+        "key"
+      ]
+    }
+  },
+  {
+    "name": "users_get_ssh_signing_key_for_authenticated_user",
+    "description": "Get an SSH signing key for the authenticated user",
+    "method": "GET",
+    "path": "/user/ssh_signing_keys/{ssh_signing_key_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "ssh_signing_key_id": {
+          "type": "number",
+          "description": "The unique identifier of the SSH signing key."
+        }
+      },
+      "required": [
+        "ssh_signing_key_id"
+      ]
+    }
+  },
+  {
+    "name": "users_delete_ssh_signing_key_for_authenticated_user",
+    "description": "Delete an SSH signing key for the authenticated user",
+    "method": "DELETE",
+    "path": "/user/ssh_signing_keys/{ssh_signing_key_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "ssh_signing_key_id": {
+          "type": "number",
+          "description": "The unique identifier of the SSH signing key."
+        }
+      },
+      "required": [
+        "ssh_signing_key_id"
+      ]
+    }
+  },
+  {
+    "name": "users_get_by_id",
+    "description": "Get a user using their ID",
+    "method": "GET",
+    "path": "/user/{account_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "account_id": {
+          "type": "number",
+          "description": "account_id parameter"
+        }
+      },
+      "required": [
+        "account_id"
+      ]
+    }
+  },
+  {
+    "name": "users_list",
+    "description": "List users",
+    "method": "GET",
+    "path": "/users",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "since": {
+          "type": "number",
+          "description": "A user ID. Only return users with an ID greater than this ID."
+        },
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "users_get_by_username",
+    "description": "Get a user",
+    "method": "GET",
+    "path": "/users/{username}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        }
+      },
+      "required": [
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "users_list_attestations_bulk",
+    "description": "List attestations by bulk subject digests",
+    "method": "POST",
+    "path": "/users/{username}/attestations/bulk-list",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "before": {
+          "type": "string",
+          "description": "A cursor, as given in the [Link header](https://docs.github.com/rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for results before this cursor. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "after": {
+          "type": "string",
+          "description": "A cursor, as given in the [Link header](https://docs.github.com/rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for results after this cursor. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        },
+        "subject_digests": {
+          "type": "array",
+          "description": "List of subject digests to fetch attestations for."
+        },
+        "predicate_type": {
+          "type": "string",
+          "description": "Optional filter for fetching attestations with a given predicate type.\nThis option accepts `provenance`, `sbom`, `release`, or freeform text\nfor custom predicate types."
+        }
+      },
+      "required": [
+        "username",
+        "subject_digests"
+      ]
+    }
+  },
+  {
+    "name": "users_delete_attestations_bulk",
+    "description": "Delete attestations in bulk",
+    "method": "POST",
+    "path": "/users/{username}/attestations/delete-request",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        }
+      },
+      "required": [
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "users_delete_attestations_by_subject_digest",
+    "description": "Delete attestations by subject digest",
+    "method": "DELETE",
+    "path": "/users/{username}/attestations/digest/{subject_digest}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        },
+        "subject_digest": {
+          "type": "string",
+          "description": "Subject Digest"
+        }
+      },
+      "required": [
+        "username",
+        "subject_digest"
+      ]
+    }
+  },
+  {
+    "name": "users_delete_attestations_by_id",
+    "description": "Delete attestations by ID",
+    "method": "DELETE",
+    "path": "/users/{username}/attestations/{attestation_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        },
+        "attestation_id": {
+          "type": "number",
+          "description": "Attestation ID"
+        }
+      },
+      "required": [
+        "username",
+        "attestation_id"
+      ]
+    }
+  },
+  {
+    "name": "users_list_attestations",
+    "description": "List attestations",
+    "method": "GET",
+    "path": "/users/{username}/attestations/{subject_digest}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "before": {
+          "type": "string",
+          "description": "A cursor, as given in the [Link header](https://docs.github.com/rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for results before this cursor. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "after": {
+          "type": "string",
+          "description": "A cursor, as given in the [Link header](https://docs.github.com/rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for results after this cursor. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        },
+        "subject_digest": {
+          "type": "string",
+          "description": "Subject Digest"
+        },
+        "predicate_type": {
+          "type": "string",
+          "description": "Optional filter for fetching attestations with a given predicate type.\nThis option accepts `provenance`, `sbom`, `release`, or freeform text\nfor custom predicate types."
+        }
+      },
+      "required": [
+        "username",
+        "subject_digest"
+      ]
+    }
+  },
+  {
+    "name": "users_list_followers_for_user",
+    "description": "List followers of a user",
+    "method": "GET",
+    "path": "/users/{username}/followers",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        },
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": [
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "users_list_following_for_user",
+    "description": "List the people a user follows",
+    "method": "GET",
+    "path": "/users/{username}/following",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        },
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": [
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "users_check_following_for_user",
+    "description": "Check if a user follows another user",
+    "method": "GET",
+    "path": "/users/{username}/following/{target_user}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        },
+        "target_user": {
+          "type": "string",
+          "description": "The target_user parameter"
+        }
+      },
+      "required": [
+        "username",
+        "target_user"
+      ]
+    }
+  },
+  {
+    "name": "users_list_gpg_keys_for_user",
+    "description": "List GPG keys for a user",
+    "method": "GET",
+    "path": "/users/{username}/gpg_keys",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        },
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": [
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "users_get_context_for_user",
+    "description": "Get contextual information for a user",
+    "method": "GET",
+    "path": "/users/{username}/hovercard",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        },
+        "subject_type": {
+          "type": "string",
+          "description": "Identifies which additional information you'd like to receive about the person's hovercard. Can be `organization`, `repository`, `issue`, `pull_request`. **Required** when using `subject_id`.",
+          "enum": [
+            "organization",
+            "repository",
+            "issue",
+            "pull_request"
+          ]
+        },
+        "subject_id": {
+          "type": "string",
+          "description": "Uses the ID for the `subject_type` you specified. **Required** when using `subject_type`."
+        }
+      },
+      "required": [
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "users_list_public_keys_for_user",
+    "description": "List public keys for a user",
+    "method": "GET",
+    "path": "/users/{username}/keys",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        },
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": [
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "users_list_social_accounts_for_user",
+    "description": "List social accounts for a user",
+    "method": "GET",
+    "path": "/users/{username}/social_accounts",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        },
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": [
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "users_list_ssh_signing_keys_for_user",
+    "description": "List SSH signing keys for a user",
+    "method": "GET",
+    "path": "/users/{username}/ssh_signing_keys",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        },
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch. For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\""
+        }
+      },
+      "required": [
+        "username"
+      ]
+    }
+  }
+];
+
+export const tools = ENDPOINTS.map((e) => ({
+  name: e.name,
+  description: e.description,
+  method: e.method,
+  path: e.path,
+  deleteSendsJsonBody: Boolean(e.deleteSendsJsonBody),
+  inputSchema: e.inputSchema,
+  handler: async (params) => ({
+    content: [{ type: 'text', text: JSON.stringify(await apiRequest(e.method, e.path, params, { deleteSendsJsonBody: e.deleteSendsJsonBody }), null, 2) }],
+  }),
+}));