[TOO-1175] docs(auth-providers): add Sentry provider page

app/en/references/auth-providers/page.mdx

@@ -113,6 +113,13 @@ For more information on how to customize your auth provider, select an auth prov
     link="/references/auth-providers/reddit"
     category="Auth"
   />
+  <ToolCard
+    name="Sentry"
+    image="sentry"
+    summary="Authorize tools and agents with Sentry"
+    link="/references/auth-providers/sentry"
+    category="Auth"
+  />
   <ToolCard
     name="Slack"
     image="slack"

app/en/references/auth-providers/sentry/page.mdx

@@ -0,0 +1,185 @@
+import { Tabs, Callout, Steps } from "nextra/components";
+
+# Sentry
+
+The Sentry auth provider enables tools and agents to call the [Sentry API](https://docs.sentry.io/api/) on behalf of a user.
+
+### What's documented here
+
+This page describes how to use and configure Sentry auth with Arcade.
+
+This auth provider is used by:
+
+- Your [app code](#using-sentry-auth-in-app-code) that needs to call the Sentry API
+- Or, your [custom tools](#using-sentry-auth-in-custom-tools) that need to call the Sentry API
+
+## Configuring Sentry auth
+
+<Callout type="info">
+  When using your own app credentials, make sure you configure your project to
+  use a [custom user
+  verifier](/guides/user-facing-agents/secure-auth-production#build-a-custom-user-verifier).
+  Without this, your end-users will not be able to use your app or agent in
+  production.
+</Callout>
+
+In a production environment, you will most likely want to use your own Sentry app credentials. This way, your users will see your application's name requesting permission.
+
+Before showing how to configure your Sentry app credentials, let's go through the steps to create a Sentry OAuth application.
+
+### Create a Sentry OAuth application
+
+- Sign in to Sentry and open [Settings → Account → API → Applications](https://sentry.io/settings/account/api/applications/).
+- Click **Create New Application**.
+- Give the application a name.
+- Add the **Authorized Redirect URI** generated by Arcade (see below).
+- Save the application, then copy its **Client ID** and **Client Secret**.
+
+Sentry requests scopes at authorization time rather than on the application itself. Choose the scopes your app or tools need when you call `auth.start()` (see the examples below). Common read scopes include:
+
+- `org:read`
+- `project:read`
+- `team:read`
+- `member:read`
+- `event:read`
+
+See Sentry's [permissions and scopes](https://docs.sentry.io/api/permissions/) reference for the full list.
+
+Next, add the Sentry app to Arcade.
+
+## Configuring your own Sentry Auth Provider in Arcade
+
+<Tabs items={["Dashboard GUI"]}>
+<Tabs.Tab>
+
+### Configure Sentry Auth Using the Arcade Dashboard GUI
+
+<Steps>
+
+#### Access the Arcade Dashboard
+
+To access the Arcade Cloud dashboard, go to [api.arcade.dev/dashboard](https://api.arcade.dev/dashboard). If you are self-hosting, by default the dashboard will be available at http://localhost:9099/dashboard. Adjust the host and port number to match your environment.
+
+#### Navigate to the OAuth Providers page
+
+- Under the **Connections** section of the Arcade Dashboard left-side menu, click **Connected Apps**.
+- Click **Add OAuth Provider** in the top right corner.
+- Select the **Included Providers** tab at the top.
+- In the **Provider** dropdown, select **Sentry**.
+
+#### Enter the provider details
+
+- Choose a unique **ID** for your provider (e.g. "my-sentry-provider").
+- Optionally enter a **Description**.
+- Enter the **Client ID** and **Client Secret** from your Sentry application.
+- Note the **Redirect URL** generated by Arcade. This must be added to your Sentry application's Authorized Redirect URIs.
+
+#### Create the provider
+
+Hit the **Create** button and the provider will be ready to be used.
+
+</Steps>
+
+When you use tools that require Sentry auth using your Arcade account credentials, Arcade will automatically use this Sentry OAuth provider. If you have multiple Sentry providers, see [using multiple auth providers of the same type](/references/auth-providers#using-multiple-providers-of-the-same-type) for more information.
+
+</Tabs.Tab>
+</Tabs>
+
+## Using Sentry auth in app code
+
+Use the Sentry auth provider in your own agents and AI apps to get a user token for the Sentry API. See [authorizing agents with Arcade](/get-started/about-arcade) to understand how this works.
+
+Use `client.auth.start()` to get a user token for the Sentry API:
+
+<Tabs items={["Python", "JavaScript"]} storageKey="preferredLanguage">
+<Tabs.Tab>
+
+```python {8-12}
+from arcadepy import Arcade
+
+client = Arcade()  # Automatically finds the `ARCADE_API_KEY` env variable
+
+user_id = "{arcade_user_id}"
+
+# Start the authorization process
+auth_response = client.auth.start(
+    user_id=user_id,
+    provider="sentry",
+    scopes=["org:read", "project:read"],
+)
+
+if auth_response.status != "completed":
+    print("Please complete the authorization challenge in your browser:")
+    print(auth_response.url)
+
+# Wait for the authorization to complete
+auth_response = client.auth.wait_for_completion(auth_response)
+
+token = auth_response.context.token
+# Do something interesting with the token...
+```
+
+</Tabs.Tab>
+
+<Tabs.Tab>
+
+```javascript {8-10}
+import { Arcade } from "@arcadeai/arcadejs";
+
+const client = new Arcade(); // Automatically finds the `ARCADE_API_KEY` env variable
+
+const userId = "{arcade_user_id}";
+
+// Start the authorization process
+let authResponse = await client.auth.start(userId, "sentry", {
+  scopes: ["org:read", "project:read"],
+});
+
+if (authResponse.status !== "completed") {
+  console.log("Please complete the authorization challenge in your browser:");
+  console.log(authResponse.url);
+}
+
+// Wait for the authorization to complete
+authResponse = await client.auth.waitForCompletion(authResponse);
+
+const token = authResponse.context.token;
+// Do something interesting with the token...
+```
+
+</Tabs.Tab>
+
+</Tabs>
+
+## Using Sentry auth in custom tools
+
+You can author your own [custom tools](/guides/create-tools/tool-basics/build-mcp-server) that interact with the Sentry API.
+
+Use the `Sentry()` auth class to specify that a tool requires authorization with Sentry. The `context.authorization.token` field will be automatically populated with the user's Sentry token:
+
+```python {5-6,9-13,21}
+from typing import Annotated
+
+import httpx
+
+from arcade_tdk import ToolContext, tool
+from arcade_tdk.auth import Sentry
+
+
+@tool(
+    requires_auth=Sentry(
+        scopes=["org:read"],
+    )
+)
+async def list_organizations(
+    context: ToolContext,
+) -> Annotated[list[dict], "The organizations the user can access"]:
+    """List the Sentry organizations the authorized user belongs to."""
+    url = "https://sentry.io/api/0/organizations/"
+    headers = {"Authorization": f"Bearer {context.authorization.token}"}
+
+    async with httpx.AsyncClient() as client:
+        response = await client.get(url, headers=headers)
+        response.raise_for_status()
+        return response.json()
+```

public/llms.txt

@@ -1,4 +1,4 @@
-<!-- git-sha: 168dbe9f1ea2583887eac41a6f20344ffa661b9c generation-date: 2026-06-10T18:11:23.362Z -->
+<!-- git-sha: c29737de7a54893046c10e1aa7ccb31437828bcc generation-date: 2026-06-14T07:07:14.997Z -->
 
 # Arcade
 
@@ -47,6 +47,7 @@ Arcade delivers three core capabilities: Deploy agents even your security team w
 - [References](https://docs.arcade.dev/en/references): This documentation page provides comprehensive reference materials for Arcade's APIs, MCP servers, and authentication providers, enabling users to effectively integrate and utilize these tools in their applications. It includes detailed sections on the Arcade REST API, MCP Server SDK, and various client libraries
 - [Resources](https://docs.arcade.dev/en/references/mcp/python/resources): Documentation page
 - [Salesforce](https://docs.arcade.dev/en/references/auth-providers/salesforce): This documentation page provides guidance on configuring the Salesforce authentication provider for use with Arcade, enabling users to call Salesforce APIs effectively. It outlines the steps for creating an External Client App, including necessary OAuth settings and scopes, ensuring that users can integrate their applications and
+- [Sentry](https://docs.arcade.dev/en/references/auth-providers/sentry): Documentation page
 - [Server](https://docs.arcade.dev/en/references/mcp/python/server): This documentation page provides a reference for the `MCPServer` class, detailing its functionalities for handling MCP protocol messages, middleware orchestration, and component management. It guides users on initializing the server, managing tools, resources, and prompts, and offers
 - [Settings](https://docs.arcade.dev/en/references/mcp/python/settings): This documentation page provides an overview of the `MCPSettings` configuration container for the Arcade MCP Server, detailing its structure and various sub-settings. Users will learn how to configure server settings, transport options, middleware behavior, and notification limits, as well
 - [Slack](https://docs.arcade.dev/en/references/auth-providers/slack): This documentation page provides guidance on configuring the Slack authentication provider within the Arcade platform, enabling users to call Slack APIs on behalf of their applications. It outlines the steps for creating a Slack app, setting up app credentials, and integrating Slack with Arcade, including