{
  "info": {
    "name": "Gist — mcp.ai",
    "description": "REST API for the Gist MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/gist",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "gist_check_gist_star",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/check/gist/star",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "check",
            "gist",
            "star"
          ]
        },
        "description": "Check if the authenticated user has starred a specific gist. Returns True if the gist is starred, False if not starred or if the gist doesn't exist. This is a read-only, idempotent operation that requ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"gist_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_create_gist",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/gist",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "gist"
          ]
        },
        "description": "Tool to create a new gist with one or more files. Use when you need to create a code snippet or text file to share. Note: Do not name your files 'gistfile' with a numerical suffix.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"files\": {},\n  \"public\": false,\n  \"description\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_create_gist_comment",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/gist/comment",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "gist",
            "comment"
          ]
        },
        "description": "Tool to create a comment on a gist. Use when you need to add a comment to an existing gist.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"body\": \"\",\n  \"gist_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_delete_gist",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/gist",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "gist"
          ]
        },
        "description": "Tool to delete a gist. Use when you have a gist_id and want to permanently remove that gist. Example prompt: \"Delete gist 'aa5a315d61ae9438b18d'\".",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"gist_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_delete_gist_comment",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/gist/comment",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "gist",
            "comment"
          ]
        },
        "description": "Tool to delete a comment on a gist. Use when you have both the gist_id and comment_id and want to remove that comment. Example prompt: \"Delete comment 42 from gist 'aa5a315d61ae9438b18d'\".",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"gist_id\": \"\",\n  \"comment_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_fork_gist",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fork/gist",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fork",
            "gist"
          ]
        },
        "description": "Tool to fork a gist. Use when you need to create a copy of an existing gist under your own account.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"gist_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_get_gist",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/gist",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "gist"
          ]
        },
        "description": "Tool to retrieve a specific gist by its ID. Use when you have a gist_id and need complete gist details.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"gist_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_get_gist_comment",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/gist/comment",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "gist",
            "comment"
          ]
        },
        "description": "Tool to get a specific comment on a gist. Use when you need to retrieve details of a particular comment given gist_id and comment_id.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"gist_id\": \"\",\n  \"comment_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_get_gist_revision",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/gist/revision",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "gist",
            "revision"
          ]
        },
        "description": "Tool to retrieve a specific gist revision. Use when you need details of a past state for an existing gist by commit SHA.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"sha\": \"\",\n  \"gist_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_list_gist_comments",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/gist/comments",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "gist",
            "comments"
          ]
        },
        "description": "Tool to list comments on a gist. Use after confirming the gist_id to retrieve comments for a specific gist. Example: 'List comments for gist abc123'.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"gist_id\": \"\",\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_list_gist_commits",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/gist/commits",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "gist",
            "commits"
          ]
        },
        "description": "Tool to list the commit history of a gist. Use after you have the gist ID to review its revisions.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"accept\": \"\",\n  \"gist_id\": \"\",\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_list_gist_forks",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/gist/forks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "gist",
            "forks"
          ]
        },
        "description": "Tool to list forks of a gist. Use after obtaining a gist_id to retrieve all forks for the gist.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"gist_id\": \"\",\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_list_gists",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/gists",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "gists"
          ]
        },
        "description": "Tool to list the authenticated user's gists or all public gists if called anonymously. Use after setting a valid GitHub token in headers.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"since\": \"\",\n  \"accept\": \"\",\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_list_public_gists",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/public/gists",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "public",
            "gists"
          ]
        },
        "description": "Tool to list public gists sorted by most recently updated. Use when you need to discover recent public gists. Note: with pagination, you can fetch up to 3000 gists.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"since\": \"\",\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_list_starred_gists",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/starred/gists",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "starred",
            "gists"
          ]
        },
        "description": "Tool to list the authenticated user's starred gists. Use when you need to retrieve all gists the user has starred.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"since\": \"\",\n  \"accept\": \"\",\n  \"per_page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_list_user_gists",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/user/gists",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "user",
            "gists"
          ]
        },
        "description": "Tool to list public gists for a specified GitHub user. Use when you have a username and need their gists.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"since\": \"\",\n  \"per_page\": 0,\n  \"username\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_star_gist",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/star/gist",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "star",
            "gist"
          ]
        },
        "description": "Star a GitHub gist. This operation is idempotent and will succeed even if the gist is already starred.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"gist_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_unstar_gist",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/unstar/gist",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "unstar",
            "gist"
          ]
        },
        "description": "Unstar a GitHub gist. This operation is idempotent and will succeed even if the gist is not currently starred.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"gist_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_update_gist",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/gist",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "gist"
          ]
        },
        "description": "Tool to update a gist's description and files. Use when you need to modify gist content, rename files, or delete files from a gist.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"files\": {},\n  \"gist_id\": \"\",\n  \"description\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "gist_update_gist_comment",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/gist/comment",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "gist",
            "comment"
          ]
        },
        "description": "Tool to update a Gist comment. Updates an existing comment on a gist. You must be the author of the comment to update it.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"body\": \"\",\n  \"gist_id\": \"\",\n  \"comment_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}