diff --git a/docs/mcp/build-a-trading-agent.mdx b/docs/mcp/build-a-trading-agent.mdx
index 6782ce1a..2e0bd471 100644
--- a/docs/mcp/build-a-trading-agent.mdx
+++ b/docs/mcp/build-a-trading-agent.mdx
@@ -26,7 +26,7 @@ Pick your runtime:
 | Cursor | `.cursor/mcp.json` with `mcp-remote` → `https://mcp.bitquery.io/mcp` |
 | Claude Code | `claude mcp add bitquery -- npx -y mcp-remote https://mcp.bitquery.io/mcp` |
 
-Sign in with a [Bitquery account](https://account.bitquery.io/) on first tool call. For headless servers, append `?token=YOUR_TOKEN` (see [MCP overview](/docs/mcp/mcp-server/#authentication-via-query-token-less-secure)).
+Sign in with a [Bitquery account](https://account.bitquery.io/) on first tool call. The client opens a browser once for OAuth 2.1, then caches and refreshes the token for you (see [MCP overview](/docs/mcp/mcp-server/#first-connection-and-permissions)).
 
 ## Step 2 — Discovery loop
 
diff --git a/docs/mcp/cursor.mdx b/docs/mcp/cursor.mdx
index 3d1cf0db..63836f1b 100644
--- a/docs/mcp/cursor.mdx
+++ b/docs/mcp/cursor.mdx
@@ -45,6 +45,6 @@ More detail: [MCP server overview](/docs/mcp/mcp-server/).
   items={[
     { q: "How do I add Bitquery MCP to Cursor?", a: "Add https://mcp.bitquery.io in Cursor MCP settings, or use mcp-remote in .cursor/mcp.json as shown on this page." },
     { q: "Which chains can I query through MCP?", a: "Solana, Ethereum, BSC, Base, Arbitrum, Optimism, Polygon, and Tron — ask in plain English, no GraphQL required." },
-    { q: "Can I use an API token instead of OAuth?", a: "Yes for headless setups — append ?token=YOUR_TOKEN to the MCP URL. OAuth is safer for daily interactive use." },
+    { q: "Can I use an API token instead of OAuth?", a: "No. The Bitquery MCP server authenticates with OAuth 2.1 — Cursor opens a browser once on the first tool call, then caches and refreshes the token for you." },
   ]}
 />