Edits

Author: idalithb

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

@@ -6,13 +6,13 @@ Build with speed and scale faster with The Graph's AI.
 
 ## Using AI on The Graph
 
-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/).
+Instead of relying on static datasets or centralized APIs, you can now access live blockchain data through an **agentic** apps 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?
 
 Using onchain data with AI unlocks powerful new ways to interact with and understand blockchain ecosystems.
 
-- **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 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 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
@@ -22,8 +22,8 @@ Using onchain data with AI unlocks powerful new ways to interact with and unders
 ### 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, 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.
+- **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.
 
 ### Conversational Querying with Graph Assistant
 
@@ -41,7 +41,7 @@ Using onchain data with AI unlocks powerful new ways to interact with and unders
 
 ### 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.
+[Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) servers connect to Claude, Cline, and Cursor. 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
 

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

@@ -7,20 +7,20 @@ This page summarizes some of the most common questions for developers using Grap
 
 1. What is The Graph Assistant?
 
-The Graph Assistant is an AI-powered chat interface that lets you query blockchain data in plain English. Under the hood, it translates your questions into GraphQL calls against subgraphs and the Token API, then returns results as a table—no coding required.
+The Graph Assistant is an AI-powered chat interface that lets you query blockchain data in plain English. Under the hood, it translates your questions into GraphQL calls against subgraphs and the Token API, then returns results, no coding required.
 
 2. What is an agentic application?
 
 An agentic application combines AI-driven reasoning with external data sources or APIs to take autonomous actions on your behalf. In this case, Graph Assistant acts as an “agent” that interprets your natural-language prompts, builds and dispatches GraphQL queries, and formats the results so that you don't need to write or manage queries yourself.
 
 3. Which networks and data does Graph Assistant support?
 
-The assistant has access to Subgraphs across 100+ chains. If a Subgraph is published to The Graph Network and is being indexed, the assistant can automatically route queries to it. The assistant also has access to the Token API on Ethereum Mainnet, BSC, Unichain, Arbitrum-One, Optimism, and Polygon.
+The Assistant has access to Subgraphs across 100+ chains. If a Subgraph is published to The Graph Network and is being indexed, the Assistant can automatically route queries to it. The Assistant also has access to the Token API on Ethereum Mainnet, BSC, Unichain, Arbitrum-One, Optimism, and Polygon.
 
 4. Is there a usage limit or quota?
 
 10 questions per hour.
 
-5. What if the assistant can't interpret my question?
+5. What if the Assistant can't interpret my question?
 
-When the assistant fails to parse your intent (for example, ambiguous token name, missing context, or an unsupported request), it will prompt you for clarification. For instance, it might ask, “Did you mean XYZ on Ethereum or XYZ on Arbitrum?” or “Please specify a date range for this query.” If you continue to see parsing errors, check that you're using correct token symbols or specifying networks and time frames clearly.
+When the Assistant fails to parse your intent (for example, ambiguous token name, missing context, or an unsupported request), it will prompt you for clarification. For instance, it might ask, “Did you mean XYZ on Ethereum or XYZ on Arbitrum?” or “Please specify a date range for this query.” If you continue to see parsing errors, check that you're using correct token symbols or specifying networks and time frames clearly.

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

@@ -15,12 +15,12 @@ You type a natural language question into the chat interface, such as:
 
 ### Behind the Scenes
 
-The assistant:
+The Assistant:
 
 1. Interprets your intent
 2. Maps it to the correct Subgraphs or Token API endpoint
 3. Executes optimized queries
-4. Returns results as a clean, readable table.
+4. Returns clean, structured results
 
 You don't need to write queries or understand a Subgraph's schema, you simply ask.
 

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

@@ -15,8 +15,8 @@ title: Introduction
 
 | Feature | Description |
 | --- | --- |
-| **Friendly Interface** | Conversational access to blockchain data via natural language. You simply ask questions, the assistant fetches the answer, and renders it as a table |
+| **Friendly Interface** | Conversational access to blockchain data via natural language. You simply ask questions, the Assistant fetches the answer, and renders it as a table |
 | **Backed by Subgraphs** | Uses subgraphs to index protocol-specific data like transactions, events, and protocol metrics |
 | **Backed by Token API** | Uses Token API for token-level information like balances, transfers, and metadata. |
 | **No Setup Required** | No need to configure data sources or write queries. |
-| **Automatic Query Building** | The assistant performs complex queries such as fetching historical token volumes, protocol analytics, or cross-chain data and handles filtering, pagination, and joins across Subgraphs automatically. |
+| **Automatic Query Building** | The Assistant performs complex queries such as fetching historical token volumes, protocol analytics, or cross-chain data and handles filtering, pagination, and joins across Subgraphs automatically. |

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

@@ -18,8 +18,8 @@ Go to: [Graph AI](https://graph-assistant.vercel.app/)
 
 After logging in:
 
-- You'll see the assistant interface.
-- At the bottom of the page, you will find a chat input bar. This is where you will interact with the assistant.
+- You'll see the Assistant interface.
+- At the bottom of the page, you will find a chat input bar. This is where you will interact with the Assistant.
 
 ### Step 3: Ask Your First Question
 
@@ -33,7 +33,7 @@ Example:
 Show me the 24-hour trading volume of XYZ token on Ethereum
 ```
 
-The assistant will:
+The Assistant will:
 
 - Digest your question
 - Fetch onchain data using Subgraphs or the Token API

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

@@ -3,7 +3,11 @@ title: Subgraph MCP Introduction
 sidebarTitle: 'Introduction'
 ---
 
-The Subgraph [Model Context Protocol](https://modelcontextprotocol.io/introduction) MCP server connects large language models like Claude, Cline, and Cursor directly to Subgraphs on The Graph Network. This integration enables you to explore Subgraph data, run queries, and find relevant deployments using natural language prompts.
+Subgraph MCP server is an open-source implementation of [Anthropic's Model Context Protocol](https://modelcontextprotocol.io/introduction).
+
+It presents The Graph's Subgraph data through a set of MCP tools that any MCP-compatible client can call. With these tools, clients can search for relevant Subgraphs, inspect GraphQL schemas, and run queries against specific deployments on The Graph Network all within a single, standardized interface. The server itself does not hold a language model. Instead, it translates incoming MCP requests into Subgraph queries and returns the structured results, allowing the client's LLM to transform a natural-language prompt into actionable blockchain data.
+
+Think of it as a USB-C hub: it standardizes the plug-and-play connection between AI agents and The Graph's Subgraph ecosystem.
 
 ## What You Can Do
 

website/src/pages/en/ai-suite/token-api-mcp/introduction.mdx

@@ -3,7 +3,11 @@ title: Token API MCP Introduction
 sidebarTitle: 'Introduction'
 ---
 
-The Token [Model Context Protocol](https://modelcontextprotocol.io/introduction) MCP server connects Claude, Cline, and Cursor to onchain token data using natural language. This integration allows each model to fetch token metadata, track balances, analyze transfers, and surface holder insights without manual queries.
+Token API MCP server is an open-source implementation of [Anthropic's Model Context Protocol](https://modelcontextprotocol.io/introduction).
+
+It makes on-chain token data, including metadata, balances, transfers, and holder statistics, accessible through a set of MCP tools. Any compatible client can use these tools to fetch and analyze token information through a standardized interface. The server itself does not host any language model. It simply converts MCP calls into data look-ups and returns structured results, letting the client's own LLM incorporate the results.
+
+Think of it as a USB-C hub: it standardizes the plug-and-play connection between AI agents and The Graph's Token API data.
 
 ## What You Can Do