adoptai-mcp 1.0.0

package/dist/integrations/github-billing/auth.js

@@ -0,0 +1,53 @@
+import { saveCredentials, getCredentials } from '../../core/auth-manager.js';
+import readline from 'readline';
+
+const APP_ID = 'github-billing';
+
+export async function runAuth() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  console.log(`
+┌─────────────────────────────────────────────┐
+│  GitHub Billing Authentication        │
+│                                             │
+│  Use a GitHub Personal Access Token (PAT).  │
+│  Create one in Settings → Developer         │
+│  settings → Personal access tokens.          │
+└─────────────────────────────────────────────┘
+  `);
+
+  const token = await new Promise((resolve) => {
+    rl.question('Paste your GitHub PAT: ', (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+
+  if (!token || token.length < 10) {
+    throw new Error('Invalid token');
+  }
+
+  saveCredentials(APP_ID, {
+    token,
+    tokenType: 'bearer',
+    expiresAt: null,
+    savedAt: new Date().toISOString(),
+  });
+
+  console.log('✅ Token saved for GitHub Billing');
+}
+
+export function getToken() {
+  return getCredentials(APP_ID)?.token || null;
+}
+
+export function buildAuthHeaders() {
+  const token = getToken();
+  if (!token) {
+    throw new Error('Not authenticated. Run: npx adoptai-github-billing-mcp --client cursor');
+  }
+  return { Authorization: 'Bearer ' + token };
+}

package/dist/integrations/github-billing/index.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { createMCPServer } from '../../core/server-base.js';
+import { tools } from './tools.js';
+
+const { start } = createMCPServer({
+  name: 'github-billing-adoptai',
+  version: '1.0.0',
+  tools,
+});
+
+start();

package/dist/integrations/github-billing/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "adoptai-github-billing-mcp",
+  "version": "1.0.0",
+  "description": "GitHub's v3 REST API — budgets, usage reports, and related billing endpoints (OpenAPI-derived).",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "adoptai-github-billing-mcp": "./setup.js"
+  },
+  "scripts": {
+    "start": "node index.js",
+    "setup": "node setup.js"
+  },
+  "keywords": ["mcp", "github", "github-billing", "billing", "ai", "cursor", "claude", "adopt.ai"],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "axios": "^1.6.0"
+  },
+  "adoptai": {
+    "appId": "github-billing",
+    "toolCount": 10,
+    "sourceFormat": "openapi_3.1",
+    "authType": "bearer",
+    "generatedAt": "2026-03-26T12:00:00.000Z"
+  }
+}

package/dist/integrations/github-billing/setup.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+import { writeConfig, removeConfig } from '../../core/config-writer.js';
+import { getCredentials, isTokenExpired } from '../../core/auth-manager.js';
+import { runAuth } from './auth.js';
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+import readline from 'readline';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const args = process.argv.slice(2);
+
+const clientFlag = args.includes('--client')
+  ? args[args.indexOf('--client') + 1]
+  : 'cursor';
+
+const isRemove = args.includes('--remove');
+const isStatus = args.includes('--status');
+
+const SUPPORTED_CLIENTS = ['cursor', 'claude', 'windsurf', 'vscode'];
+
+if (isRemove) {
+  removeConfig({ client: clientFlag, serverName: 'github-billing-adoptai' });
+  console.log(`✅ GitHub Billing MCP removed from ${clientFlag}`);
+  process.exit(0);
+}
+
+if (isStatus) {
+  const creds = getCredentials('github-billing');
+  if (!creds) {
+    console.log('❌ Not authenticated');
+  } else {
+    console.log('✅ Authenticated');
+    console.log(`   Token: ${creds.token?.substring(0, 12)}...`);
+    console.log(`   Saved: ${creds.savedAt}`);
+  }
+  process.exit(0);
+}
+
+if (!SUPPORTED_CLIENTS.includes(clientFlag)) {
+  console.error(`Invalid client: ${clientFlag}`);
+  console.error(`Supported: ${SUPPORTED_CLIENTS.join(', ')}`);
+  process.exit(1);
+}
+
+async function main() {
+  const existing = getCredentials('github-billing');
+
+  if (existing && !isTokenExpired('github-billing')) {
+    console.log('✅ Already authenticated');
+
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+
+    const answer = await new Promise((resolveAns) => {
+      rl.question('Re-authenticate? (y/n): ', (a) => {
+        rl.close();
+        resolveAns(a.trim().toLowerCase());
+      });
+    });
+
+    if (answer !== 'y') {
+      writeConfig({
+        client: clientFlag,
+        serverName: 'github-billing-adoptai',
+        command: 'node',
+        args: [resolve(__dirname, 'index.js')],
+        env: {},
+      });
+      process.exit(0);
+    }
+  }
+
+  await runAuth();
+
+  const indexPath = resolve(__dirname, 'index.js');
+
+  writeConfig({
+    client: clientFlag,
+    serverName: 'github-billing-adoptai',
+    command: 'node',
+    args: [indexPath],
+    env: {},
+  });
+
+  console.log(`
+✅ GitHub Billing MCP is ready!
+────────────────────────────────────────
+Your AI (${clientFlag}) can now use 10 tools.
+
+Try asking:
+  "List organization billing budgets"
+  "Get billing usage for an organization"
+
+Run health check: node core/doctor.js --client ${clientFlag}
+  `);
+}
+
+main().catch((err) => {
+  console.error('❌ Setup failed:', err.message);
+  process.exit(1);
+});

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

@@ -0,0 +1,438 @@
+import axios from 'axios';
+import { buildAuthHeaders } from './auth.js';
+
+const BASE_URL = 'https://api.github.com';
+const APP_ID = 'github-billing';
+
+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": "billing_get_all_budgets_org",
+    "description": "Get all budgets for an organization",
+    "method": "GET",
+    "path": "/organizations/{org}/settings/billing/budgets",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "page": {
+          "type": "number",
+          "description": "The page number of the results to fetch."
+        },
+        "per_page": {
+          "type": "number",
+          "description": "The number of results per page (max 10)."
+        },
+        "scope": {
+          "type": "string",
+          "description": "Filter budgets by scope type.",
+          "enum": [
+            "enterprise",
+            "organization",
+            "repository",
+            "cost_center"
+          ]
+        }
+      },
+      "required": [
+        "org"
+      ]
+    }
+  },
+  {
+    "name": "billing_get_budget_org",
+    "description": "Get a budget by ID for an organization",
+    "method": "GET",
+    "path": "/organizations/{org}/settings/billing/budgets/{budget_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "budget_id": {
+          "type": "string",
+          "description": "The ID corresponding to the budget."
+        }
+      },
+      "required": [
+        "org",
+        "budget_id"
+      ]
+    }
+  },
+  {
+    "name": "billing_update_budget_org",
+    "description": "Update a budget for an organization",
+    "method": "PATCH",
+    "path": "/organizations/{org}/settings/billing/budgets/{budget_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "budget_id": {
+          "type": "string",
+          "description": "The ID corresponding to the budget."
+        },
+        "budget_amount": {
+          "type": "number",
+          "description": "The budget amount in whole dollars. For license-based products, this represents the number of licenses."
+        },
+        "prevent_further_usage": {
+          "type": "boolean",
+          "description": "Whether to prevent additional spending once the budget is exceeded"
+        },
+        "budget_alerting": {
+          "type": "object",
+          "description": "The budget_alerting field"
+        },
+        "budget_scope": {
+          "type": "string",
+          "description": "The scope of the budget",
+          "enum": [
+            "enterprise",
+            "organization",
+            "repository",
+            "cost_center"
+          ]
+        },
+        "budget_entity_name": {
+          "type": "string",
+          "description": "The name of the entity to apply the budget to"
+        },
+        "budget_type": {
+          "type": "string",
+          "description": "The type of pricing for the budget"
+        },
+        "budget_product_sku": {
+          "type": "string",
+          "description": "A single product or SKU that will be covered in the budget"
+        }
+      },
+      "required": [
+        "org",
+        "budget_id"
+      ]
+    }
+  },
+  {
+    "name": "billing_delete_budget_org",
+    "description": "Delete a budget for an organization",
+    "method": "DELETE",
+    "path": "/organizations/{org}/settings/billing/budgets/{budget_id}",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "budget_id": {
+          "type": "string",
+          "description": "The ID corresponding to the budget."
+        }
+      },
+      "required": [
+        "org",
+        "budget_id"
+      ]
+    }
+  },
+  {
+    "name": "billing_get_github_billing_premium_request_usage_report_org",
+    "description": "Get billing premium request usage report for an organization",
+    "method": "GET",
+    "path": "/organizations/{org}/settings/billing/premium_request/usage",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "year": {
+          "type": "number",
+          "description": "If specified, only return results for a single year. The value of `year` is an integer with four digits representing a year. For example, `2025`. Default value is the current year."
+        },
+        "month": {
+          "type": "number",
+          "description": "If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`. Default value is the current month. If no year is specified the default `year` is used."
+        },
+        "day": {
+          "type": "number",
+          "description": "If specified, only return results for a single day. The value of `day` is an integer between `1` and `31`. If no `year` or `month` is specified, the default `year` and `month` are used."
+        },
+        "user": {
+          "type": "string",
+          "description": "The user name to query usage for. The name is not case sensitive."
+        },
+        "model": {
+          "type": "string",
+          "description": "The model name to query usage for. The name is not case sensitive."
+        },
+        "product": {
+          "type": "string",
+          "description": "The product name to query usage for. The name is not case sensitive."
+        }
+      },
+      "required": [
+        "org"
+      ]
+    }
+  },
+  {
+    "name": "billing_get_github_billing_usage_report_org",
+    "description": "Get billing usage report for an organization",
+    "method": "GET",
+    "path": "/organizations/{org}/settings/billing/usage",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "year": {
+          "type": "number",
+          "description": "If specified, only return results for a single year. The value of `year` is an integer with four digits representing a year. For example, `2025`. Default value is the current year."
+        },
+        "month": {
+          "type": "number",
+          "description": "If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`. If no year is specified the default `year` is used."
+        },
+        "day": {
+          "type": "number",
+          "description": "If specified, only return results for a single day. The value of `day` is an integer between `1` and `31`. If no `year` or `month` is specified, the default `year` and `month` are used."
+        }
+      },
+      "required": [
+        "org"
+      ]
+    }
+  },
+  {
+    "name": "billing_get_github_billing_usage_summary_report_org",
+    "description": "Get billing usage summary for an organization",
+    "method": "GET",
+    "path": "/organizations/{org}/settings/billing/usage/summary",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "org": {
+          "type": "string",
+          "description": "The organization name. The name is not case sensitive."
+        },
+        "year": {
+          "type": "number",
+          "description": "If specified, only return results for a single year. The value of `year` is an integer with four digits representing a year. For example, `2025`. Default value is the current year."
+        },
+        "month": {
+          "type": "number",
+          "description": "If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`. Default value is the current month. If no year is specified the default `year` is used."
+        },
+        "day": {
+          "type": "number",
+          "description": "If specified, only return results for a single day. The value of `day` is an integer between `1` and `31`. If no `year` or `month` is specified, the default `year` and `month` are used."
+        },
+        "repository": {
+          "type": "string",
+          "description": "The repository name to query for usage in the format owner/repository."
+        },
+        "product": {
+          "type": "string",
+          "description": "The product name to query usage for. The name is not case sensitive."
+        },
+        "sku": {
+          "type": "string",
+          "description": "The SKU to query for usage."
+        }
+      },
+      "required": [
+        "org"
+      ]
+    }
+  },
+  {
+    "name": "billing_get_github_billing_premium_request_usage_report_user",
+    "description": "Get billing premium request usage report for a user",
+    "method": "GET",
+    "path": "/users/{username}/settings/billing/premium_request/usage",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        },
+        "year": {
+          "type": "number",
+          "description": "If specified, only return results for a single year. The value of `year` is an integer with four digits representing a year. For example, `2025`. Default value is the current year."
+        },
+        "month": {
+          "type": "number",
+          "description": "If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`. Default value is the current month. If no year is specified the default `year` is used."
+        },
+        "day": {
+          "type": "number",
+          "description": "If specified, only return results for a single day. The value of `day` is an integer between `1` and `31`. If no `year` or `month` is specified, the default `year` and `month` are used."
+        },
+        "model": {
+          "type": "string",
+          "description": "The model name to query usage for. The name is not case sensitive."
+        },
+        "product": {
+          "type": "string",
+          "description": "The product name to query usage for. The name is not case sensitive."
+        }
+      },
+      "required": [
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "billing_get_github_billing_usage_report_user",
+    "description": "Get billing usage report for a user",
+    "method": "GET",
+    "path": "/users/{username}/settings/billing/usage",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        },
+        "year": {
+          "type": "number",
+          "description": "If specified, only return results for a single year. The value of `year` is an integer with four digits representing a year. For example, `2025`. Default value is the current year."
+        },
+        "month": {
+          "type": "number",
+          "description": "If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`. If no year is specified the default `year` is used."
+        },
+        "day": {
+          "type": "number",
+          "description": "If specified, only return results for a single day. The value of `day` is an integer between `1` and `31`. If no `year` or `month` is specified, the default `year` and `month` are used."
+        }
+      },
+      "required": [
+        "username"
+      ]
+    }
+  },
+  {
+    "name": "billing_get_github_billing_usage_summary_report_user",
+    "description": "Get billing usage summary for a user",
+    "method": "GET",
+    "path": "/users/{username}/settings/billing/usage/summary",
+    "deleteSendsJsonBody": false,
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "The handle for the GitHub user account."
+        },
+        "year": {
+          "type": "number",
+          "description": "If specified, only return results for a single year. The value of `year` is an integer with four digits representing a year. For example, `2025`. Default value is the current year."
+        },
+        "month": {
+          "type": "number",
+          "description": "If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`. Default value is the current month. If no year is specified the default `year` is used."
+        },
+        "day": {
+          "type": "number",
+          "description": "If specified, only return results for a single day. The value of `day` is an integer between `1` and `31`. If no `year` or `month` is specified, the default `year` and `month` are used."
+        },
+        "repository": {
+          "type": "string",
+          "description": "The repository name to query for usage in the format owner/repository."
+        },
+        "product": {
+          "type": "string",
+          "description": "The product name to query usage for. The name is not case sensitive."
+        },
+        "sku": {
+          "type": "string",
+          "description": "The SKU to query for usage."
+        }
+      },
+      "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) }],
+  }),
+}));

package/dist/integrations/github-checks/auth.js

@@ -0,0 +1,53 @@
+import { saveCredentials, getCredentials } from '../../core/auth-manager.js';
+import readline from 'readline';
+
+const APP_ID = 'github-checks';
+
+export async function runAuth() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  console.log(`
+┌─────────────────────────────────────────────┐
+│  GitHub Checks Authentication        │
+│                                             │
+│  Use a GitHub Personal Access Token (PAT).  │
+│  Create one in Settings → Developer         │
+│  settings → Personal access tokens.          │
+└─────────────────────────────────────────────┘
+  `);
+
+  const token = await new Promise((resolve) => {
+    rl.question('Paste your GitHub PAT: ', (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+
+  if (!token || token.length < 10) {
+    throw new Error('Invalid token');
+  }
+
+  saveCredentials(APP_ID, {
+    token,
+    tokenType: 'bearer',
+    expiresAt: null,
+    savedAt: new Date().toISOString(),
+  });
+
+  console.log('✅ Token saved for GitHub Checks');
+}
+
+export function getToken() {
+  return getCredentials(APP_ID)?.token || null;
+}
+
+export function buildAuthHeaders() {
+  const token = getToken();
+  if (!token) {
+    throw new Error('Not authenticated. Run: npx adoptai-github-checks-mcp --client cursor');
+  }
+  return { Authorization: 'Bearer ' + token };
+}