@commandable/mcp 0.0.1

package/integration-data/airtable/handlers/search_records.js

@@ -0,0 +1,6 @@
+async (input) => {
+  const formula = `{${input.field}} = "${input.value}"`
+  const params = new URLSearchParams({ filterByFormula: formula })
+  const res = await integration.fetch(`/${input.baseId}/${input.tableId}?${params.toString()}`)
+  return await res.json()
+}

package/integration-data/airtable/handlers/update_record.js

@@ -0,0 +1,11 @@
+async (input) => {
+  const path = `/${input.baseId}/${input.tableId}`
+  const body = {
+    records: [
+      { id: input.recordId, fields: input.fields },
+    ],
+    typecast: !!input.typecast,
+  }
+  const res = await integration.fetch(path, { method: 'PATCH', body })
+  return await res.json()
+}

package/integration-data/airtable/manifest.json

@@ -0,0 +1,83 @@
+{
+  "name": "airtable",
+  "version": "0.1.0",
+  "tools": [
+    {
+      "name": "list_bases",
+      "description": "List bases available to the authenticated user.",
+      "inputSchema": "schemas/empty.json",
+      "handler": "handlers/list_bases.js",
+      "scope": "read"
+    },
+    {
+      "name": "list_tables",
+      "description": "List tables in a base (metadata).",
+      "inputSchema": "schemas/id_base.json",
+      "handler": "handlers/list_tables.js",
+      "scope": "read"
+    },
+    {
+      "name": "get_table_schema",
+      "description": "Fetch a table's schema (fields, views) by tableId via metadata.",
+      "inputSchema": "schemas/id_base_table.json",
+      "handler": "handlers/get_table_schema.js",
+      "scope": "read"
+    },
+    {
+      "name": "list_table_fields",
+      "description": "List fields for a table (metadata).",
+      "inputSchema": "schemas/id_base_table.json",
+      "handler": "handlers/list_table_fields.js",
+      "scope": "read"
+    },
+    {
+      "name": "list_views",
+      "description": "List views for a table (metadata).",
+      "inputSchema": "schemas/id_base_table.json",
+      "handler": "handlers/list_views.js",
+      "scope": "read"
+    },
+    {
+      "name": "list_records",
+      "description": "List records from a table with optional filters.",
+      "inputSchema": "schemas/list_records.json",
+      "handler": "handlers/list_records.js",
+      "scope": "read"
+    },
+    {
+      "name": "get_record",
+      "description": "Fetch a single record by recordId.",
+      "inputSchema": "schemas/get_record.json",
+      "handler": "handlers/get_record.js",
+      "scope": "read"
+    },
+    {
+      "name": "search_records",
+      "description": "Search records in a table using a field and value (filterByFormula).",
+      "inputSchema": "schemas/search_records.json",
+      "handler": "handlers/search_records.js",
+      "scope": "read"
+    },
+    {
+      "name": "create_record",
+      "description": "Create a record in a table.",
+      "inputSchema": "schemas/create_record.json",
+      "handler": "handlers/create_record.js",
+      "scope": "write"
+    },
+    {
+      "name": "update_record",
+      "description": "Update a record in a table.",
+      "inputSchema": "schemas/update_record.json",
+      "handler": "handlers/update_record.js",
+      "scope": "write"
+    },
+    {
+      "name": "delete_record",
+      "description": "Delete a record from a table.",
+      "inputSchema": "schemas/delete_record.json",
+      "handler": "handlers/delete_record.js",
+      "scope": "write"
+    }
+  ]
+}

package/integration-data/airtable/schemas/create_record.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "baseId": { "type": "string", "description": "Airtable base ID" },
+    "tableId": { "type": "string", "description": "Airtable table ID or name" },
+    "fields": { "type": "object", "description": "Field values for the new record" },
+    "typecast": { "type": "boolean", "description": "Coerce values to field types" }
+  },
+  "required": ["baseId", "tableId", "fields"],
+  "additionalProperties": false
+}

package/integration-data/airtable/schemas/delete_record.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "baseId": { "type": "string" },
+    "tableId": { "type": "string" },
+    "recordId": { "type": "string" }
+  },
+  "required": ["baseId", "tableId", "recordId"],
+  "additionalProperties": false
+}

package/integration-data/airtable/schemas/empty.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {},
+  "additionalProperties": false
+}

package/integration-data/airtable/schemas/get_record.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["baseId", "tableId", "recordId"],
+  "properties": {
+    "baseId": { "type": "string" },
+    "tableId": { "type": "string" },
+    "recordId": { "type": "string" }
+  },
+  "additionalProperties": false
+}

package/integration-data/airtable/schemas/id_base.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["baseId"],
+  "properties": {
+    "baseId": { "type": "string", "description": "Airtable base ID" }
+  },
+  "additionalProperties": false
+}

package/integration-data/airtable/schemas/id_base_table.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["baseId", "tableId"],
+  "properties": {
+    "baseId": { "type": "string", "description": "Airtable base ID" },
+    "tableId": { "type": "string", "description": "Airtable table ID (tbl...)" }
+  },
+  "additionalProperties": false
+}

package/integration-data/airtable/schemas/list_records.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["baseId", "tableId"],
+  "properties": {
+    "baseId": { "type": "string" },
+    "tableId": { "type": "string" },
+    "view": { "type": "string", "description": "Optional view name or ID" },
+    "maxRecords": { "type": "integer", "minimum": 1 },
+    "pageSize": { "type": "integer", "minimum": 1 },
+    "filterByFormula": { "type": "string" },
+    "sort": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["field"],
+        "properties": {
+          "field": { "type": "string" },
+          "direction": { "type": "string", "enum": ["asc", "desc"] }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/integration-data/airtable/schemas/search_records.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["baseId", "tableId", "field", "value"],
+  "properties": {
+    "baseId": { "type": "string" },
+    "tableId": { "type": "string" },
+    "field": { "type": "string", "description": "Field name to match" },
+    "value": { "type": "string", "description": "Value to search for" }
+  },
+  "additionalProperties": false
+}

package/integration-data/airtable/schemas/update_record.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "baseId": { "type": "string" },
+    "tableId": { "type": "string" },
+    "recordId": { "type": "string" },
+    "fields": { "type": "object" },
+    "typecast": { "type": "boolean" }
+  },
+  "required": ["baseId", "tableId", "recordId", "fields"],
+  "additionalProperties": false
+}

package/integration-data/github/credentials.json

@@ -0,0 +1,20 @@
+{
+  "schema": {
+    "type": "object",
+    "properties": {
+      "token": {
+        "type": "string",
+        "title": "Personal Access Token",
+        "description": "GitHub personal access token (classic or fine-grained) with appropriate scopes."
+      }
+    },
+    "required": ["token"],
+    "additionalProperties": false
+  },
+  "injection": {
+    "headers": {
+      "Authorization": "Bearer {{token}}"
+    }
+  }
+}
+

package/integration-data/github/credentials_hint.md

@@ -0,0 +1,7 @@
+Create a GitHub personal access token and paste it here.
+
+- Fine-grained PAT: Settings → Developer settings → Personal access tokens → Fine-grained tokens
+- Classic PAT: Settings → Developer settings → Personal access tokens → Tokens (classic)
+
+Minimum scopes depend on the tools you use (repo read/write, issues, pull requests, etc.).
+

package/integration-data/github/handlers/add_labels_to_issue.js

@@ -0,0 +1,12 @@
+async (input) => {
+  const body = {
+    labels: input.labels,
+  }
+  
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/issues/${input.issue_number}/labels`, { 
+    method: 'POST', 
+    body 
+  })
+  return await res.json()
+}
+

package/integration-data/github/handlers/close_issue.js

@@ -0,0 +1,5 @@
+async (input) => {
+  const body = { state: 'closed' }
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/issues/${input.issue_number}`, { method: 'PATCH', body })
+  return await res.json()
+}

package/integration-data/github/handlers/comment_on_issue.js

@@ -0,0 +1,5 @@
+async (input) => {
+  const body = { body: input.body }
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/issues/${input.issue_number}/comments`, { method: 'POST', body })
+  return await res.json()
+}

package/integration-data/github/handlers/create_branch.js

@@ -0,0 +1,33 @@
+async (input) => {
+  // First, get the SHA of the branch to create from
+  let fromRef = input.from_branch || 'main'
+  
+  // Try to get the ref, fallback to master if main doesn't exist
+  let refRes
+  try {
+    refRes = await integration.fetch(`/repos/${input.owner}/${input.repo}/git/refs/heads/${fromRef}`)
+  } catch (e) {
+    if (fromRef === 'main') {
+      fromRef = 'master'
+      refRes = await integration.fetch(`/repos/${input.owner}/${input.repo}/git/refs/heads/${fromRef}`)
+    } else {
+      throw e
+    }
+  }
+  
+  const refData = await refRes.json()
+  const sha = refData.object.sha
+  
+  // Create the new branch
+  const body = {
+    ref: `refs/heads/${input.branch}`,
+    sha: sha,
+  }
+  
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/git/refs`, { 
+    method: 'POST', 
+    body 
+  })
+  return await res.json()
+}
+

package/integration-data/github/handlers/create_commit.js

@@ -0,0 +1,91 @@
+async (input) => {
+  const { owner, repo, branch, message, files } = input
+  
+  // 1. Get the current commit SHA for the branch
+  const refRes = await integration.fetch(`/repos/${owner}/${repo}/git/refs/heads/${branch}`)
+  const refData = await refRes.json()
+  const currentCommitSha = refData.object.sha
+  
+  // 2. Get the current commit to get its tree
+  const commitRes = await integration.fetch(`/repos/${owner}/${repo}/git/commits/${currentCommitSha}`)
+  const commitData = await commitRes.json()
+  const currentTreeSha = commitData.tree.sha
+  
+  // 3. Create blobs for each file with content
+  const tree = []
+  for (const file of files) {
+    if (file.content !== undefined && file.content !== null) {
+      // Create a blob for this file
+      const contentBase64 = typeof Buffer !== 'undefined'
+        ? Buffer.from(file.content).toString('base64')
+        : btoa(unescape(encodeURIComponent(file.content)))
+      
+      const blobRes = await integration.fetch(`/repos/${owner}/${repo}/git/blobs`, {
+        method: 'POST',
+        body: {
+          content: contentBase64,
+          encoding: 'base64',
+        },
+      })
+      const blobData = await blobRes.json()
+      
+      tree.push({
+        path: file.path,
+        mode: file.mode || '100644',
+        type: 'blob',
+        sha: blobData.sha,
+      })
+    } else {
+      // File deletion (null sha means delete)
+      tree.push({
+        path: file.path,
+        mode: '100644',
+        type: 'blob',
+        sha: null,
+      })
+    }
+  }
+  
+  // 4. Create a new tree
+  const treeRes = await integration.fetch(`/repos/${owner}/${repo}/git/trees`, {
+    method: 'POST',
+    body: {
+      base_tree: currentTreeSha,
+      tree: tree,
+    },
+  })
+  const treeData = await treeRes.json()
+  
+  // 5. Create the commit
+  const newCommitRes = await integration.fetch(`/repos/${owner}/${repo}/git/commits`, {
+    method: 'POST',
+    body: {
+      message: message,
+      tree: treeData.sha,
+      parents: [currentCommitSha],
+    },
+  })
+  const newCommitData = await newCommitRes.json()
+  
+  // 6. Update the branch reference
+  const updateRefRes = await integration.fetch(`/repos/${owner}/${repo}/git/refs/heads/${branch}`, {
+    method: 'PATCH',
+    body: {
+      sha: newCommitData.sha,
+    },
+  })
+  await updateRefRes.json()
+  
+  return {
+    commit: {
+      sha: newCommitData.sha,
+      url: newCommitData.html_url,
+      message: newCommitData.message,
+    },
+    tree: {
+      sha: treeData.sha,
+    },
+    files: files.map(f => ({ path: f.path })),
+  }
+}
+

package/integration-data/github/handlers/create_issue.js

@@ -0,0 +1,10 @@
+async (input) => {
+  const body = {
+    title: input.title,
+    body: input.body,
+    assignees: input.assignees,
+    labels: input.labels,
+  }
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/issues`, { method: 'POST', body })
+  return await res.json()
+}

package/integration-data/github/handlers/create_or_update_file.js

@@ -0,0 +1,21 @@
+async (input) => {
+  // GitHub API expects content to be base64 encoded
+  // Use btoa with proper UTF-8 encoding for browser/Node.js compatibility
+  const contentBase64 = typeof Buffer !== 'undefined' 
+    ? Buffer.from(input.content).toString('base64')
+    : btoa(unescape(encodeURIComponent(input.content)))
+  
+  const body = {
+    message: input.message,
+    content: contentBase64,
+    branch: input.branch,
+    sha: input.sha,
+  }
+  
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/contents/${input.path}`, { 
+    method: 'PUT', 
+    body 
+  })
+  return await res.json()
+}
+

package/integration-data/github/handlers/create_pull_request.js

@@ -0,0 +1,16 @@
+async (input) => {
+  const body = {
+    title: input.title,
+    body: input.body,
+    head: input.head,
+    base: input.base,
+    draft: input.draft,
+  }
+  
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/pulls`, { 
+    method: 'POST', 
+    body 
+  })
+  return await res.json()
+}
+

package/integration-data/github/handlers/create_repo.js

@@ -0,0 +1,11 @@
+async (input) => {
+  const body = {
+    name: input.name,
+    description: input.description,
+    private: input.private,
+    auto_init: input.auto_init,
+  }
+  const res = await integration.fetch('/user/repos', { method: 'POST', body })
+  return await res.json()
+}
+

package/integration-data/github/handlers/delete_repo.js

@@ -0,0 +1,6 @@
+async (input) => {
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}`, { method: 'DELETE' })
+  // DELETE returns 204 No Content on success
+  return { success: res.status === 204, status: res.status }
+}
+

package/integration-data/github/handlers/get_issue.js

@@ -0,0 +1,4 @@
+async (input) => {
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/issues/${input.issue_number}`)
+  return await res.json()
+}

package/integration-data/github/handlers/get_repo.js

@@ -0,0 +1,4 @@
+async (input) => {
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}`)
+  return await res.json()
+}

package/integration-data/github/handlers/list_branches.js

@@ -0,0 +1,4 @@
+async (input) => {
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/branches`)
+  return await res.json()
+}

package/integration-data/github/handlers/list_commits.js

@@ -0,0 +1,12 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.sha)
+    params.set('sha', input.sha)
+  if (typeof input.path === 'string' && input.path.length > 0)
+    params.set('path', input.path)
+  if (input.author)
+    params.set('author', input.author)
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/commits${query}`)
+  return await res.json()
+}

package/integration-data/github/handlers/list_issues.js

@@ -0,0 +1,12 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.state)
+    params.set('state', input.state)
+  if (input.labels)
+    params.set('labels', input.labels)
+  if (input.assignee)
+    params.set('assignee', input.assignee)
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/issues${query}`)
+  return await res.json()
+}

package/integration-data/github/handlers/list_pull_requests.js

@@ -0,0 +1,8 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.state)
+    params.set('state', input.state)
+  const query = params.toString() ? `?${params.toString()}` : ''
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/pulls${query}`)
+  return await res.json()
+}

package/integration-data/github/handlers/list_repos_install.js

@@ -0,0 +1,4 @@
+async () => {
+  const res = await integration.fetch('/installation/repositories')
+  return await res.json()
+}

package/integration-data/github/handlers/list_repos_user.js

@@ -0,0 +1,4 @@
+async () => {
+  const res = await integration.fetch('/user/repos')
+  return await res.json()
+}

package/integration-data/github/handlers/merge_pull_request.js

@@ -0,0 +1,14 @@
+async (input) => {
+  const body = {
+    commit_title: input.commit_title,
+    commit_message: input.commit_message,
+    merge_method: input.merge_method || 'merge',
+  }
+  
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/pulls/${input.pull_number}/merge`, { 
+    method: 'PUT', 
+    body 
+  })
+  return await res.json()
+}
+

package/integration-data/github/handlers/update_issue.js

@@ -0,0 +1,15 @@
+async (input) => {
+  const body = {}
+  if (input.title !== undefined)
+    body.title = input.title
+  if (input.body !== undefined)
+    body.body = input.body
+  if (input.state !== undefined)
+    body.state = input.state
+  if (input.assignees !== undefined)
+    body.assignees = input.assignees
+  if (input.labels !== undefined)
+    body.labels = input.labels
+  const res = await integration.fetch(`/repos/${input.owner}/${input.repo}/issues/${input.issue_number}`, { method: 'PATCH', body })
+  return await res.json()
+}

package/integration-data/github/manifest.json

@@ -0,0 +1,26 @@
+{
+  "name": "github",
+  "version": "0.1.0",
+  "tools": [
+    { "name": "list_repos", "description": "List repositories for the authenticated user.", "inputSchema": "schemas/empty.json", "handler": "handlers/list_repos_user.js", "scope": "read" },
+    { "name": "get_repo", "description": "Get a repository by owner and name.", "inputSchema": "schemas/get_repo.json", "handler": "handlers/get_repo.js", "scope": "read" },
+    { "name": "list_issues", "description": "List issues for a repository.", "inputSchema": "schemas/list_issues.json", "handler": "handlers/list_issues.js", "scope": "read" },
+    { "name": "get_issue", "description": "Get a specific issue by number.", "inputSchema": "schemas/get_issue.json", "handler": "handlers/get_issue.js", "scope": "read" },
+    { "name": "list_pull_requests", "description": "List pull requests for a repository.", "inputSchema": "schemas/list_pull_requests.json", "handler": "handlers/list_pull_requests.js", "scope": "read" },
+    { "name": "list_branches", "description": "List branches for a repository.", "inputSchema": "schemas/owner_repo.json", "handler": "handlers/list_branches.js", "scope": "read" },
+    { "name": "list_commits", "description": "List commits for a repository.", "inputSchema": "schemas/list_commits.json", "handler": "handlers/list_commits.js", "scope": "read" },
+
+    { "name": "create_repo", "description": "Create a new repository.", "inputSchema": "schemas/create_repo.json", "handler": "handlers/create_repo.js", "scope": "write" },
+    { "name": "delete_repo", "description": "Delete a repository (requires delete_repo scope).", "inputSchema": "schemas/delete_repo.json", "handler": "handlers/delete_repo.js", "scope": "write" },
+    { "name": "create_branch", "description": "Create a new branch in a repository.", "inputSchema": "schemas/create_branch.json", "handler": "handlers/create_branch.js", "scope": "write" },
+    { "name": "create_or_update_file", "description": "Create or update a single file (content must be plain text; base64 handled internally).", "inputSchema": "schemas/create_or_update_file.json", "handler": "handlers/create_or_update_file.js", "scope": "write" },
+    { "name": "create_commit", "description": "Create a commit with multiple files (content must be plain text; base64 handled internally).", "inputSchema": "schemas/create_commit.json", "handler": "handlers/create_commit.js", "scope": "write" },
+    { "name": "create_pull_request", "description": "Create a pull request.", "inputSchema": "schemas/create_pull_request.json", "handler": "handlers/create_pull_request.js", "scope": "write" },
+    { "name": "merge_pull_request", "description": "Merge a pull request.", "inputSchema": "schemas/merge_pull_request.json", "handler": "handlers/merge_pull_request.js", "scope": "write" },
+    { "name": "create_issue", "description": "Create an issue in a repository.", "inputSchema": "schemas/create_issue.json", "handler": "handlers/create_issue.js", "scope": "write" },
+    { "name": "update_issue", "description": "Update fields on an issue.", "inputSchema": "schemas/update_issue.json", "handler": "handlers/update_issue.js", "scope": "write" },
+    { "name": "comment_on_issue", "description": "Add a comment to an issue.", "inputSchema": "schemas/comment_on_issue.json", "handler": "handlers/comment_on_issue.js", "scope": "write" },
+    { "name": "add_labels_to_issue", "description": "Add labels to an issue or pull request.", "inputSchema": "schemas/add_labels_to_issue.json", "handler": "handlers/add_labels_to_issue.js", "scope": "write" },
+    { "name": "close_issue", "description": "Close an issue.", "inputSchema": "schemas/close_issue.json", "handler": "handlers/close_issue.js", "scope": "write" }
+  ]
+}

package/integration-data/github/schemas/add_labels_to_issue.json

@@ -0,0 +1,12 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string", "description": "The account owner of the repository" },
+    "repo": { "type": "string", "description": "The name of the repository" },
+    "issue_number": { "type": "number", "description": "The number of the issue" },
+    "labels": { "type": "array", "items": { "type": "string" }, "description": "The names of the labels to add" }
+  },
+  "required": ["owner", "repo", "issue_number", "labels"],
+  "additionalProperties": false
+}
+

package/integration-data/github/schemas/close_issue.json

@@ -0,0 +1,10 @@
+{
+  "type": "object",
+  "properties": {
+    "owner": { "type": "string" },
+    "repo": { "type": "string" },
+    "issue_number": { "type": "integer", "minimum": 1 }
+  },
+  "required": ["owner", "repo", "issue_number"],
+  "additionalProperties": false
+}