More Updates

Author: idalithb

website/src/pages/en/ai-suite/ai-introduction.mdx

@@ -4,43 +4,57 @@ title: The Graph's AI
 
 Build with speed and scale faster with The Graph's AI.
 
-## Using AI on The Graph?
+## Using AI on The Graph
 
-[Graph Assistant](/ai-suite/graph-assistant/introduction/) is a powerful **agentic** application that empowers users to easily interact with blockchain data. Ask questions in simple, natural language and get rich, AI powered insights. Both technical developers and non-technical product teams can move faster, make smarter decisions, and gain a clearer understanding than ever before.
-
-Instead of relying on static datasets or centralized APIs, you can now access live, verifiable blockchain data using [Graph Assistant](/ai-suite/graph-assistant/introduction/), Subgraph MCP, and Token API MCP.
+Instead of relying on static datasets or centralized APIs, you can now access live blockchain data through an **agentic** context using [Graph Assistant](/ai-suite/graph-assistant/introduction/), [Subgraph MCP](/ai-suite/subgraph-mcp/introduction/), and [Token API MCP](/ai-suite/token-api-mcp/introduction/).
 
-## Why Use Onchain Data with AI?
+### Why Use Onchain Data with AI?
 
 Using onchain data with AI unlocks powerful new ways to interact with and understand blockchain ecosystems.
 
-- **AI as an interface**: Developers can use AI to interact directly with The Graph's data through their agents or build AI-powered applications on top of it. This streamlines development and opens up more intuitive, dynamic use cases.
-- **AI as a product**: For non-technical users, AI can turn complex onchain data into accessible insights. Assistants powered by AI enable anyone to explore, analyze, or act on blockchain data, without requiring any coding.
+- **AI for Non-Technical End Users**: AI can turn complex onchain data into accessible insights. Assistants powered by AI enable you to explore and analyze blockchain data, without requiring any coding.
+- **AI for Developers**: You can use AI to interact directly with The Graph's data through your agents or build AI-powered applications on top of it. This streamlines development and opens up more intuitive, dynamic use cases.
+
+## AI for Non-Technical/End Users
+
+[Graph Assistant](/ai-suite/graph-assistant/introduction/) is a powerful **agentic** application that empowers users to easily interact with blockchain data. Ask questions in simple, natural language and get rich, AI powered insights. Both technical developers and non-technical product teams can move faster, make smarter decisions, and gain a clearer understanding than ever before.
 
 ### Benefits of Using Graph Assistant
 
-- **Natural language Input**: You don't need to write complex queries or sift through dashboards. Simply ask your question in plain English and get clear, accurate results.
+- **Natural language Input**: You don't need to write complex queries or sift through dashboards. Simply ask your question in plain English and get clear, structured results.
 - **Multi-source support**: Works across multiple Subgraphs and The Graph's APIs. The assistant automatically determines which data source to use, so you don't have to switch tools or manage endpoints.
 - **Schema-free access**: You don't need to understand the schema. You can refer to tokens, protocols, dates, or addresses using natural language. The assistant takes care of the rest.
 
-There's no need to maintain backend infrastructure or manually pull and clean blockchain data.
-
-## Conversational Querying with Graph Assistant
+### Conversational Querying with Graph Assistant
 
 **Example queries:**
 
-- "Give me the daily volume on Uniswap."
 - "List the top-5 swaps by USD value in the last 24 hours."
+- "Give me the daily volume on Uniswap."
 - "List the 20 most recently registered .eth names."
 - "Whats the best liqudity pool to put my ETH into?"
 - "Total delegated stake in The Graph network?"
 
-Graph Assistant will eventually be a one-stop shop for interacting with The Graph. Right now, it's an agentic AI app that uses state-of-the-art AI techniques, LLMs, and MCPs to understand and answer your questions about Subgraph and Token API data.
+[Graph Assistant](/ai-suite/graph-assistant/introduction/) will eventually be a one-stop shop for interacting with The Graph. Right now, it's an agentic AI app that uses state-of-the-art AI techniques, LLMs, and MCPs to understand and answer your questions about [Subgraphs](/subgraphs/developing/subgraphs/) and [Token API](/token-api/quick-start/) data.
+
+## AI for Developers
+
+### Enable Natural Language Access to Onchain Data
+
+[Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) servers connect language models like Claude, Cline, and Cursor to blockchain data sources. They enable models to understand, query, and interact with structured onchain data using natural language. MCPs remove the need to write low-level queries or interact with APIs directly.
+
+### Subgraph MCP
+
+The [Subgraph MCP](/ai-suite/subgraph-mcp/introduction/) server connects models to Subgraphs on The Graph Network. It allows language models to explore Subgraph schemas, execute GraphQL queries, find relevant Subgraphs by keyword or contract, and surface usage metrics using natural language.
+
+### Token API MCP
 
-## Why This Matters?
+The [Token API MCP](/ai-suite/token-api-mcp/introduction/) MCP server enables models to access onchain token data. It supports querying token metadata, wallet balances, transfer history, and top token holders through simple prompts.
 
-Graph Assistant is a powerful agentic application that lets you interact with blockchain data using natural language through a simple chat interface. Unlike a basic chatbot, Graph Assistant can understand your intent, build complex queries, and execute them automatically. This gives you rich, AI-powered insights from onchain data without writing any code.
+#### Benefits of Using Subgraph and Token API MCPs
 
-- No custom backend
-- No manual querying
-- No deep GraphQL knowledge required
+- Query Subgraphs and token data using natural language
+- Access GraphQL schemas and token metadata without manual queries
+- Find Subgraphs by keyword or contract and check 30-day usage
+- Retrieve real-time data from The Graph and onchain token sources
+- Get wallet balances, transfer history, and top token holders

website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx

@@ -3,12 +3,12 @@ title: How To Use The Graph Assistant
 sidebarTitle: 'How-to Guide'
 ---
 
-## How to Use Graph Assistant
+## Overview
 
 You type a natural language question into the chat interface, such as:
 
 ```yaml
-"What's the total number of DAI transfers on Optimism last week?"
+'On Uniswap, return the top-10 pools by total value locked in USD.'
 ```
 
 > [!IMPORTANT] All users can process 10 free queries per user per hour

website/src/pages/en/ai-suite/graph-assistant/introduction.mdx

@@ -2,11 +2,11 @@
 title: Introduction
 ---
 
-Graph Assistant [BETA] gives instant, code-free access to blockchain data, transforming natural language into precise, AI-powered queries without the need to code.
+[Graph Assistant](https://graph-assistant.vercel.app/) gives instant, code-free access to blockchain data, transforming natural language into precise, AI-powered queries without the need to code.
 
 ## Overview
 
-[Graph Assistant](https://graph-assistant.vercel.app/) is an advanced, [agentic](/en/ai-suite/graph-assistant/faq/) easy-to-use interface for querying blockchain data using natural language.
+[Graph Assistant](https://graph-assistant.vercel.app/) is an advanced, [agentic](/en/ai-suite/graph-assistant/faq/) easy-to-use chat interface for querying blockchain data using natural language. Unlike a basic chatbot, Graph Assistant can understand your intent, build complex queries, and execute them automatically. This gives you rich, AI-powered insights from onchain data without writing any code.
 
 - **Automatically** interprets user intent, generates precise queries, executes them via The Graph's Subgraphs and Token API, and presents structured, AI-powered answers without requiring any code.
 - **Removes** the technical complexity found in traditional dashboards or chatbots. It provides composable insights directly from indexed Subgraphs and Token datasets.