diff --git a/app/en/home/_meta.tsx b/app/en/home/_meta.tsx
index ff7c4d069..f1b2942ae 100644
--- a/app/en/home/_meta.tsx
+++ b/app/en/home/_meta.tsx
@@ -61,13 +61,17 @@ export const meta: MetaRecord = {
   "serve-tools": {
     title: "Serve tools",
   },
-  "-- Agent Frameworks and MCP": {
+  "-- Tool Calling in Apps": {
     type: "separator",
-    title: "Agent Frameworks and MCP",
+    title: "Tool Calling in Apps",
   },
   "mcp-clients": {
     title: "MCP Clients",
   },
+  "-- Agent Frameworks": {
+    type: "separator",
+    title: "Agent Frameworks",
+  },
   langchain: {
     title: "LangChain",
   },
diff --git a/app/en/home/mcp-clients/_meta.tsx b/app/en/home/mcp-clients/_meta.tsx
index 17570ed1d..831caa299 100644
--- a/app/en/home/mcp-clients/_meta.tsx
+++ b/app/en/home/mcp-clients/_meta.tsx
@@ -1,5 +1,5 @@
 export default {
   cursor: "Cursor",
-  "claude-desktop": "Claude Desktop",
   "visual-studio-code": "Visual Studio Code",
+  "claude-desktop": "Claude Desktop",
 };
diff --git a/app/en/home/mcp-clients/cursor/page.mdx b/app/en/home/mcp-clients/cursor/page.mdx
index d22dc925f..feb3e799f 100644
--- a/app/en/home/mcp-clients/cursor/page.mdx
+++ b/app/en/home/mcp-clients/cursor/page.mdx
@@ -1,48 +1,88 @@
 import { Steps, Callout } from "nextra/components";
 import { SignupLink } from "@/app/_components/analytics";
 
+# Use Arcade tools in Cursor
 
-# Use Arcade in Cursor
+Connect Cursor to Arcade and give your AI coding assistant access to powerful tools like GitHub, Linear, Slack, Google Drive, and more.
 
-In this guide, you'll learn how to connect Cursor to an Arcade MCP Gateway.
+With this integration, you can ask Cursor's agent to:
+- Create GitHub issues and pull requests
+- Search and update Linear tickets
+- Send Slack messages
+- Read and write Google Docs
+- And much more
 
 <Steps>
 
-### Prerequisites
+### Get your Arcade credentials
 
-1. Create an <SignupLink linkLocation="docs:claude-desktop-client">Arcade account</SignupLink>
+1. <SignupLink linkLocation="docs:cursor-mcp-client">Create an Arcade account</SignupLink> if you don't have one
 2. Get an [Arcade API key](/home/api-keys)
-3. Create an [Arcade MCP Gateway](/home/mcp-gateways) and select the tools you want to use
+3. Create an [Arcade MCP Gateway](/home/mcp-gateways) and select the tools you want to use in Cursor
 
-### Set up Cursor
+<Callout type="info">
+Save your MCP Gateway URL—you'll need it in the next step. It looks like: `https://api.arcade.dev/mcp/your-gateway-slug`
+</Callout>
 
-3. Download and open [Cursor](https://cursor.com/download)
-4. Open the command palette and select **Open MCP Settings...**
-5. Choose **HTTP**
-6. Paste the URL of your MCP Gateway
-7. Give your MCP server a name, like `mcp-arcade`
-8. Add the API key as the bearer token within the `Authorization` header, and the email address that you used to sign up for the Arcade account as the `Arcade-User-ID` header
+### Configure Cursor
 
-Cursor will update your `settings.json` file with the following
+1. Open [Cursor](https://cursor.com/download) (version 0.50 or higher)
+2. Open the command palette (`Cmd+Shift+P` on Mac, `Ctrl+Shift+P` on Windows/Linux)
+3. Type **MCP** and select **Open MCP Settings...**
+4. Select **HTTP** as the server type
+5. Paste your MCP Gateway URL
+6. Name your server (e.g., `arcade`)
+7. Add your authentication headers:
+   - `Authorization`: `Bearer YOUR_API_KEY`
+   - `Arcade-User-ID`: Your Arcade account email
+
+Cursor updates your `settings.json` file. The configuration looks like this:
 
 ```json
 {
   "mcpServers": {
-    "mcp-arcade": {
-      "url": "https://api.arcade.dev/mcp/<YOUR-GATEWAY-SLUG>",
+    "arcade": {
+      "url": "https://api.arcade.dev/mcp/your-gateway-slug",
       "headers": {
-        "Authorization": "Bearer {arcade_api_key}",
-        "Arcade-User-ID": "{arcade_user_id}"
+        "Authorization": "Bearer your_api_key",
+        "Arcade-User-ID": "you@example.com"
       }
     }
   }
 }
 ```
 
-### Try it out
+### Start using tools
+
+1. Open the chat pane (`Cmd+L` on Mac, `Ctrl+L` on Windows/Linux)
+2. Switch to **Agent** mode using the dropdown at the bottom of the chat
+3. Ask the agent to use a tool!
 
-1. Open the chat pane (typically command-l)
-1. Make sure you are in **Agent** mode
-1. Ask the agent to use a tool!
+Try these example prompts:
+- "List my open GitHub issues"
+- "Create a Linear ticket for this bug"
+- "Send a Slack message to #general"
 
 </Steps>
+
+## Authorize tools
+
+Some tools require you to authorize access to your accounts (like GitHub or Google). When you use a tool for the first time, Arcade prompts you to authorize. Click the link and follow the OAuth flow—you only need to do this once per service.
+
+## Troubleshooting
+
+<Callout type="warning">
+**Tools not appearing?** Make sure you're in **Agent** mode, not Ask or Edit mode. Only Agent mode can use MCP tools.
+</Callout>
+
+**Common issues:**
+
+- **"Server not connected"**: Check that your MCP Gateway URL is correct and your API key is valid
+- **"Unauthorized" errors**: Verify your `Authorization` header includes `Bearer ` before your API key
+- **Tools not working**: Ensure the tool is enabled in your [MCP Gateway configuration](/home/mcp-gateways)
+
+## Next steps
+
+- Browse available [MCP Servers](/mcp-servers) to add more tools
+- Learn about [MCP Gateways](/home/mcp-gateways) to customize your tool selection
+- Build your own [custom MCP Server](/home/build-tools/create-a-mcp-server)