githubSearchIssues

Name	Required	Description	Default
`app`	No	GitHub App that created the issue
`archived`	No	Include archived repositories
`assignee`	No	GitHub username of assignee
`author`	No	GitHub username of issue creator
`closed`	No	When closed. Format: ">2020-01-01" (after), ">=2020-01-01" (on or after), "<2023-12-31" (before), "2020-01-01..2023-12-31" (range)
`commenter`	No	User who commented on issue
`comments`	No	Comment count filter. Format: ">10" (many comments), ">=5" (at least 5), "<5" (few comments), "5..10" (range), "10" (exact)
`created`	No	When created. Format: ">2020-01-01" (after), ">=2020-01-01" (on or after), "<2023-12-31" (before), "2020-01-01..2023-12-31" (range)
`include-prs`	No	Include pull requests. Default: false
`interactions`	No	Total interactions (reactions + comments) filter. Format: ">100" (highly engaged), ">=50" (moderately engaged), "<20" (low engagement), "50..200" (range)
`involves`	No	User involved in any way
`label`	No	Label names. Can be single string or array.
`language`	No	Repository language
`limit`	No	Results limit (1-50). Default: 25
`locked`	No	Conversation locked status
`match`	No	Search scope. Default: title and body. WARNING: "body" and "comments" are EXTREMELY expensive in tokens as they include full issue content and all comments.
`mentions`	No	Issues mentioning this user
`milestone`	No	Milestone name
`no-assignee`	No	Issues without assignee
`no-label`	No	Issues without labels
`no-milestone`	No	Issues without milestone
`no-project`	No	Issues not in projects
`order`	No	Sort order. Default: desc	desc
`owner`	No	Repository owner/organization name only (e.g., "facebook", "microsoft"). Do NOT include repository name. Must be used with repo parameter for repository-specific searches.
`project`	No	Project board number
`query`	Yes	Search terms. Start simple: "error", "crash". Use quotes for exact phrases.
`reactions`	No	Reaction count filter. Format: ">10" (popular), ">=5" (some reactions), "<50" (moderate), "5..50" (range), "10" (exact)
`repo`	No	Repository name only (e.g., "react", "vscode"). Do NOT include owner prefix. Must be used together with owner parameter.
`sort`	No	Sort by activity or reactions. Default: best match
`state`	No	Issue state. Default: all
`team-mentions`	No	Team mentioned in issue (@org/team-name)
`updated`	No	When updated. Format: ">2020-01-01" (after), ">=2020-01-01" (on or after), "<2023-12-31" (before), "2020-01-01..2023-12-31" (range)
`visibility`	No	Repository visibility

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "app": {
      "description": "GitHub App that created the issue",
      "type": "string"
    },
    "archived": {
      "description": "Include archived repositories",
      "type": "boolean"
    },
    "assignee": {
      "description": "GitHub username of assignee",
      "type": "string"
    },
    "author": {
      "description": "GitHub username of issue creator",
      "type": "string"
    },
    "closed": {
      "description": "When closed. Format: \">2020-01-01\" (after), \">=2020-01-01\" (on or after), \"<2023-12-31\" (before), \"2020-01-01..2023-12-31\" (range)",
      "pattern": "^(>=?\\d{4}-\\d{2}-\\d{2}|<=?\\d{4}-\\d{2}-\\d{2}|\\d{4}-\\d{2}-\\d{2}\\.\\.\\d{4}-\\d{2}-\\d{2}|\\d{4}-\\d{2}-\\d{2})$",
      "type": "string"
    },
    "commenter": {
      "description": "User who commented on issue",
      "type": "string"
    },
    "comments": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "pattern": "^(>=?\\d+|<=?\\d+|\\d+\\.\\.\\d+|\\d+)$",
          "type": "string"
        }
      ],
      "description": "Comment count filter. Format: \">10\" (many comments), \">=5\" (at least 5), \"<5\" (few comments), \"5..10\" (range), \"10\" (exact)"
    },
    "created": {
      "description": "When created. Format: \">2020-01-01\" (after), \">=2020-01-01\" (on or after), \"<2023-12-31\" (before), \"2020-01-01..2023-12-31\" (range)",
      "pattern": "^(>=?\\d{4}-\\d{2}-\\d{2}|<=?\\d{4}-\\d{2}-\\d{2}|\\d{4}-\\d{2}-\\d{2}\\.\\.\\d{4}-\\d{2}-\\d{2}|\\d{4}-\\d{2}-\\d{2})$",
      "type": "string"
    },
    "include-prs": {
      "description": "Include pull requests. Default: false",
      "type": "boolean"
    },
    "interactions": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "pattern": "^(>=?\\d+|<=?\\d+|\\d+\\.\\.\\d+|\\d+)$",
          "type": "string"
        }
      ],
      "description": "Total interactions (reactions + comments) filter. Format: \">100\" (highly engaged), \">=50\" (moderately engaged), \"<20\" (low engagement), \"50..200\" (range)"
    },
    "involves": {
      "description": "User involved in any way",
      "type": "string"
    },
    "label": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      ],
      "description": "Label names. Can be single string or array."
    },
    "language": {
      "description": "Repository language",
      "type": "string"
    },
    "limit": {
      "default": 25,
      "description": "Results limit (1-50). Default: 25",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "locked": {
      "description": "Conversation locked status",
      "type": "boolean"
    },
    "match": {
      "description": "Search scope. Default: title and body. WARNING: \"body\" and \"comments\" are EXTREMELY expensive in tokens as they include full issue content and all comments.",
      "enum": [
        "title",
        "body",
        "comments"
      ],
      "type": "string"
    },
    "mentions": {
      "description": "Issues mentioning this user",
      "type": "string"
    },
    "milestone": {
      "description": "Milestone name",
      "type": "string"
    },
    "no-assignee": {
      "description": "Issues without assignee",
      "type": "boolean"
    },
    "no-label": {
      "description": "Issues without labels",
      "type": "boolean"
    },
    "no-milestone": {
      "description": "Issues without milestone",
      "type": "boolean"
    },
    "no-project": {
      "description": "Issues not in projects",
      "type": "boolean"
    },
    "order": {
      "default": "desc",
      "description": "Sort order. Default: desc",
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string"
    },
    "owner": {
      "description": "Repository owner/organization name only (e.g., \"facebook\", \"microsoft\"). Do NOT include repository name. Must be used with repo parameter for repository-specific searches.",
      "minLength": 1,
      "type": "string"
    },
    "project": {
      "description": "Project board number",
      "type": "string"
    },
    "query": {
      "description": "Search terms. Start simple: \"error\", \"crash\". Use quotes for exact phrases.",
      "minLength": 1,
      "type": "string"
    },
    "reactions": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "integer"
        },
        {
          "pattern": "^(>=?\\d+|<=?\\d+|\\d+\\.\\.\\d+|\\d+)$",
          "type": "string"
        }
      ],
      "description": "Reaction count filter. Format: \">10\" (popular), \">=5\" (some reactions), \"<50\" (moderate), \"5..50\" (range), \"10\" (exact)"
    },
    "repo": {
      "description": "Repository name only (e.g., \"react\", \"vscode\"). Do NOT include owner prefix. Must be used together with owner parameter.",
      "type": "string"
    },
    "sort": {
      "description": "Sort by activity or reactions. Default: best match",
      "enum": [
        "comments",
        "created",
        "interactions",
        "reactions",
        "reactions-+1",
        "reactions--1",
        "reactions-heart",
        "reactions-smile",
        "reactions-tada",
        "reactions-thinking_face",
        "updated",
        "best-match"
      ],
      "type": "string"
    },
    "state": {
      "description": "Issue state. Default: all",
      "enum": [
        "open",
        "closed"
      ],
      "type": "string"
    },
    "team-mentions": {
      "description": "Team mentioned in issue (@org/team-name)",
      "type": "string"
    },
    "updated": {
      "description": "When updated. Format: \">2020-01-01\" (after), \">=2020-01-01\" (on or after), \"<2023-12-31\" (before), \"2020-01-01..2023-12-31\" (range)",
      "pattern": "^(>=?\\d{4}-\\d{2}-\\d{2}|<=?\\d{4}-\\d{2}-\\d{2}|\\d{4}-\\d{2}-\\d{2}\\.\\.\\d{4}-\\d{2}-\\d{2}|\\d{4}-\\d{2}-\\d{2})$",
      "type": "string"
    },
    "visibility": {
      "description": "Repository visibility",
      "enum": [
        "public",
        "private",
        "internal"
      ],
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Octocode MCP

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Octocode MCP

Related Tools

MCP directory API