sentry_tools_extracted.json

[
  {
    "name": "analyze_issue_with_seer",
    "description": "Use Seer to analyze production errors and get detailed root cause analysis with specific code fixes.\n\nUse this tool when:\n- The user explicitly asks for root cause analysis, Seer analysis, or help fixing/debugging an issue\n- You are unable to accurately determine the root cause from the issue details alone\n\nDo NOT call this tool as an automatic follow-up to get_issue_details.\n\nWhat this tool provides:\n- Root cause analysis with code-level explanations\n- Specific file locations and line numbers where errors occur\n- Concrete code fixes you can apply\n- Step-by-step implementation guidance\n\nThis tool automatically:\n1. Checks if analysis already exists (instant results)\n2. Starts new AI analysis if needed (~2-5 minutes)\n3. Returns complete fix recommendations\n\n<examples>\n### User: \"Run Seer on this issue\"\n\n```\nanalyze_issue_with_seer(issueUrl='https://my-org.sentry.io/issues/PROJECT-1Z43')\n```\n\n### User: \"Analyze this issue and suggest a fix\"\n\n```\nanalyze_issue_with_seer(organizationSlug='my-organization', issueId='ERROR-456')\n```\n</examples>\n\n<hints>\n- Only use when the user explicitly requests analysis or you cannot determine the root cause from issue details alone\n- If the user provides an issueUrl, extract it and use that parameter alone\n- The analysis includes actual code snippets and fixes, not just error descriptions\n- Results are cached - subsequent calls return instantly\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        },
        "issueId": {
          "type": "string",
          "description": "The Issue ID. e.g. `PROJECT-1Z43`"
        },
        "issueUrl": {
          "type": "string",
          "format": "uri",
          "description": "The URL of the issue. e.g. https://my-organization.sentry.io/issues/PROJECT-1Z43"
        },
        "instruction": {
          "type": "string",
          "description": "Optional custom instruction for the AI analysis"
        }
      },
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": []
  },
  {
    "name": "create_dsn",
    "description": "Create an additional DSN for an EXISTING project.\n\nUSE THIS TOOL WHEN:\n- Project already exists and needs additional DSN\n- 'Create another DSN for project X'\n- 'I need a production DSN for existing project'\n\nDO NOT USE for new projects (use create_project instead)\n\nBe careful when using this tool!\n\n<examples>\n### Create additional DSN for existing project\n```\ncreate_dsn(organizationSlug='my-organization', projectSlug='my-project', name='Production')\n```\n</examples>\n\n<hints>\n- If the user passes a parameter in the form of name/otherName, its likely in the format of <organizationSlug>/<projectSlug>.\n- If any parameter is ambiguous, you should clarify with the user what they meant.\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        },
        "projectSlug": {
          "type": "string",
          "description": "The project's slug. You can find a list of existing projects in an organization using the `find_projects()` tool."
        },
        "name": {
          "type": "string",
          "description": "The name of the DSN to create, for example 'Production'."
        }
      },
      "required": ["organizationSlug", "projectSlug", "name"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["project:write"]
  },
  {
    "name": "create_project",
    "description": "Create a new project in Sentry (includes DSN automatically).\n\nUSE THIS TOOL WHEN USERS WANT TO:\n- 'Create a new project'\n- 'Set up a project for [app/service] with team [X]'\n- 'I need a new Sentry project'\n- Create project AND need DSN in one step\n\nDO NOT USE create_dsn after this - DSN is included in output.\n\nBe careful when using this tool!\n\n<examples>\n### Create new project with team\n```\ncreate_project(organizationSlug='my-organization', teamSlug='my-team', name='my-project', platform='javascript')\n```\n</examples>\n\n<hints>\n- If the user passes a parameter in the form of name/otherName, its likely in the format of <organizationSlug>/<teamSlug>.\n- If any parameter is ambiguous, you should clarify with the user what they meant.\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        },
        "teamSlug": {
          "type": "string",
          "description": "The team's slug. You can find a list of existing teams in an organization using the `find_teams()` tool."
        },
        "name": {
          "type": "string",
          "description": "The name of the project to create. Typically this is commonly the name of the repository or service. It is only used as a visual label in Sentry."
        },
        "platform": {
          "anyOf": [
            {
              "type": "string",
              "description": "The platform for the project. e.g., python, javascript, react, etc."
            },
            {
              "type": "null"
            }
          ],
          "description": "The platform for the project. e.g., python, javascript, react, etc.",
          "default": null
        }
      },
      "required": ["organizationSlug", "teamSlug", "name"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["project:write", "team:read"]
  },
  {
    "name": "create_team",
    "description": "Create a new team in Sentry.\n\nUSE THIS TOOL WHEN USERS WANT TO:\n- 'Create a new team'\n- 'Set up a team called [X]'\n- 'I need a team for my project'\n\nBe careful when using this tool!\n\n<examples>\n### Create a new team\n```\ncreate_team(organizationSlug='my-organization', name='the-goats')\n```\n</examples>\n\n<hints>\n- If any parameter is ambiguous, you should clarify with the user what they meant.\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        },
        "name": {
          "type": "string",
          "description": "The name of the team to create."
        }
      },
      "required": ["organizationSlug", "name"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["team:write"]
  },
  {
    "name": "find_dsns",
    "description": "List all Sentry DSNs for a specific project.\n\nUse this tool when you need to:\n- Retrieve a SENTRY_DSN for a specific project\n\n<hints>\n- If the user passes a parameter in the form of name/otherName, its likely in the format of <organizationSlug>/<projectSlug>.\n- If only one parameter is provided, and it could be either `organizationSlug` or `projectSlug`, its probably `organizationSlug`, but if you're really uncertain you might want to call `find_organizations()` first.\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        },
        "projectSlug": {
          "type": "string",
          "description": "The project's slug. You can find a list of existing projects in an organization using the `find_projects()` tool."
        }
      },
      "required": ["organizationSlug", "projectSlug"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["project:read"]
  },
  {
    "name": "find_organizations",
    "description": "Find organizations that the user has access to in Sentry.\n\nUse this tool when you need to:\n- View organizations in Sentry\n- Find an organization's slug to aid other tool requests\n- Search for specific organizations by name or slug\n\nReturns up to 25 results. If you hit this limit, use the query parameter to narrow down results.",
    "inputSchema": {
      "type": "object",
      "properties": {
        "query": {
          "anyOf": [
            {
              "type": "string",
              "description": "Search query to filter results by name or slug. Use this to narrow down results when there are many items."
            },
            {
              "type": "null"
            }
          ],
          "description": "Search query to filter results by name or slug. Use this to narrow down results when there are many items.",
          "default": null
        }
      },
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["org:read"]
  },
  {
    "name": "find_projects",
    "description": "Find projects in Sentry.\n\nUse this tool when you need to:\n- View projects in a Sentry organization\n- Find a project's slug to aid other tool requests\n- Search for specific projects by name or slug\n\nReturns up to 25 results. If you hit this limit, use the query parameter to narrow down results.",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        },
        "query": {
          "anyOf": [
            {
              "type": "string",
              "description": "Search query to filter results by name or slug. Use this to narrow down results when there are many items."
            },
            {
              "type": "null"
            }
          ],
          "description": "Search query to filter results by name or slug. Use this to narrow down results when there are many items.",
          "default": null
        }
      },
      "required": ["organizationSlug"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["project:read"]
  },
  {
    "name": "find_releases",
    "description": "Find releases in Sentry.\n\nUse this tool when you need to:\n- Find recent releases in a Sentry organization\n- Find the most recent version released of a specific project\n- Determine when a release was deployed to an environment\n\n<examples>\n### Find the most recent releases in the 'my-organization' organization\n\n```\nfind_releases(organizationSlug='my-organization')\n```\n\n### Find releases matching '2ce6a27' in the 'my-organization' organization\n\n```\nfind_releases(organizationSlug='my-organization', query='2ce6a27')\n```\n</examples>\n\n<hints>\n- If the user passes a parameter in the form of name/otherName, its likely in the format of <organizationSlug>/<projectSlug>.\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        },
        "projectSlug": {
          "anyOf": [
            {
              "type": "string",
              "description": "The project's slug. This will default to all projects you have access to. It is encouraged to specify this when possible."
            },
            {
              "type": "null"
            }
          ],
          "description": "The project's slug. This will default to all projects you have access to. It is encouraged to specify this when possible.",
          "default": null
        },
        "query": {
          "anyOf": [
            {
              "type": "string",
              "description": "Search for versions which contain the provided string."
            },
            {
              "type": "null"
            }
          ],
          "description": "Search for versions which contain the provided string.",
          "default": null
        }
      },
      "required": ["organizationSlug"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["project:read"]
  },
  {
    "name": "find_teams",
    "description": "Find teams in an organization in Sentry.\n\nUse this tool when you need to:\n- View teams in a Sentry organization\n- Find a team's slug and numeric ID to aid other tool requests\n- Search for specific teams by name or slug\n\nReturns up to 25 results. If you hit this limit, use the query parameter to narrow down results.",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        },
        "query": {
          "anyOf": [
            {
              "type": "string",
              "description": "Search query to filter results by name or slug. Use this to narrow down results when there are many items."
            },
            {
              "type": "null"
            }
          ],
          "description": "Search query to filter results by name or slug. Use this to narrow down results when there are many items.",
          "default": null
        }
      },
      "required": ["organizationSlug"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["team:read"]
  },
  {
    "name": "get_doc",
    "description": "Fetch the full markdown content of a Sentry documentation page.\n\nUse this tool when you need to:\n- Read the complete documentation for a specific topic\n- Get detailed implementation examples or code snippets\n- Access the full context of a documentation page\n- Extract specific sections from documentation\n\n<examples>\n### Get the Next.js integration guide\n\n```\nget_doc(path='/platforms/javascript/guides/nextjs.md')\n```\n</examples>\n\n<hints>\n- Use the path from search_docs results for accurate fetching\n- Paths should end with .md extension\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "path": {
          "type": "string",
          "description": "The documentation path (e.g., '/platforms/javascript/guides/nextjs.md'). Get this from search_docs results."
        }
      },
      "required": ["path"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": []
  },
  {
    "name": "get_event_attachment",
    "description": "Download attachments from a Sentry event.\n\nUse this tool when you need to:\n- Download files attached to a specific event\n- Access screenshots, log files, or other attachments uploaded with an error report\n- Retrieve attachment metadata and download URLs\n\n<examples>\n### Download a specific attachment by ID\n\n```\nget_event_attachment(organizationSlug='my-organization', projectSlug='my-project', eventId='c49541c747cb4d8aa3efb70ca5aba243', attachmentId='12345')\n```\n\n### List all attachments for an event\n\n```\nget_event_attachment(organizationSlug='my-organization', projectSlug='my-project', eventId='c49541c747cb4d8aa3efb70ca5aba243')\n```\n\n</examples>\n\n<hints>\n- If `attachmentId` is provided, the specific attachment will be downloaded as an embedded resource\n- If `attachmentId` is omitted, all attachments for the event will be listed with download information\n- The `projectSlug` is required to identify which project the event belongs to\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        },
        "projectSlug": {
          "type": "string",
          "description": "The project's slug. You can find a list of existing projects in an organization using the `find_projects()` tool."
        },
        "eventId": {
          "type": "string",
          "description": "The ID of the event."
        },
        "attachmentId": {
          "anyOf": [
            {
              "type": "string",
              "description": "The ID of the attachment to download."
            },
            {
              "type": "null"
            }
          ],
          "description": "The ID of the attachment to download.",
          "default": null
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        }
      },
      "required": ["organizationSlug", "projectSlug", "eventId"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["event:read"]
  },
  {
    "name": "get_issue_details",
    "description": "Get detailed information about a specific Sentry issue by ID.\n\nUSE THIS TOOL WHEN USERS:\n- Provide a specific issue ID (e.g., 'CLOUDFLARE-MCP-41', 'PROJECT-123')\n- Ask to 'explain [ISSUE-ID]', 'tell me about [ISSUE-ID]'\n- Want details/stacktrace/analysis for a known issue\n- Provide a Sentry issue URL\n\nDO NOT USE for:\n- General searching or listing issues (use search_issues)\n\nTRIGGER PATTERNS:\n- 'Explain ISSUE-123' → use get_issue_details\n- 'Tell me about PROJECT-456' → use get_issue_details\n- 'What happened in [issue URL]' → use get_issue_details\n\n<examples>\n### With Sentry URL (recommended - simplest approach)\n```\nget_issue_details(issueUrl='https://sentry.sentry.io/issues/6916805731/?project=4509062593708032&query=is%3Aunresolved')\n```\n\n### With issue ID and organization\n```\nget_issue_details(organizationSlug='my-organization', issueId='CLOUDFLARE-MCP-41')\n```\n\n### With event ID and organization\n```\nget_issue_details(organizationSlug='my-organization', eventId='c49541c747cb4d8aa3efb70ca5aba243')\n```\n</examples>\n\n<hints>\n- **IMPORTANT**: If user provides a Sentry URL, pass the ENTIRE URL to issueUrl parameter unchanged\n- When using issueUrl, all other parameters are automatically extracted - don't provide them separately\n- If using issueId (not URL), then organizationSlug is required\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        },
        "issueId": {
          "type": "string",
          "description": "The Issue ID. e.g. `PROJECT-1Z43`"
        },
        "eventId": {
          "type": "string",
          "description": "The ID of the event."
        },
        "issueUrl": {
          "type": "string",
          "format": "uri",
          "description": "The URL of the issue. e.g. https://my-organization.sentry.io/issues/PROJECT-1Z43"
        }
      },
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["event:read"]
  },
  {
    "name": "get_issue_tag_values",
    "description": "Get tag value distribution for a specific Sentry issue.\n\nUse this tool when you need to:\n- Understand how an issue is distributed across different tag values\n- Get aggregate counts of unique tag values (e.g., 'how many unique URLs are affected')\n- Analyze which browsers, environments, or URLs are most impacted by an issue\n- View the tag distributions page data programmatically\n\nCommon tag keys:\n- `url`: Request URLs affected by the issue\n- `browser`: Browser types and versions\n- `browser.name`: Browser names only\n- `os`: Operating systems\n- `environment`: Deployment environments (production, staging, etc.)\n- `release`: Software releases\n- `device`: Device types\n- `user`: Affected users\n\n<examples>\n### Get URL distribution for an issue\n```\nget_issue_tag_values(organizationSlug='my-organization', issueId='PROJECT-123', tagKey='url')\n```\n\n### Get browser distribution using issue URL\n```\nget_issue_tag_values(issueUrl='https://sentry.io/issues/PROJECT-123/', tagKey='browser')\n```\n\n### Get environment distribution\n```\nget_issue_tag_values(organizationSlug='my-organization', issueId='PROJECT-123', tagKey='environment')\n```\n</examples>\n\n<hints>\n- If user provides a Sentry URL, pass the ENTIRE URL to issueUrl parameter unchanged\n- Common tag keys: url, browser, browser.name, os, environment, release, device, user\n- Tag keys are case-sensitive\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        },
        "issueId": {
          "type": "string",
          "description": "The Issue ID. e.g. `PROJECT-1Z43`"
        },
        "issueUrl": {
          "type": "string",
          "format": "uri",
          "description": "The URL of the issue. e.g. https://my-organization.sentry.io/issues/PROJECT-1Z43"
        },
        "tagKey": {
          "type": "string",
          "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*$",
          "description": "The tag key to get values for (e.g., 'url', 'browser', 'environment', 'release')."
        }
      },
      "required": ["tagKey"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["event:read"]
  },
  {
    "name": "get_sentry_resource",
    "description": "Fetch a Sentry resource by URL or by type and ID.\n\n<examples>\n### From a Sentry URL\nget_sentry_resource(url='https://sentry.io/issues/PROJECT-123/')\n\n### Breadcrumbs from a Sentry URL\nget_sentry_resource(url='https://sentry.io/issues/PROJECT-123/', resourceType='breadcrumbs')\n\n### By type and ID\nget_sentry_resource(resourceType='issue', organizationSlug='my-org', resourceId='PROJECT-123')\n</examples>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "url": {
          "type": "string",
          "format": "uri",
          "description": "Sentry URL. The resource type is auto-detected from the URL pattern."
        },
        "resourceType": {
          "type": "string",
          "enum": ["issue", "event", "trace", "breadcrumbs"],
          "description": "Resource type. With a URL, overrides the auto-detected type (e.g., 'breadcrumbs' on an issue URL)."
        },
        "resourceId": {
          "type": "string",
          "description": "Resource identifier: issue shortId (e.g., 'PROJECT-123'), event ID, or trace ID. Required when not using a URL."
        },
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        }
      },
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["event:read"]
  },
  {
    "name": "get_trace_details",
    "description": "Get detailed information about a specific Sentry trace by ID.\n\nUSE THIS TOOL WHEN USERS:\n- Provide a specific trace ID (e.g., 'a4d1aae7216b47ff8117cf4e09ce9d0a')\n- Ask to 'show me trace [TRACE-ID]', 'explain trace [TRACE-ID]'\n- Want high-level overview and link to view trace details in Sentry\n- Need trace statistics and span breakdown\n\nDO NOT USE for:\n- General searching for traces (use search_events with trace queries)\n- Individual span details (this shows trace overview)\n\nTRIGGER PATTERNS:\n- 'Show me trace abc123' → use get_trace_details\n- 'Explain trace a4d1aae7216b47ff8117cf4e09ce9d0a' → use get_trace_details\n- 'What is trace [trace-id]' → use get_trace_details\n\n<examples>\n### Get trace overview\n```\nget_trace_details(organizationSlug='my-organization', traceId='a4d1aae7216b47ff8117cf4e09ce9d0a')\n```\n</examples>\n\n<hints>\n- Trace IDs are 32-character hexadecimal strings\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        },
        "traceId": {
          "type": "string",
          "pattern": "^[0-9a-fA-F]{32}$",
          "description": "The trace ID. e.g. `a4d1aae7216b47ff8117cf4e09ce9d0a`"
        }
      },
      "required": ["organizationSlug", "traceId"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["event:read"]
  },
  {
    "name": "list_events",
    "description": "Search events using Sentry query syntax directly (no AI/LLM required).\n\nUse this tool when:\n- You know Sentry query syntax already\n- AI-powered search is unavailable (no OPENAI_API_KEY or ANTHROPIC_API_KEY)\n- You want precise control over the query\n\nFor natural language queries, use search_events instead.\n\nDatasets:\n- errors: Exception/crash events\n- logs: Log entries\n- spans: Performance data, traces, AI/LLM calls\n\nQuery Syntax Examples:\n- message:\"connection timeout\"\n- level:error\n- span.op:http.client span.status_code:500\n- log.level:error\n- transaction:/api/users\n\n<examples>\nlist_events(organizationSlug='my-org', dataset='errors', query='level:error')\nlist_events(organizationSlug='my-org', dataset='spans', query='span.op:db')\nlist_events(organizationSlug='my-org', dataset='logs', query='severity:error')\nlist_events(organizationSlug='my-org', dataset='errors', fields=['issue', 'count()'], sort='-count()')\n</examples>\n\n<hints>\n- If the user passes a parameter in the form of name/otherName, it's likely in the format of <organizationSlug>/<projectSlug>.\n- Use fields with aggregate functions like count(), avg(), sum() for statistics\n- Sort by -count() for most common, -timestamp for newest\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        },
        "dataset": {
          "type": "string",
          "enum": ["errors", "logs", "spans"],
          "default": "errors",
          "description": "Dataset to query: errors (exceptions), logs, or spans (traces)"
        },
        "query": {
          "type": "string",
          "default": "",
          "description": "Sentry event search query syntax (empty for all events)"
        },
        "fields": {
          "anyOf": [
            {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Fields to return. If not specified, uses sensible defaults. Include aggregate functions like count(), avg() for statistics."
        },
        "sort": {
          "type": "string",
          "default": "-timestamp",
          "description": "Sort field (prefix with - for descending). Use -count() for aggregations."
        },
        "projectSlug": {
          "anyOf": [
            {
              "type": "string",
              "description": "The project's slug. You can find a list of existing projects in an organization using the `find_projects()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The project's slug. You can find a list of existing projects in an organization using the `find_projects()` tool.",
          "default": null
        },
        "statsPeriod": {
          "type": "string",
          "default": "14d",
          "description": "Time period: 1h, 24h, 7d, 14d, 30d, etc."
        },
        "limit": {
          "type": "number",
          "minimum": 1,
          "maximum": 100,
          "default": 10,
          "description": "Maximum number of results to return (1-100)"
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        }
      },
      "required": ["organizationSlug"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["event:read"]
  },
  {
    "name": "list_issue_events",
    "description": "List events within a specific issue using Sentry query syntax (no AI/LLM required).\n\nUse this tool when:\n- You know Sentry query syntax already\n- AI-powered search is unavailable (no OPENAI_API_KEY or ANTHROPIC_API_KEY)\n- You want precise control over the query\n\nFor natural language queries, use search_issue_events instead.\n\nCommon Query Filters:\n- environment:production - Filter by environment\n- release:1.0.0 - Filter by release version\n- user.email:alice@example.com - Filter by user email\n- timestamp:>2024-01-01 - Filter by timestamp\n\n<examples>\nlist_issue_events(issueUrl='https://sentry.io/organizations/my-org/issues/123/', query='environment:production')\nlist_issue_events(issueId='MCP-41', organizationSlug='my-org', query='release:v1.0.0')\nlist_issue_events(issueId='PROJECT-123', organizationSlug='my-org', statsPeriod='1h')\n</examples>\n\n<hints>\n- Use issueUrl for convenience (includes org + issue ID)\n- Or provide both issueId and organizationSlug\n- The query filters events WITHIN the issue, no need for issue: prefix\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "anyOf": [
            {
              "type": "string",
              "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "Organization slug. Required when using issueId. Not needed when using issueUrl.",
          "default": null
        },
        "issueId": {
          "type": "string",
          "description": "Issue ID (e.g., 'MCP-41', 'PROJECT-123'). Requires organizationSlug."
        },
        "issueUrl": {
          "type": "string",
          "format": "uri",
          "description": "Full Sentry issue URL. Includes both organization and issue ID."
        },
        "query": {
          "type": "string",
          "default": "",
          "description": "Sentry event search query syntax (empty for all events)"
        },
        "sort": {
          "type": "string",
          "default": "-timestamp",
          "description": "Sort field (prefix with - for descending). Default: -timestamp"
        },
        "statsPeriod": {
          "type": "string",
          "default": "14d",
          "description": "Time period: 1h, 24h, 7d, 14d, 30d, etc."
        },
        "limit": {
          "type": "number",
          "minimum": 1,
          "maximum": 100,
          "default": 50,
          "description": "Maximum number of events to return (1-100)"
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        }
      },
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["event:read"]
  },
  {
    "name": "list_issues",
    "description": "List issues using Sentry query syntax directly (no AI/LLM required).\n\nUse this tool when:\n- You know Sentry query syntax already\n- AI-powered search is unavailable (no OPENAI_API_KEY or ANTHROPIC_API_KEY)\n- You want precise control over the query\n\nFor natural language queries, use search_issues instead.\n\nCommon Query Syntax:\n- is:unresolved - Show unresolved issues only\n- is:unassigned - Show unassigned issues\n- level:error - Filter by error level\n- firstSeen:-24h - First seen in last 24 hours\n- lastSeen:-1h - Last seen in last hour\n- has:user - Issues with user context\n- user.email:user@example.com - Filter by user email\n- environment:production - Filter by environment\n- release:1.0.0 - Filter by release version\n\nCombine queries: is:unresolved is:unassigned level:error\n\n<examples>\nlist_issues(organizationSlug='my-org', query='is:unresolved is:unassigned')\nlist_issues(organizationSlug='my-org', query='level:error firstSeen:-24h', sort='freq')\nlist_issues(organizationSlug='my-org', projectSlugOrId='my-project', query='is:unresolved')\n</examples>\n\n<hints>\n- If the user passes a parameter in the form of name/otherName, it's likely in the format of <organizationSlug>/<projectSlugOrId>.\n- The projectSlugOrId parameter accepts both project slugs (e.g., 'my-project') and numeric IDs (e.g., '123456').\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        },
        "query": {
          "type": "string",
          "default": "is:unresolved",
          "description": "Sentry issue search query syntax"
        },
        "projectSlugOrId": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Filter by project slug or numeric ID (optional)"
        },
        "sort": {
          "type": "string",
          "enum": ["date", "freq", "new", "user"],
          "default": "date",
          "description": "Sort order: date (last seen), freq (frequency), new (first seen), user (user count)"
        },
        "limit": {
          "type": "number",
          "minimum": 1,
          "maximum": 100,
          "default": 10,
          "description": "Maximum number of issues to return (1-100)"
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        }
      },
      "required": ["organizationSlug"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["event:read"]
  },
  {
    "name": "search_docs",
    "description": "Search Sentry documentation for SDK setup, instrumentation, and configuration guidance.\n\nUse this tool when you need to:\n- Set up Sentry SDK or framework integrations (Django, Flask, Express, Next.js, etc.)\n- Configure features like performance monitoring, error sampling, or release tracking\n- Implement custom instrumentation (spans, transactions, breadcrumbs)\n- Configure data scrubbing, filtering, or sampling rules\n\nReturns snippets only. Use `get_doc(path='...')` to fetch full documentation content.\n\n<examples>\n```\nsearch_docs(query='Django setup configuration SENTRY_DSN', guide='python/django')\nsearch_docs(query='source maps webpack upload', guide='javascript/nextjs')\n```\n</examples>\n\n<hints>\n- Use guide parameter to filter to specific technologies (e.g., 'javascript/nextjs')\n- Include specific feature names like 'beforeSend', 'tracesSampleRate', 'SENTRY_DSN'\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "minLength": 2,
          "maxLength": 200,
          "description": "The search query in natural language. Be specific about what you're looking for."
        },
        "maxResults": {
          "type": "integer",
          "minimum": 1,
          "maximum": 10,
          "default": 3,
          "description": "Maximum number of results to return (1-10)"
        },
        "guide": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "javascript",
                "python",
                "java",
                "dotnet",
                "go",
                "php",
                "ruby",
                "android",
                "apple",
                "unity",
                "unreal",
                "rust",
                "elixir",
                "kotlin",
                "native",
                "dart",
                "godot",
                "nintendo-switch",
                "playstation",
                "powershell",
                "react-native",
                "xbox",
                "javascript/nextjs",
                "javascript/react",
                "javascript/gatsby",
                "javascript/remix",
                "javascript/vue",
                "javascript/angular",
                "javascript/hono",
                "javascript/svelte",
                "javascript/express",
                "javascript/fastify",
                "javascript/astro",
                "javascript/bun",
                "javascript/capacitor",
                "javascript/cloudflare",
                "javascript/connect",
                "javascript/cordova",
                "javascript/deno",
                "javascript/electron",
                "javascript/ember",
                "javascript/nuxt",
                "javascript/solid",
                "javascript/solidstart",
                "javascript/sveltekit",
                "javascript/tanstack-react",
                "javascript/wasm",
                "javascript/node",
                "javascript/koa",
                "javascript/nestjs",
                "javascript/hapi",
                "python/django",
                "python/flask",
                "python/fastapi",
                "python/celery",
                "python/tornado",
                "python/pyramid",
                "python/aiohttp",
                "python/anthropic",
                "python/airflow",
                "python/aws-lambda",
                "python/boto3",
                "python/bottle",
                "python/chalice",
                "python/dramatiq",
                "python/falcon",
                "python/langchain",
                "python/litestar",
                "python/logging",
                "python/loguru",
                "python/openai",
                "python/quart",
                "python/ray",
                "python/redis",
                "python/rq",
                "python/sanic",
                "python/sqlalchemy",
                "python/starlette",
                "dart/flutter",
                "dotnet/aspnetcore",
                "dotnet/maui",
                "dotnet/wpf",
                "dotnet/winforms",
                "dotnet/aspnet",
                "dotnet/aws-lambda",
                "dotnet/azure-functions",
                "dotnet/blazor-webassembly",
                "dotnet/entityframework",
                "dotnet/google-cloud-functions",
                "dotnet/extensions-logging",
                "dotnet/log4net",
                "dotnet/nlog",
                "dotnet/serilog",
                "dotnet/uwp",
                "dotnet/xamarin",
                "java/spring",
                "java/spring-boot",
                "java/android",
                "java/jul",
                "java/log4j2",
                "java/logback",
                "java/servlet",
                "go/echo",
                "go/fasthttp",
                "go/fiber",
                "go/gin",
                "go/http",
                "go/iris",
                "go/logrus",
                "go/negroni",
                "go/slog",
                "go/zerolog",
                "php/laravel",
                "php/symfony",
                "ruby/delayed_job",
                "ruby/rack",
                "ruby/rails",
                "ruby/resque",
                "ruby/sidekiq",
                "android/kotlin",
                "apple/ios",
                "apple/macos",
                "apple/watchos",
                "apple/tvos",
                "apple/visionos",
                "kotlin/multiplatform"
              ],
              "description": "Optional guide filter to limit search results to specific documentation sections. Use either a platform (e.g., 'javascript', 'python') or platform/guide combination (e.g., 'javascript/nextjs', 'python/django')."
            },
            {
              "type": "null"
            }
          ],
          "description": "Optional guide filter to limit search results to specific documentation sections. Use either a platform (e.g., 'javascript', 'python') or platform/guide combination (e.g., 'javascript/nextjs', 'python/django').",
          "default": null
        }
      },
      "required": ["query"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": []
  },
  {
    "name": "search_events",
    "description": "Search for events AND perform counts/aggregations - the ONLY tool for statistics and counts.\n\nSupports TWO query types:\n1. AGGREGATIONS (counts, sums, averages): 'how many errors', 'count of issues', 'total tokens'\n2. Individual events with timestamps: 'show me error logs from last hour'\n\nUSE THIS FOR ALL COUNTS/STATISTICS:\n- 'how many errors today' → returns count\n- 'count of database failures' → returns count\n- 'total number of issues' → returns count\n- 'average response time' → returns avg()\n- 'sum of tokens used' → returns sum()\n\nALSO USE FOR INDIVIDUAL EVENTS:\n- 'error logs from last hour' → returns event list\n- 'database errors with timestamps' → returns event list\n- 'trace spans for slow API calls' → returns span list\n\nDataset Selection (AI automatically chooses):\n- errors: Exception/crash events\n- logs: Log entries\n- spans: Performance data, AI/LLM calls, token usage\n\nDO NOT USE for grouped issue lists → use search_issues\n\n<examples>\nsearch_events(organizationSlug='my-org', naturalLanguageQuery='how many errors today')\nsearch_events(organizationSlug='my-org', naturalLanguageQuery='count of database failures this week')\nsearch_events(organizationSlug='my-org', naturalLanguageQuery='total tokens used by model')\nsearch_events(organizationSlug='my-org', naturalLanguageQuery='error logs from the last hour')\n</examples>\n\n<hints>\n- If the user passes a parameter in the form of name/otherName, it's likely in the format of <organizationSlug>/<projectSlug>.\n- Parse org/project notation directly without calling find_organizations or find_projects.\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        },
        "naturalLanguageQuery": {
          "type": "string",
          "minLength": 1,
          "description": "Natural language description of what you want to search for"
        },
        "projectSlug": {
          "anyOf": [
            {
              "type": "string",
              "description": "The project's slug. You can find a list of existing projects in an organization using the `find_projects()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The project's slug. You can find a list of existing projects in an organization using the `find_projects()` tool.",
          "default": null
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        },
        "limit": {
          "type": "number",
          "minimum": 1,
          "maximum": 100,
          "default": 10,
          "description": "Maximum number of results to return"
        },
        "includeExplanation": {
          "type": "boolean",
          "default": false,
          "description": "Include explanation of how the query was translated"
        }
      },
      "required": ["organizationSlug", "naturalLanguageQuery"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["event:read"]
  },
  {
    "name": "search_issue_events",
    "description": "Search and filter events within a specific issue using natural language queries.\n\nUse this to filter events by time, environment, release, user, trace ID, or other tags. The tool automatically constrains results to the specified issue.\n\nFor cross-issue searches use search_issues, for single event details use get_issue_details.\n\n<examples>\nsearch_issue_events(issueId='MCP-41', organizationSlug='my-org', naturalLanguageQuery='from last hour')\nsearch_issue_events(issueUrl='https://sentry.io/.../issues/123/', naturalLanguageQuery='production with release v1.0')\n</examples>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "anyOf": [
            {
              "type": "string",
              "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "Organization slug. Required when using issueId. Not needed when using issueUrl.",
          "default": null
        },
        "issueId": {
          "type": "string",
          "description": "Issue ID (e.g., 'MCP-41', 'PROJECT-123'). Requires organizationSlug. Alternatively, use issueUrl."
        },
        "issueUrl": {
          "type": "string",
          "format": "uri",
          "description": "Full Sentry issue URL (e.g., 'https://sentry.io/organizations/my-org/issues/123/'). Includes both organization and issue ID."
        },
        "naturalLanguageQuery": {
          "type": "string",
          "minLength": 1,
          "description": "Natural language description of what events you want to find within this issue. Examples: 'from last hour', 'production with release v1.0', 'affecting user alice@example.com', 'with trace ID abc123'"
        },
        "projectSlug": {
          "anyOf": [
            {
              "type": "string",
              "description": "The project's slug. You can find a list of existing projects in an organization using the `find_projects()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "Project slug for better tag discovery. Optional - helps find project-specific tags.",
          "default": null
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "Sentry region URL. Optional - defaults to main region.",
          "default": null
        },
        "limit": {
          "type": "number",
          "minimum": 1,
          "maximum": 100,
          "default": 50,
          "description": "Maximum number of events to return (1-100, default: 50)"
        },
        "includeExplanation": {
          "type": "boolean",
          "default": false,
          "description": "Include explanation of how the natural language query was translated to Sentry syntax"
        }
      },
      "required": ["naturalLanguageQuery"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["event:read"]
  },
  {
    "name": "search_issues",
    "description": "Search for grouped issues/problems in Sentry - returns a LIST of issues, NOT counts or aggregations.\n\nUses AI to translate natural language queries into Sentry issue search syntax.\nReturns grouped issues with metadata like title, status, and user count.\n\nUSE THIS TOOL WHEN USERS WANT:\n- A LIST of issues: 'show me issues', 'what problems do we have'\n- Filtered issue lists: 'unresolved issues', 'critical bugs'\n- Issues by impact: 'errors affecting more than 100 users'\n- Issues by assignment: 'issues assigned to me'\n- User feedback: 'show me user feedback', 'feedback from last week'\n\nDO NOT USE FOR COUNTS/AGGREGATIONS:\n- 'how many errors' → use search_events\n- 'count of issues' → use search_events\n- 'total number of errors today' → use search_events\n- 'sum/average/statistics' → use search_events\n\nALSO DO NOT USE FOR:\n- Individual error events with timestamps → use search_events\n- Details about a specific issue ID → use get_issue_details\n\nREMEMBER: This tool returns a LIST of issues, not counts or statistics!\n\n<examples>\nsearch_issues(organizationSlug='my-org', naturalLanguageQuery='critical bugs from last week')\nsearch_issues(organizationSlug='my-org', naturalLanguageQuery='unhandled errors affecting 100+ users')\nsearch_issues(organizationSlug='my-org', naturalLanguageQuery='issues assigned to me')\nsearch_issues(organizationSlug='my-org', naturalLanguageQuery='user feedback from production')\n</examples>\n\n<hints>\n- If the user passes a parameter in the form of name/otherName, it's likely in the format of <organizationSlug>/<projectSlugOrId>.\n- Parse org/project notation directly without calling find_organizations or find_projects.\n- The projectSlugOrId parameter accepts both project slugs (e.g., 'my-project') and numeric IDs (e.g., '123456').\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        },
        "naturalLanguageQuery": {
          "type": "string",
          "minLength": 1,
          "description": "Natural language description of issues to search for"
        },
        "projectSlugOrId": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "The project's slug or numeric ID (optional)"
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        },
        "limit": {
          "type": "number",
          "minimum": 1,
          "maximum": 100,
          "default": 10,
          "description": "Maximum number of issues to return"
        },
        "includeExplanation": {
          "type": "boolean",
          "default": false,
          "description": "Include explanation of how the query was translated"
        }
      },
      "required": ["organizationSlug", "naturalLanguageQuery"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["event:read"]
  },
  {
    "name": "update_issue",
    "description": "Update an issue's status or assignment in Sentry. This allows you to resolve, ignore, or reassign issues.\n\nUse this tool when you need to:\n- Resolve an issue that has been fixed\n- Assign an issue to a team member or team for investigation\n- Mark an issue as ignored to reduce noise\n- Reopen a resolved issue by setting status to 'unresolved'\n\n<examples>\n### Resolve an issue\n\n```\nupdate_issue(organizationSlug='my-organization', issueId='PROJECT-123', status='resolved')\n```\n\n### Assign an issue to a user (use whoami to get your user ID)\n\n```\nupdate_issue(organizationSlug='my-organization', issueId='PROJECT-123', assignedTo='user:123456')\n```\n\n### Assign an issue to a team (by ID or slug)\n\n```\nupdate_issue(organizationSlug='my-organization', issueId='PROJECT-123', assignedTo='team:789')\nupdate_issue(organizationSlug='my-organization', issueId='PROJECT-123', assignedTo='team:my-team-slug')\n```\n\n### Mark an issue as ignored\n\n```\nupdate_issue(organizationSlug='my-organization', issueId='PROJECT-123', status='ignored')\n```\n\n</examples>\n\n<hints>\n- If the user provides the `issueUrl`, you can ignore the other required parameters and extract them from the URL.\n- At least one of `status` or `assignedTo` must be provided to update the issue.\n- assignedTo format: Use 'user:ID' for users (e.g., 'user:123456') or 'team:ID_OR_SLUG' for teams (e.g., 'team:789' or 'team:my-team-slug')\n- To find your user ID, first use the whoami tool which returns your numeric user ID\n- Valid status values are: 'resolved', 'resolvedInNextRelease', 'unresolved', 'ignored'.\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        },
        "issueId": {
          "type": "string",
          "description": "The Issue ID. e.g. `PROJECT-1Z43`"
        },
        "issueUrl": {
          "type": "string",
          "format": "uri",
          "description": "The URL of the issue. e.g. https://my-organization.sentry.io/issues/PROJECT-1Z43"
        },
        "status": {
          "type": "string",
          "enum": [
            "resolved",
            "resolvedInNextRelease",
            "unresolved",
            "ignored"
          ],
          "description": "The new status for the issue. Valid values are 'resolved', 'resolvedInNextRelease', 'unresolved', and 'ignored'."
        },
        "assignedTo": {
          "type": "string",
          "description": "The assignee in format 'user:ID' or 'team:ID_OR_SLUG' where ID is numeric. Example: 'user:123456', 'team:789', or 'team:my-team-slug'. Use the whoami tool to find your user ID."
        }
      },
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["event:write"]
  },
  {
    "name": "update_project",
    "description": "Update project settings in Sentry, such as name, slug, platform, and team assignment.\n\nBe careful when using this tool!\n\nUse this tool when you need to:\n- Update a project's name or slug to fix onboarding mistakes\n- Change the platform assigned to a project\n- Update team assignment for a project\n\n<examples>\n### Update a project's name and slug\n\n```\nupdate_project(organizationSlug='my-organization', projectSlug='old-project', name='New Project Name', slug='new-project-slug')\n```\n\n### Assign a project to a different team\n\n```\nupdate_project(organizationSlug='my-organization', projectSlug='my-project', teamSlug='backend-team')\n```\n\n### Update platform\n\n```\nupdate_project(organizationSlug='my-organization', projectSlug='my-project', platform='python')\n```\n\n</examples>\n\n<hints>\n- If the user passes a parameter in the form of name/otherName, it's likely in the format of <organizationSlug>/<projectSlug>.\n- Team assignment is handled separately from other project settings\n- If any parameter is ambiguous, you should clarify with the user what they meant.\n- When updating the slug, the project will be accessible at the new slug after the update\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "organizationSlug": {
          "type": "string",
          "description": "The organization's slug. You can find a existing list of organizations you have access to using the `find_organizations()` tool."
        },
        "regionUrl": {
          "anyOf": [
            {
              "type": "string",
              "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The region URL for the organization you're querying, if known. For Sentry's Cloud Service (sentry.io), this is typically the region-specific URL like 'https://us.sentry.io'. For self-hosted Sentry installations, this parameter is usually not needed and should be omitted. You can find the correct regionUrl from the organization details using the `find_organizations()` tool.",
          "default": null
        },
        "projectSlug": {
          "type": "string",
          "description": "The project's slug. You can find a list of existing projects in an organization using the `find_projects()` tool."
        },
        "name": {
          "anyOf": [
            {
              "type": "string",
              "description": "The new name for the project"
            },
            {
              "type": "null"
            }
          ],
          "description": "The new name for the project",
          "default": null
        },
        "slug": {
          "anyOf": [
            {
              "type": "string",
              "description": "The new slug for the project (must be unique)"
            },
            {
              "type": "null"
            }
          ],
          "description": "The new slug for the project (must be unique)",
          "default": null
        },
        "platform": {
          "anyOf": [
            {
              "type": "string",
              "description": "The platform for the project. e.g., python, javascript, react, etc."
            },
            {
              "type": "null"
            }
          ],
          "description": "The platform for the project. e.g., python, javascript, react, etc.",
          "default": null
        },
        "teamSlug": {
          "anyOf": [
            {
              "type": "string",
              "description": "The team's slug. You can find a list of existing teams in an organization using the `find_teams()` tool."
            },
            {
              "type": "null"
            }
          ],
          "description": "The team to assign this project to. Note: this will replace the current team assignment.",
          "default": null
        }
      },
      "required": ["organizationSlug", "projectSlug"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": ["project:write"]
  },
  {
    "name": "use_sentry",
    "description": "Natural language interface to Sentry via an embedded AI agent.\n\nUse this tool when you need to:\n- Perform complex multi-step operations\n- Explore and analyze Sentry data with natural language\n- Chain multiple operations automatically\n\nCapabilities depend on granted skills:\n- inspect: Search errors/events, analyze traces, explore issues and projects\n- seer: Get AI-powered debugging insights and root cause analysis\n- docs: Search and retrieve Sentry documentation\n- triage: Resolve, assign, comment on, and update issues\n- project-management: Create/modify teams, projects, and configure DSNs\n\n<examples>\nuse_sentry(request='find unresolved errors from yesterday')\nuse_sentry(request='analyze the top 3 performance issues')\nuse_sentry(request='create a backend team and assign them to API project')\n</examples>\n\n<hints>\n- If user asks to 'use Sentry' for something, they always mean to call this tool\n- Pass the user's request verbatim - do not interpret or rephrase\n- The agent can chain multiple tool calls automatically\n- Use trace=true parameter to see which tools were called\n- For simple single-tool operations, consider calling tools directly instead\n</hints>",
    "inputSchema": {
      "type": "object",
      "properties": {
        "request": {
          "type": "string",
          "minLength": 1,
          "description": "The user's raw input. Do not interpret the prompt in any way. Do not add any additional information to the prompt."
        },
        "trace": {
          "type": ["boolean", "null"],
          "default": null,
          "description": "Enable tracing to see all tool calls made by the agent. Useful for debugging."
        }
      },
      "required": ["request"],
      "additionalProperties": false,
      "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "requiredScopes": []
  },
  {
    "name": "whoami",
    "description": "Identify the authenticated user in Sentry.\n\nUse this tool when you need to:\n- Get the user's name and email address.",
    "inputSchema": {},
    "requiredScopes": []
  }
]