AI Revamp

website/next.config.js

@@ -71,6 +71,13 @@ const withNextra = nextra({
         type: 'children',
         title: t('global.navigation.tokenApi'),
       },
+      '---4': {
+        type: 'separator',
+      },
+      'ai-suite': {
+        type: 'children',
+        title: t('global.navigation.ai-suite'),
+      },
       '---5': {
         type: 'separator',
       },

website/src/layout/Layout.tsx

@@ -33,6 +33,7 @@ import {
   SocialGitHub,
   SocialTelegram,
   SocialX,
+  Sparkle,
   Stack,
   Subgraph,
   Substreams,
@@ -135,6 +136,9 @@ export default function Layout({ pageOpts, children }: NextraThemeLayoutProps<Fr
     if (routeWithoutLocale === '/token-api' || routeWithoutLocale.startsWith('/token-api/')) {
       return <APIToken alt="" />
     }
+    if (routeWithoutLocale === '/ai-suite' || routeWithoutLocale.startsWith('/ai-suite/')) {
+      return <Sparkle alt="" variant={selected ? 'fill' : 'regular'} />
+    }
     if (routeWithoutLocale === '/indexing' || routeWithoutLocale.startsWith('/indexing/')) {
       return <RoleIndexer alt="" />
     }

website/src/pages/en/ai-suite/_meta-titles.json

@@ -0,0 +1,5 @@
+{
+  "graph-assistant": "Graph Assistant",
+  "quick-starts": "Quick Starts",
+  "ai-introduction": "The Graph's AI"
+}

website/src/pages/en/ai-suite/_meta.js

@@ -0,0 +1,7 @@
+import titles from './_meta-titles.json'
+
+export default {
+  'quick-starts': titles['quick-starts'],
+  'ai-introduction': titles['ai-introduction'],
+  'graph-assistant': titles['graph-assistant'],
+}

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

@@ -0,0 +1,53 @@
+---
+title: The Graph's AI
+---
+
+Build with speed and scale faster with The Graph's AI Suite.
+
+## What is AI on The Graph?
+
+AI on The Graph connects large language models (LLMs) like Claude to onchain data indexed by The Graph. This allows developers to build AI systems that query blockchain data directly using natural language. This eliminates the need to write code or manage infrastructure.
+
+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](), [Token API MCP]().
+
+Fetch fast access to accurate, real-time onchain data.
+
+## Why Use Onchain Data with AI?
+
+If you're building with AI in web3, onchain data is necessary. Wallets, tokens, governance, and transactions all live onchain, but are often very difficult to access at scale without an indexing or custom solution.
+
+The Graph solves this by making onchain data available through [Subgraphs]() and [TokenAPI]() via [Graph Assistant]().
+
+### Benefits
+
+- Easy access to data in real-time
+- Save time and scale faster
+- Fast access to indexed blockchain data
+- Verifable answers tied to onchain activity
+- Context-aware agents that interact with live data
+
+There's no need to maintain backend infrastructure or manually pull and clean blockchain data.
+
+## Conversational Querying with Graph Assistant
+
+Graph Assistant allows Claude to understand and query The Graph using plain language. You describe what you want, and the assistant translates it into the correct query against a Subgraph or Token API endpoint.
+
+**Example queries:**
+
+- "List top holders of this token by balance."
+- "Show GRT transfers to this address in the past 7 days."
+- "Get proposals this wallet voted on in May."
+
+[Graph Assistant](/ai-suite/graph-assistant/introduction/) uses the Model-Comprehensible Protocol (MCP) to understand data schemas, identify relevant fields, and return structured results.
+
+You don't need to write GraphQL or study Subgraph schemas manually.
+
+## Why This Matters for Developers
+
+If you need fast access to token data, user behavior, governance activity, or protocol metrics, this stack gives you a direct path. You save time, avoid technical overhead, and can ship faster.
+
+- No custom backend
+- No manual querying
+- No deep GraphQL knowledge required
+
+You get verifiable blockchain data, ready for use in AI applications, chat interfaces, analytics dashboards, and automation workflows.

website/src/pages/en/ai-suite/graph-assistant/_meta.js

@@ -0,0 +1,6 @@
+export default {
+  'quick-start': '',
+  introduction: '',
+  'how-to-guide': '',
+  'faq-graph-assistant': '',
+}

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

@@ -0,0 +1,10 @@
+---
+title: Graph Assistant FAQ
+sidebarTitle: 'FAQ'
+---
+
+This page summarizes some of the most common questions for developers using Graph Assistant.
+
+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.

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

@@ -0,0 +1,54 @@
+---
+title: How To Use The Graph Assistant
+sidebarTitle: 'How-to Guide'
+---
+
+## How to Use Graph Assistant
+
+> [!IMPORTANT] All users can process 10 free queries per user per hour
+
+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?"
+```
+
+### Behind the Scenes
+
+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.
+
+You don't need to write queries or understand a Subgraph's schema, you simply ask.
+
+### Example Use Cases
+
+**Protocol Analytics**
+
+- “Compare daily active users on Aave vs. Compound in May 2025.”
+- “Show me the total value locked (TVL) for XYZDAO over the last quarter.”
+
+**Token Insights**
+
+- “What are the top 10 tokens by market cap on Ethereum right now?”
+- “How many XYZ did I receive between May 1 and May 15?”
+
+**Historical Data Retrieval**
+
+- “Fetch the token price history of XYZ for the last six months.”
+- “What was the average gas price on Ethereum during April?”
+
+**Portfolio Monitoring**
+
+- “List my wallet’s current token balances and their USD equivalents.”
+- “Calculate profit/loss on XYZ since xyz date.”
+
+**Cross-Chain Comparison**
+
+- “Show me the 7-day trading volume of XYZ on Ethereum vs. Polygon.”
+- “How many XYZ swaps occurred on Arbitrum yesterday?”
+
+To get started follow the [quickstart](/ai-suite/graph-assistant/quick-start/) and explore it's capabilities.

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

@@ -0,0 +1,24 @@
+---
+title: Introduction
+---
+
+Graph Assistant gives instant, code-free access to blockchain data, transforming natural language into precise, AI-powered queries without the need to code.
+
+## Overview
+
+### What is Graph Assistant?
+
+It's an advanced, agentic easy to use interface for querying blockchain data using natural language. It 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.
+
+Unlike traditional dashboards or chatbots, Graph Assistant simplifies technical complexity and delivers composable insights directly from indexed subgraphs and token datasets.
+
+## Core Features
+
+| 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 |
+| **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. |
+| **Supports Complex Data Needs** | Handles multi-chain, historical, and analytical requests (e.g., volume over time, asset flows, usage metrics). |

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

@@ -0,0 +1,40 @@
+---
+title: Quick Start
+---
+
+This guide provides step-by-step instructions for getting started with Graph AI Assistant quickly.
+
+## Step-by Step
+
+### Step 1. Create an Account
+
+Go to: (Graph AI)[thegraph.com/ai]
+
+- Click Sign Up (or Log In if you already have an account).
+- Use your GitHub or email credentials.
+- No additional setup is required
+
+### Step 2. Open the Assistant Chat
+
+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.
+
+### Step 3: Ask Your First Question
+
+> [!IMPORTANT] All users can process 10 free queries per user per hour
+
+In the input bar, type a natural-language query (everyday language).
+
+Example:
+
+```yaml
+Show me the 24-hour trading volume of XYZ token on Ethereum
+```
+
+The assistant will:
+
+- Digest your question
+- Fetch onchain data using Subgraphs or the Token API
+- Return a clean, formatted response in markdown with the data you need

website/src/pages/en/ai-suite/quick-starts.mdx

@@ -0,0 +1,33 @@
+---
+title: Start Building with The Graph's AI Suite
+sidebarTitle: 'Quick Starts'
+---
+
+## Why Model Context Protocols?
+
+- Modular architecture for dapps and LLMs
+- Instant setup with smart contract and Subgraph templates
+- Native integration with The Graph protocol
+- Designed for data-rich, AI-aware, or token-driven applications
+
+## Start Building
+
+### Graph Assistant
+
+[Quickstart]()
+
+### Subgraph MCP
+
+Build indexers with built-in context and schema.
+
+Subgraph MCP gives you fast access to onchain data, optimized for AI consumption and GraphQL queries.
+
+[Quickstart]()
+
+### TokenAPI MCP
+
+Token APIs and data access with one click.
+
+TokenAPI MCP turns your backend or contract into a tokenized service layer. It's ideal for usage gating, monetization, or usage tracking.
+
+[Quickstart]()

website/src/pages/en/global.json

@@ -6,6 +6,7 @@
     "subgraphs": "Subgraphs",
     "substreams": "Substreams",
     "sps": "Substreams-Powered Subgraphs",
+    "ai-suite": "AI Suite",
     "tokenApi": "Token API",
     "indexing": "Indexing",
     "resources": "Resources",