From 679744f8d87d81be88d3bc0b6380c796564ed16f Mon Sep 17 00:00:00 2001 From: Idalith Bustos Date: Wed, 18 Jun 2025 18:43:20 -0700 Subject: [PATCH 01/10] working draft --- website/next.config.js | 7 +++ .../src/pages/en/ai-suite/_meta-titles.json | 3 ++ website/src/pages/en/ai-suite/_meta.js | 5 +++ .../en/ai-suite/the-graph-assistant/_meta.js | 4 ++ .../the-graph-assistant/introduction.mdx | 45 +++++++++++++++++++ .../the-graph-assistant/quick-start.mdx | 38 ++++++++++++++++ website/src/pages/en/global.json | 1 + 7 files changed, 103 insertions(+) create mode 100644 website/src/pages/en/ai-suite/_meta-titles.json create mode 100644 website/src/pages/en/ai-suite/_meta.js create mode 100644 website/src/pages/en/ai-suite/the-graph-assistant/_meta.js create mode 100644 website/src/pages/en/ai-suite/the-graph-assistant/introduction.mdx create mode 100644 website/src/pages/en/ai-suite/the-graph-assistant/quick-start.mdx diff --git a/website/next.config.js b/website/next.config.js index ab4ab3a89c53..0eb6f3ecdb72 100644 --- a/website/next.config.js +++ b/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', }, diff --git a/website/src/pages/en/ai-suite/_meta-titles.json b/website/src/pages/en/ai-suite/_meta-titles.json new file mode 100644 index 000000000000..6d23aa71e14c --- /dev/null +++ b/website/src/pages/en/ai-suite/_meta-titles.json @@ -0,0 +1,3 @@ +{ + "the-graph-assistant": "The Graph Assistant" +} diff --git a/website/src/pages/en/ai-suite/_meta.js b/website/src/pages/en/ai-suite/_meta.js new file mode 100644 index 000000000000..b3e8e2c6c885 --- /dev/null +++ b/website/src/pages/en/ai-suite/_meta.js @@ -0,0 +1,5 @@ +import titles from './_meta-titles.json' + +export default { + 'the-graph-assistant': 'The Graph Assistant', +} diff --git a/website/src/pages/en/ai-suite/the-graph-assistant/_meta.js b/website/src/pages/en/ai-suite/the-graph-assistant/_meta.js new file mode 100644 index 000000000000..8415df122dea --- /dev/null +++ b/website/src/pages/en/ai-suite/the-graph-assistant/_meta.js @@ -0,0 +1,4 @@ +export default { + 'quick-start': 'Quick Start', + introduction: 'Introduction', +} diff --git a/website/src/pages/en/ai-suite/the-graph-assistant/introduction.mdx b/website/src/pages/en/ai-suite/the-graph-assistant/introduction.mdx new file mode 100644 index 000000000000..3eb789766ce5 --- /dev/null +++ b/website/src/pages/en/ai-suite/the-graph-assistant/introduction.mdx @@ -0,0 +1,45 @@ +--- +title: Introduction +--- + +The 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 The 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 and Token API, and presents structured, AI-powered answers without requiring any code. + +Unlike traditional dashboards or chatbots, The Graph Assistant simplifies technical complexity and delivers composable insights directly from indexed subgraphs and token datasets. + +## How to Use The Graph Assistant + +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. + +To get started follow the [quickstart]() and explore it's capabilities. + +## 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). | diff --git a/website/src/pages/en/ai-suite/the-graph-assistant/quick-start.mdx b/website/src/pages/en/ai-suite/the-graph-assistant/quick-start.mdx new file mode 100644 index 000000000000..2749dcf9adee --- /dev/null +++ b/website/src/pages/en/ai-suite/the-graph-assistant/quick-start.mdx @@ -0,0 +1,38 @@ +--- +title: Quick Start +--- + +This guide provides step-by-step instructions for getting started with The Graph AI Assistant quickly. + +## Step-by Step + +### Step 1. Create an Account + +Go to: (The 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 + +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 diff --git a/website/src/pages/en/global.json b/website/src/pages/en/global.json index 4364984ad90c..f1d954fe756e 100644 --- a/website/src/pages/en/global.json +++ b/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", From 23c9db9eabd2b9c35a36a2c92b465dac365400d3 Mon Sep 17 00:00:00 2001 From: benface Date: Thu, 19 Jun 2025 15:31:09 -0400 Subject: [PATCH 02/10] =?UTF-8?q?Add=20icon=20to=20=E2=80=9CAI=20Suite?= =?UTF-8?q?=E2=80=9D=20section?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- website/src/layout/Layout.tsx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/website/src/layout/Layout.tsx b/website/src/layout/Layout.tsx index e1365d05dde9..2333afdbb1c0 100644 --- a/website/src/layout/Layout.tsx +++ b/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 } + if (routeWithoutLocale === '/ai-suite' || routeWithoutLocale.startsWith('/ai-suite/')) { + return + } if (routeWithoutLocale === '/indexing' || routeWithoutLocale.startsWith('/indexing/')) { return } From e2cf2a1f303f42e00655abc4c79cc0fd87fdd0b0 Mon Sep 17 00:00:00 2001 From: Idalith Bustos Date: Fri, 20 Jun 2025 17:56:32 -0700 Subject: [PATCH 03/10] updates --- .../src/pages/en/ai-suite/_meta-titles.json | 4 +- website/src/pages/en/ai-suite/_meta.js | 4 +- .../src/pages/en/ai-suite/ai-introduction.mdx | 53 ++++++++++++++++++ .../en/ai-suite/graph-assistant/_meta.js | 6 +++ .../graph-assistant/faq-graph-assistant.mdx | 10 ++++ .../ai-suite/graph-assistant/how-to-guide.mdx | 54 +++++++++++++++++++ .../introduction.mdx | 29 ++-------- .../quick-start.mdx | 6 ++- .../src/pages/en/ai-suite/quick-starts.mdx | 33 ++++++++++++ .../en/ai-suite/the-graph-assistant/_meta.js | 4 -- 10 files changed, 170 insertions(+), 33 deletions(-) create mode 100644 website/src/pages/en/ai-suite/ai-introduction.mdx create mode 100644 website/src/pages/en/ai-suite/graph-assistant/_meta.js create mode 100644 website/src/pages/en/ai-suite/graph-assistant/faq-graph-assistant.mdx create mode 100644 website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx rename website/src/pages/en/ai-suite/{the-graph-assistant => graph-assistant}/introduction.mdx (53%) rename website/src/pages/en/ai-suite/{the-graph-assistant => graph-assistant}/quick-start.mdx (85%) create mode 100644 website/src/pages/en/ai-suite/quick-starts.mdx delete mode 100644 website/src/pages/en/ai-suite/the-graph-assistant/_meta.js diff --git a/website/src/pages/en/ai-suite/_meta-titles.json b/website/src/pages/en/ai-suite/_meta-titles.json index 6d23aa71e14c..4483adabe07d 100644 --- a/website/src/pages/en/ai-suite/_meta-titles.json +++ b/website/src/pages/en/ai-suite/_meta-titles.json @@ -1,3 +1,5 @@ { - "the-graph-assistant": "The Graph Assistant" + "graph-assistant": "Graph Assistant", + "quick-starts": "Quick Starts", + "ai-introduction": "The Graph's AI" } diff --git a/website/src/pages/en/ai-suite/_meta.js b/website/src/pages/en/ai-suite/_meta.js index b3e8e2c6c885..1bd41902b02c 100644 --- a/website/src/pages/en/ai-suite/_meta.js +++ b/website/src/pages/en/ai-suite/_meta.js @@ -1,5 +1,7 @@ import titles from './_meta-titles.json' export default { - 'the-graph-assistant': 'The Graph Assistant', + 'quick-starts': titles['quick-starts'], + 'ai-introduction': titles['ai-introduction'], + 'graph-assistant': titles['graph-assistant'], } diff --git a/website/src/pages/en/ai-suite/ai-introduction.mdx b/website/src/pages/en/ai-suite/ai-introduction.mdx new file mode 100644 index 000000000000..6382cd998683 --- /dev/null +++ b/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. diff --git a/website/src/pages/en/ai-suite/graph-assistant/_meta.js b/website/src/pages/en/ai-suite/graph-assistant/_meta.js new file mode 100644 index 000000000000..58af4eff7d28 --- /dev/null +++ b/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': '', +} diff --git a/website/src/pages/en/ai-suite/graph-assistant/faq-graph-assistant.mdx b/website/src/pages/en/ai-suite/graph-assistant/faq-graph-assistant.mdx new file mode 100644 index 000000000000..bb181198cfb4 --- /dev/null +++ b/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. diff --git a/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx b/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx new file mode 100644 index 000000000000..4e8964a5aa48 --- /dev/null +++ b/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. diff --git a/website/src/pages/en/ai-suite/the-graph-assistant/introduction.mdx b/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx similarity index 53% rename from website/src/pages/en/ai-suite/the-graph-assistant/introduction.mdx rename to website/src/pages/en/ai-suite/graph-assistant/introduction.mdx index 3eb789766ce5..34cd93114b85 100644 --- a/website/src/pages/en/ai-suite/the-graph-assistant/introduction.mdx +++ b/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx @@ -2,36 +2,15 @@ title: Introduction --- -The Graph Assistant gives instant, code-free access to blockchain data, transforming natural language into precise, AI-powered queries without the need to code. +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 The Graph Assistant? +### 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 and Token API, and presents structured, AI-powered answers without requiring any code. +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, The Graph Assistant simplifies technical complexity and delivers composable insights directly from indexed subgraphs and token datasets. - -## How to Use The Graph Assistant - -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. - -To get started follow the [quickstart]() and explore it's capabilities. +Unlike traditional dashboards or chatbots, Graph Assistant simplifies technical complexity and delivers composable insights directly from indexed subgraphs and token datasets. ## Core Features diff --git a/website/src/pages/en/ai-suite/the-graph-assistant/quick-start.mdx b/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx similarity index 85% rename from website/src/pages/en/ai-suite/the-graph-assistant/quick-start.mdx rename to website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx index 2749dcf9adee..21809d7c3bc0 100644 --- a/website/src/pages/en/ai-suite/the-graph-assistant/quick-start.mdx +++ b/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx @@ -2,13 +2,13 @@ title: Quick Start --- -This guide provides step-by-step instructions for getting started with The Graph AI Assistant quickly. +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: (The Graph AI)[thegraph.com/ai] +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. @@ -23,6 +23,8 @@ After logging in: ### 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: diff --git a/website/src/pages/en/ai-suite/quick-starts.mdx b/website/src/pages/en/ai-suite/quick-starts.mdx new file mode 100644 index 000000000000..7f89bde58f34 --- /dev/null +++ b/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]() diff --git a/website/src/pages/en/ai-suite/the-graph-assistant/_meta.js b/website/src/pages/en/ai-suite/the-graph-assistant/_meta.js deleted file mode 100644 index 8415df122dea..000000000000 --- a/website/src/pages/en/ai-suite/the-graph-assistant/_meta.js +++ /dev/null @@ -1,4 +0,0 @@ -export default { - 'quick-start': 'Quick Start', - introduction: 'Introduction', -} From 9f8078792a1014cfbd2938bcfb1099c1980d83c2 Mon Sep 17 00:00:00 2001 From: Idalith Bustos Date: Tue, 24 Jun 2025 22:17:12 -0700 Subject: [PATCH 04/10] Edits --- .../src/pages/en/ai-suite/_meta-titles.json | 1 - website/src/pages/en/ai-suite/_meta.js | 1 - .../src/pages/en/ai-suite/ai-introduction.mdx | 45 ++++++++----------- .../en/ai-suite/graph-assistant/_meta.js | 2 +- .../graph-assistant/faq-graph-assistant.mdx | 10 ----- .../pages/en/ai-suite/graph-assistant/faq.mdx | 26 +++++++++++ .../ai-suite/graph-assistant/introduction.mdx | 8 ++-- .../ai-suite/graph-assistant/quick-start.mdx | 2 +- .../src/pages/en/ai-suite/quick-starts.mdx | 33 -------------- 9 files changed, 50 insertions(+), 78 deletions(-) delete mode 100644 website/src/pages/en/ai-suite/graph-assistant/faq-graph-assistant.mdx create mode 100644 website/src/pages/en/ai-suite/graph-assistant/faq.mdx delete mode 100644 website/src/pages/en/ai-suite/quick-starts.mdx diff --git a/website/src/pages/en/ai-suite/_meta-titles.json b/website/src/pages/en/ai-suite/_meta-titles.json index 4483adabe07d..e745c812eef1 100644 --- a/website/src/pages/en/ai-suite/_meta-titles.json +++ b/website/src/pages/en/ai-suite/_meta-titles.json @@ -1,5 +1,4 @@ { "graph-assistant": "Graph Assistant", - "quick-starts": "Quick Starts", "ai-introduction": "The Graph's AI" } diff --git a/website/src/pages/en/ai-suite/_meta.js b/website/src/pages/en/ai-suite/_meta.js index 1bd41902b02c..b28eabd087df 100644 --- a/website/src/pages/en/ai-suite/_meta.js +++ b/website/src/pages/en/ai-suite/_meta.js @@ -1,7 +1,6 @@ import titles from './_meta-titles.json' export default { - 'quick-starts': titles['quick-starts'], 'ai-introduction': titles['ai-introduction'], 'graph-assistant': titles['graph-assistant'], } diff --git a/website/src/pages/en/ai-suite/ai-introduction.mdx b/website/src/pages/en/ai-suite/ai-introduction.mdx index 6382cd998683..fd721695f3a7 100644 --- a/website/src/pages/en/ai-suite/ai-introduction.mdx +++ b/website/src/pages/en/ai-suite/ai-introduction.mdx @@ -2,52 +2,45 @@ title: The Graph's AI --- -Build with speed and scale faster with The Graph's AI Suite. +Build with speed and scale faster with The Graph's AI. -## What is AI on The Graph? +## Using 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. +[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](), [Token API MCP](). - -Fetch fast access to accurate, real-time onchain data. +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. ## 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. +Using onchain data with AI unlocks powerful new ways to interact with and understand blockchain ecosystems. -The Graph solves this by making onchain data available through [Subgraphs]() and [TokenAPI]() via [Graph Assistant](). +- **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. -### Benefits +### Benefits of Using Graph Assistant -- 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 +- **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. +- **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 -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." +- "Give me the daily volume on Uniswap." +- "List the top-5 swaps by USD value in the last 24 hours." +- "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](/ai-suite/graph-assistant/introduction/) uses the Model-Comprehensible Protocol (MCP) to understand data schemas, identify relevant fields, and return structured results. +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. -You don't need to write GraphQL or study Subgraph schemas manually. +## Why This Matters? -## 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. +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. - 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. diff --git a/website/src/pages/en/ai-suite/graph-assistant/_meta.js b/website/src/pages/en/ai-suite/graph-assistant/_meta.js index 58af4eff7d28..74da5e0686a7 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/_meta.js +++ b/website/src/pages/en/ai-suite/graph-assistant/_meta.js @@ -2,5 +2,5 @@ export default { 'quick-start': '', introduction: '', 'how-to-guide': '', - 'faq-graph-assistant': '', + faq: '', } diff --git a/website/src/pages/en/ai-suite/graph-assistant/faq-graph-assistant.mdx b/website/src/pages/en/ai-suite/graph-assistant/faq-graph-assistant.mdx deleted file mode 100644 index bb181198cfb4..000000000000 --- a/website/src/pages/en/ai-suite/graph-assistant/faq-graph-assistant.mdx +++ /dev/null @@ -1,10 +0,0 @@ ---- -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. diff --git a/website/src/pages/en/ai-suite/graph-assistant/faq.mdx b/website/src/pages/en/ai-suite/graph-assistant/faq.mdx new file mode 100644 index 000000000000..e461faf15dff --- /dev/null +++ b/website/src/pages/en/ai-suite/graph-assistant/faq.mdx @@ -0,0 +1,26 @@ +--- +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. + +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. + +4. Is there a usage limit or quota? + +10 questions per hour. + +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. diff --git a/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx b/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx index 34cd93114b85..e9d9d44b1139 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx +++ b/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx @@ -6,11 +6,10 @@ Graph Assistant gives instant, code-free access to blockchain data, transforming ## Overview -### What is Graph Assistant? +Graph Assistant is an advanced, [agentic](/en/ai-suite/graph-assistant/faq/) easy-to-use interface for querying blockchain data using natural language. -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. +- **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. ## Core Features @@ -21,4 +20,3 @@ Unlike traditional dashboards or chatbots, Graph Assistant simplifies technical | **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). | diff --git a/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx b/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx index 21809d7c3bc0..0428080be329 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx +++ b/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx @@ -37,4 +37,4 @@ 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 +- Return a clean, formatted response with the data you need diff --git a/website/src/pages/en/ai-suite/quick-starts.mdx b/website/src/pages/en/ai-suite/quick-starts.mdx deleted file mode 100644 index 7f89bde58f34..000000000000 --- a/website/src/pages/en/ai-suite/quick-starts.mdx +++ /dev/null @@ -1,33 +0,0 @@ ---- -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]() From c7271bddbf5d9df208cc3dd1bd5e8d4d79e18382 Mon Sep 17 00:00:00 2001 From: Idalith Bustos Date: Wed, 25 Jun 2025 16:09:30 -0700 Subject: [PATCH 05/10] Updating --- nginx.conf | 7 + .../src/pages/en/ai-suite/_meta-titles.json | 4 +- website/src/pages/en/ai-suite/_meta.js | 2 + .../ai-suite/graph-assistant/how-to-guide.mdx | 4 +- .../ai-suite/graph-assistant/introduction.mdx | 4 +- .../ai-suite/graph-assistant/quick-start.mdx | 4 +- .../mcp => ai-suite/subgraph-mcp}/_meta.js | 1 + .../mcp => ai-suite/subgraph-mcp}/claude.mdx | 12 +- .../mcp => ai-suite/subgraph-mcp}/cline.mdx | 2 +- .../mcp => ai-suite/subgraph-mcp}/cursor.mdx | 2 +- .../en/ai-suite/subgraph-mcp/introduction.mdx | 16 +++ .../mcp => ai-suite/token-api-mcp}/_meta.js | 1 + .../mcp => ai-suite/token-api-mcp}/claude.mdx | 0 .../mcp => ai-suite/token-api-mcp}/cline.mdx | 0 .../mcp => ai-suite/token-api-mcp}/cursor.mdx | 0 .../ai-suite/token-api-mcp/introduction.mdx | 17 +++ website/src/pages/en/resources/_meta.js | 1 - website/src/pages/en/resources/claude-mcp.mdx | 122 ------------------ .../src/pages/en/subgraphs/_meta-titles.json | 3 +- website/src/pages/en/subgraphs/_meta.js | 1 - .../src/pages/en/token-api/_meta-titles.json | 1 - website/src/pages/en/token-api/_meta.js | 1 - 22 files changed, 57 insertions(+), 148 deletions(-) rename website/src/pages/en/{subgraphs/mcp => ai-suite/subgraph-mcp}/_meta.js (75%) rename website/src/pages/en/{subgraphs/mcp => ai-suite/subgraph-mcp}/claude.mdx (87%) rename website/src/pages/en/{subgraphs/mcp => ai-suite/subgraph-mcp}/cline.mdx (89%) rename website/src/pages/en/{subgraphs/mcp => ai-suite/subgraph-mcp}/cursor.mdx (88%) create mode 100644 website/src/pages/en/ai-suite/subgraph-mcp/introduction.mdx rename website/src/pages/en/{token-api/mcp => ai-suite/token-api-mcp}/_meta.js (75%) rename website/src/pages/en/{token-api/mcp => ai-suite/token-api-mcp}/claude.mdx (100%) rename website/src/pages/en/{token-api/mcp => ai-suite/token-api-mcp}/cline.mdx (100%) rename website/src/pages/en/{token-api/mcp => ai-suite/token-api-mcp}/cursor.mdx (100%) create mode 100644 website/src/pages/en/ai-suite/token-api-mcp/introduction.mdx delete mode 100644 website/src/pages/en/resources/claude-mcp.mdx diff --git a/nginx.conf b/nginx.conf index ae4fd7fa98e7..32b0fdd48183 100644 --- a/nginx.conf +++ b/nginx.conf @@ -161,6 +161,13 @@ http { rewrite ^/docs/([a-zA-Z][a-zA-Z])/tokenomics/$ $scheme://$http_host/docs/$1/resources/tokenomics/ permanent; rewrite ^/docs/([a-zA-Z][a-zA-Z])/token-api/$ $scheme://$http_host/docs/$1/token-api/quick-start/ permanent; rewrite ^/docs/([a-zA-Z][a-zA-Z])/token-api/evm/get-transfers-evm-by-address/$ $scheme://$http_host/docs/$1/token-api/evm/get-transfers-evm/ permanent; + rewrite ^/docs/([a-zA-Z][a-zA-Z])/subgraphs/mcp/claude/$ $scheme://$http_host/docs/$1/ai-suite/subgraph-mcp/ permanent; + rewrite ^/docs/([a-zA-Z][a-zA-Z])/subgraphs/mcp/cline/$ $scheme://$http_host/docs/$1/ai-suite/subgraph-mcp/ permanent; + rewrite ^/docs/([a-zA-Z][a-zA-Z])/subgraphs/mcp/cursor/$ $scheme://$http_host/docs/$1/ai-suite/subgraph-mcp/ permanent; + rewrite ^/docs/([a-zA-Z][a-zA-Z])/subgraphs/mcp/cline/$ $scheme://$http_host/docs/$1/ai-suite/subgraph-mcp/ permanent; + rewrite ^/docs/([a-zA-Z][a-zA-Z])/token-api/mcp/cline/$ $scheme://$http_host/docs/$1/ai-suite/token-api-mcp/ permanent; + rewrite ^/docs/([a-zA-Z][a-zA-Z])/token-api/mcp/cline/$ $scheme://$http_host/docs/$1/ai-suite/token-api-mcp/ permanent; + rewrite ^/docs/([a-zA-Z][a-zA-Z])/token-api/mcp/cline/$ $scheme://$http_host/docs/$1/ai-suite/token-api-mcp/ permanent; # Temporary redirects (302) rewrite ^/docs/en/querying/graph-client/$ $scheme://$http_host/docs/en/subgraphs/querying/graph-client/README/ redirect; rewrite ^/docs/en/developing/graph-ts/$ $scheme://$http_host/docs/en/subgraphs/developing/creating/graph-ts/README/ redirect; diff --git a/website/src/pages/en/ai-suite/_meta-titles.json b/website/src/pages/en/ai-suite/_meta-titles.json index e745c812eef1..5eb482a7092b 100644 --- a/website/src/pages/en/ai-suite/_meta-titles.json +++ b/website/src/pages/en/ai-suite/_meta-titles.json @@ -1,4 +1,6 @@ { "graph-assistant": "Graph Assistant", - "ai-introduction": "The Graph's AI" + "ai-introduction": "The Graph's AI", + "subgraph-mcp": "Subgraph MCP", + "token-api-mcp": "Token API MCP" } diff --git a/website/src/pages/en/ai-suite/_meta.js b/website/src/pages/en/ai-suite/_meta.js index b28eabd087df..c9e51dfd35fb 100644 --- a/website/src/pages/en/ai-suite/_meta.js +++ b/website/src/pages/en/ai-suite/_meta.js @@ -3,4 +3,6 @@ import titles from './_meta-titles.json' export default { 'ai-introduction': titles['ai-introduction'], 'graph-assistant': titles['graph-assistant'], + 'subgraph-mcp': titles['subgraph-mcp'], + 'token-api-mcp': titles['token-api-mcp'], } diff --git a/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx b/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx index 4e8964a5aa48..0c35cb8acd6e 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx +++ b/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx @@ -5,14 +5,14 @@ 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?" ``` +> [!IMPORTANT] All users can process 10 free queries per user per hour + ### Behind the Scenes The assistant: diff --git a/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx b/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx index e9d9d44b1139..b35d61e2559b 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx +++ b/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx @@ -2,11 +2,11 @@ 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. +Graph Assistant [BETA] gives instant, code-free access to blockchain data, transforming natural language into precise, AI-powered queries without the need to code. ## Overview -Graph Assistant 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 interface for querying blockchain data using natural language. - **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. diff --git a/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx b/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx index 0428080be329..1c083bc27af1 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx +++ b/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx @@ -2,13 +2,13 @@ title: Quick Start --- -This guide provides step-by-step instructions for getting started with Graph AI Assistant quickly. +This guide provides step-by-step instructions for getting started with Graph Assistant quickly. ## Step-by Step ### Step 1. Create an Account -Go to: (Graph AI)[thegraph.com/ai] +Go to: [Graph AI](https://graph-assistant.vercel.app/) - Click Sign Up (or Log In if you already have an account). - Use your GitHub or email credentials. diff --git a/website/src/pages/en/subgraphs/mcp/_meta.js b/website/src/pages/en/ai-suite/subgraph-mcp/_meta.js similarity index 75% rename from website/src/pages/en/subgraphs/mcp/_meta.js rename to website/src/pages/en/ai-suite/subgraph-mcp/_meta.js index 8630d4da27b3..6f527b4e53e4 100644 --- a/website/src/pages/en/subgraphs/mcp/_meta.js +++ b/website/src/pages/en/ai-suite/subgraph-mcp/_meta.js @@ -1,4 +1,5 @@ export default { + introduction: '', claude: '', cline: '', cursor: '', diff --git a/website/src/pages/en/subgraphs/mcp/claude.mdx b/website/src/pages/en/ai-suite/subgraph-mcp/claude.mdx similarity index 87% rename from website/src/pages/en/subgraphs/mcp/claude.mdx rename to website/src/pages/en/ai-suite/subgraph-mcp/claude.mdx index 8b61438d2ab7..d92ef86ad7e4 100644 --- a/website/src/pages/en/subgraphs/mcp/claude.mdx +++ b/website/src/pages/en/ai-suite/subgraph-mcp/claude.mdx @@ -2,17 +2,7 @@ title: Claude Desktop --- -The Subgraph [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) server enables Claude to interact directly with Subgraphs on The Graph Network. This integration allows you to find relevant Subgraphs for specific keywords and contracts, explore Subgraph schemas, and execute GraphQL queries—all through natural language conversations with Claude. - -## What You Can Do - -The Subgraph MCP integration enables you to: - -- Access the GraphQL schema for any Subgraph on The Graph Network -- Execute GraphQL queries against any Subgraph deployment -- Find top Subgraph deployments for a given keyword or contract address -- Get 30-day query volume for Subgraph deployments -- Ask natural language questions about Subgraph data without writing GraphQL queries manually +This guide walks you through the integration of Subgraph [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) to access Subgraph data via natural language conversations with Claude. ## Prerequisites diff --git a/website/src/pages/en/subgraphs/mcp/cline.mdx b/website/src/pages/en/ai-suite/subgraph-mcp/cline.mdx similarity index 89% rename from website/src/pages/en/subgraphs/mcp/cline.mdx rename to website/src/pages/en/ai-suite/subgraph-mcp/cline.mdx index 156221d9a127..eb8044bfe991 100644 --- a/website/src/pages/en/subgraphs/mcp/cline.mdx +++ b/website/src/pages/en/ai-suite/subgraph-mcp/cline.mdx @@ -2,7 +2,7 @@ title: Cline --- -The Subgraph [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) server enables Cline to interact directly with Subgraphs on The Graph Network. This integration allows you to explore Subgraph schemas, execute GraphQL queries, and find relevant Subgraphs for specific contracts—all through natural language conversations with Cline. +This guide walks you through the integration of Subgraph [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) to access Subgraph data through natural language conversations with Cline. ## Prerequisites diff --git a/website/src/pages/en/subgraphs/mcp/cursor.mdx b/website/src/pages/en/ai-suite/subgraph-mcp/cursor.mdx similarity index 88% rename from website/src/pages/en/subgraphs/mcp/cursor.mdx rename to website/src/pages/en/ai-suite/subgraph-mcp/cursor.mdx index 298f43ece048..6291caf4b06b 100644 --- a/website/src/pages/en/subgraphs/mcp/cursor.mdx +++ b/website/src/pages/en/ai-suite/subgraph-mcp/cursor.mdx @@ -2,7 +2,7 @@ title: Cursor --- -The Subgraph [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) server enables Cursor to interact directly with Subgraphs on The Graph Network. This integration allows you to explore Subgraph schemas, execute GraphQL queries, and find relevant Subgraphs for specific contracts—all through natural language conversations with Cursor. +This guide walks you through the integration of Subgraph [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) to access Subgraph data through natural language conversations with Cline. ## Prerequisites diff --git a/website/src/pages/en/ai-suite/subgraph-mcp/introduction.mdx b/website/src/pages/en/ai-suite/subgraph-mcp/introduction.mdx new file mode 100644 index 000000000000..34b6c007c6fd --- /dev/null +++ b/website/src/pages/en/ai-suite/subgraph-mcp/introduction.mdx @@ -0,0 +1,16 @@ +--- +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. + +## What You Can Do + +- Access GraphQL schemas for any Subgraph on The Graph Network +- Run GraphQL queries on any Subgraph deployment +- Discover top Subgraph deployments by keyword or contract address +- Retrieve 30-day query volumes for Subgraph deployments +- Ask questions about Subgraph data without writing GraphQL manually + +The Subgraph MCP server allows smooth integration with [Claude](/ai-suite/subgraph-mcp/claude/), [Cline](/ai-suite/subgraph-mcp/cline/), or [Cursor](/ai-suite/subgraph-mcp/cursor/), making blockchain data queries with The Graph Network a conversational experience. diff --git a/website/src/pages/en/token-api/mcp/_meta.js b/website/src/pages/en/ai-suite/token-api-mcp/_meta.js similarity index 75% rename from website/src/pages/en/token-api/mcp/_meta.js rename to website/src/pages/en/ai-suite/token-api-mcp/_meta.js index 8630d4da27b3..6f527b4e53e4 100644 --- a/website/src/pages/en/token-api/mcp/_meta.js +++ b/website/src/pages/en/ai-suite/token-api-mcp/_meta.js @@ -1,4 +1,5 @@ export default { + introduction: '', claude: '', cline: '', cursor: '', diff --git a/website/src/pages/en/token-api/mcp/claude.mdx b/website/src/pages/en/ai-suite/token-api-mcp/claude.mdx similarity index 100% rename from website/src/pages/en/token-api/mcp/claude.mdx rename to website/src/pages/en/ai-suite/token-api-mcp/claude.mdx diff --git a/website/src/pages/en/token-api/mcp/cline.mdx b/website/src/pages/en/ai-suite/token-api-mcp/cline.mdx similarity index 100% rename from website/src/pages/en/token-api/mcp/cline.mdx rename to website/src/pages/en/ai-suite/token-api-mcp/cline.mdx diff --git a/website/src/pages/en/token-api/mcp/cursor.mdx b/website/src/pages/en/ai-suite/token-api-mcp/cursor.mdx similarity index 100% rename from website/src/pages/en/token-api/mcp/cursor.mdx rename to website/src/pages/en/ai-suite/token-api-mcp/cursor.mdx diff --git a/website/src/pages/en/ai-suite/token-api-mcp/introduction.mdx b/website/src/pages/en/ai-suite/token-api-mcp/introduction.mdx new file mode 100644 index 000000000000..39aa14e63812 --- /dev/null +++ b/website/src/pages/en/ai-suite/token-api-mcp/introduction.mdx @@ -0,0 +1,17 @@ +--- +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. + +## What You Can Do + +- Retrieve token metadata including name, symbol, decimals, total supply, and contract address +- Get token balances for any wallet address holding a supported ERC-20 token +- Fetch token transfer activity including sender, receiver, amount, and timestamp +- Identify top holders and analyze token distribution +- Ask natural language questions about token data without writing smart contract calls +- Access historical transfer data to analyze token movement over time + +The Token MCP server provides [Claude](/ai-suite/token-api-mcp/claude/), [Cline](/ai-suite/token-api-mcp/cline/), and [Cursor](/ai-suite/token-api-mcp/cursor/) with direct, conversational access to onchain token data. diff --git a/website/src/pages/en/resources/_meta.js b/website/src/pages/en/resources/_meta.js index aa8e2d0ec6a8..38c56cf56c43 100644 --- a/website/src/pages/en/resources/_meta.js +++ b/website/src/pages/en/resources/_meta.js @@ -7,5 +7,4 @@ export default { roles: titles.roles ?? '', 'migration-guides': titles['migration-guides'] ?? '', 'subgraph-studio-faq': '', - 'claude-mcp': '', } diff --git a/website/src/pages/en/resources/claude-mcp.mdx b/website/src/pages/en/resources/claude-mcp.mdx deleted file mode 100644 index 5b55bbcbe0a4..000000000000 --- a/website/src/pages/en/resources/claude-mcp.mdx +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: Claude MCP ---- - -This guide walks you through configuring Claude Desktop to use The Graph ecosystem's [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) resources: Token API and Subgraph. These integrations allow you to interact with blockchain data through natural language conversations with Claude. - -## What You Can Do - -With these integrations, you can: - -- **Token API**: Access token and wallet information across multiple blockchains -- **Subgraph**: Find relevant Subgraphs for specific keywords and contracts, explore Subgraph schemas, and execute GraphQL queries - -## Prerequisites - -- [Node.js](https://nodejs.org/en/download/) installed and available in your path -- [Claude Desktop](https://claude.ai/download) installed -- API keys: - - Token API key from [The Graph Market](https://thegraph.market/) - - Gateway API key from [Subgraph Studio](https://thegraph.com/studio/apikeys/) - -## Configuration Steps - -### 1. Open Configuration File - -Navigate to your `claude_desktop_config.json` file: - -> **Claude Desktop** > **Settings** > **Developer** > **Edit Config** - -Paths by operating system: - -- OSX: `~/Library/Application Support/Claude/claude_desktop_config.json` -- Windows: `%APPDATA%\Claude\claude_desktop_config.json` -- Linux: `.config/Claude/claude_desktop_config.json` - -### 2. Add Configuration - -Replace the contents of the existing config file with: - -```json -{ - "mcpServers": { - "token-api": { - "command": "npx", - "args": ["@pinax/mcp", "--sse-url", "https://token-api.thegraph.com/sse"], - "env": { - "ACCESS_TOKEN": "ACCESS_TOKEN" - } - }, - "subgraph": { - "command": "npx", - "args": ["mcp-remote", "--header", "Authorization:${AUTH_HEADER}", "https://subgraphs.mcp.thegraph.com/sse"], - "env": { - "AUTH_HEADER": "Bearer GATEWAY_API_KEY" - } - } - } -} -``` - -### 3. Add Your API Keys - -Replace: - -- `ACCESS_TOKEN` with your Token API key from [The Graph Market](https://thegraph.market/) -- `GATEWAY_API_KEY` with your Gateway API key from [Subgraph Studio](https://thegraph.com/studio/apikeys/) - -### 4. Save and Restart - -- Save the configuration file -- Restart Claude Desktop - -### 5. Add The Graph Resources in Claude - -After configuration: - -1. Start a new conversation in Claude Desktop -2. Click on the context menu (top right) -3. Add "Subgraph Server Instructions" as a resource by entering `graphql://subgraph` for Subgraph MCP - -> **Important**: You must manually add The Graph resources to your chat context for each conversation where you want to use them. - -### 6. Run Queries - -Here are some example queries you can try after setting up the resources: - -### Subgraph Queries - -``` -What are the top pools in Uniswap? -``` - -``` -Who are the top Delegators of The Graph Protocol? -``` - -``` -Please make a bar chart for the number of active loans in Compound for the last 7 days -``` - -### Token API Queries - -``` -Show me the current price of ETH -``` - -``` -What are the top tokens by market cap on Ethereum? -``` - -``` -Analyze this wallet address: 0x... -``` - -## Troubleshooting - -If you encounter issues: - -1. **Verify Node.js Installation**: Ensure Node.js is correctly installed by running `node -v` in your terminal -2. **Check API Keys**: Verify that your API keys are correctly entered in the configuration file -3. **Enable Verbose Logging**: Add `--verbose true` to the args array in your configuration to see detailed logs -4. **Restart Claude Desktop**: After making changes to the configuration, always restart Claude Desktop diff --git a/website/src/pages/en/subgraphs/_meta-titles.json b/website/src/pages/en/subgraphs/_meta-titles.json index f095d374344f..3fd405eed29a 100644 --- a/website/src/pages/en/subgraphs/_meta-titles.json +++ b/website/src/pages/en/subgraphs/_meta-titles.json @@ -2,6 +2,5 @@ "querying": "Querying", "developing": "Developing", "guides": "How-to Guides", - "best-practices": "Best Practices", - "mcp": "MCP" + "best-practices": "Best Practices" } diff --git a/website/src/pages/en/subgraphs/_meta.js b/website/src/pages/en/subgraphs/_meta.js index 4365293ffc72..45841d5f3355 100644 --- a/website/src/pages/en/subgraphs/_meta.js +++ b/website/src/pages/en/subgraphs/_meta.js @@ -6,7 +6,6 @@ export default { querying: titles.querying ?? '', developing: titles.developing ?? '', billing: '', - mcp: titles.mcp ?? '', guides: titles.guides, 'best-practices': titles['best-practices'], 'fair-use-policy': '', diff --git a/website/src/pages/en/token-api/_meta-titles.json b/website/src/pages/en/token-api/_meta-titles.json index 7ed31e0af95d..b606a87808a1 100644 --- a/website/src/pages/en/token-api/_meta-titles.json +++ b/website/src/pages/en/token-api/_meta-titles.json @@ -1,5 +1,4 @@ { - "mcp": "MCP", "evm": "EVM Endpoints", "monitoring": "Monitoring Endpoints", "faq": "FAQ" diff --git a/website/src/pages/en/token-api/_meta.js b/website/src/pages/en/token-api/_meta.js index f67576d7f612..39b28f89b7b4 100644 --- a/website/src/pages/en/token-api/_meta.js +++ b/website/src/pages/en/token-api/_meta.js @@ -2,7 +2,6 @@ import titles from './_meta-titles.json' export default { 'quick-start': '', - mcp: titles.mcp ?? '', evm: titles.evm ?? '', monitoring: titles.monitoring ?? '', faq: '', From 49b16e09285ec1fe1f695ce9d4692a65cb53239c Mon Sep 17 00:00:00 2001 From: Idalith Bustos Date: Wed, 25 Jun 2025 17:51:38 -0700 Subject: [PATCH 06/10] More Updates --- .../src/pages/en/ai-suite/ai-introduction.mdx | 50 ++++++++++++------- .../ai-suite/graph-assistant/how-to-guide.mdx | 4 +- .../ai-suite/graph-assistant/introduction.mdx | 4 +- 3 files changed, 36 insertions(+), 22 deletions(-) diff --git a/website/src/pages/en/ai-suite/ai-introduction.mdx b/website/src/pages/en/ai-suite/ai-introduction.mdx index fd721695f3a7..a0071f2e3d08 100644 --- a/website/src/pages/en/ai-suite/ai-introduction.mdx +++ b/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 diff --git a/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx b/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx index 0c35cb8acd6e..386334d2bbb5 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx +++ b/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 diff --git a/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx b/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx index b35d61e2559b..461fa4da1c56 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx +++ b/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. From bc7ddbe644e3780ecc3a5495b692c55de24747a8 Mon Sep 17 00:00:00 2001 From: Idalith Bustos Date: Thu, 26 Jun 2025 14:08:06 -0700 Subject: [PATCH 07/10] Edits --- website/src/pages/en/ai-suite/ai-introduction.mdx | 10 +++++----- website/src/pages/en/ai-suite/graph-assistant/faq.mdx | 8 ++++---- .../pages/en/ai-suite/graph-assistant/how-to-guide.mdx | 4 ++-- .../pages/en/ai-suite/graph-assistant/introduction.mdx | 4 ++-- .../pages/en/ai-suite/graph-assistant/quick-start.mdx | 6 +++--- .../pages/en/ai-suite/subgraph-mcp/introduction.mdx | 6 +++++- .../pages/en/ai-suite/token-api-mcp/introduction.mdx | 6 +++++- 7 files changed, 26 insertions(+), 18 deletions(-) diff --git a/website/src/pages/en/ai-suite/ai-introduction.mdx b/website/src/pages/en/ai-suite/ai-introduction.mdx index a0071f2e3d08..d6485aa34877 100644 --- a/website/src/pages/en/ai-suite/ai-introduction.mdx +++ b/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 diff --git a/website/src/pages/en/ai-suite/graph-assistant/faq.mdx b/website/src/pages/en/ai-suite/graph-assistant/faq.mdx index e461faf15dff..2f8e88a27422 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/faq.mdx +++ b/website/src/pages/en/ai-suite/graph-assistant/faq.mdx @@ -7,7 +7,7 @@ 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? @@ -15,12 +15,12 @@ An agentic application combines AI-driven reasoning with external data sources o 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. diff --git a/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx b/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx index 386334d2bbb5..5490aeb7d59c 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx +++ b/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. diff --git a/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx b/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx index 461fa4da1c56..925692319cc5 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx +++ b/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. | diff --git a/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx b/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx index 1c083bc27af1..c5602bfe6039 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx +++ b/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 diff --git a/website/src/pages/en/ai-suite/subgraph-mcp/introduction.mdx b/website/src/pages/en/ai-suite/subgraph-mcp/introduction.mdx index 34b6c007c6fd..92ca552030d3 100644 --- a/website/src/pages/en/ai-suite/subgraph-mcp/introduction.mdx +++ b/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 diff --git a/website/src/pages/en/ai-suite/token-api-mcp/introduction.mdx b/website/src/pages/en/ai-suite/token-api-mcp/introduction.mdx index 39aa14e63812..b039660a1a06 100644 --- a/website/src/pages/en/ai-suite/token-api-mcp/introduction.mdx +++ b/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 From 3de4f2b0f247492539c06ed6864a4f9dc9a51a82 Mon Sep 17 00:00:00 2001 From: Idalith Bustos Date: Thu, 26 Jun 2025 14:47:03 -0700 Subject: [PATCH 08/10] Adding disclaimer --- .../src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx | 4 +++- .../src/pages/en/ai-suite/graph-assistant/introduction.mdx | 4 ++-- .../src/pages/en/ai-suite/graph-assistant/quick-start.mdx | 6 ++++-- 3 files changed, 9 insertions(+), 5 deletions(-) diff --git a/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx b/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx index 5490aeb7d59c..056107ffd8a5 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx +++ b/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx @@ -11,7 +11,9 @@ You type a natural language question into the chat interface, such as: '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 +> [!IMPORTANT] All users can process 10 free queries per user per hour. + +> [!NOTE] Disclaimer: By using Graph Assistant, you acknowledge that your requests may be logged and used to improve the performance of the AI interface. Do not share sensitive, personal, or private information. ### Behind the Scenes diff --git a/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx b/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx index 925692319cc5..044dc8ea4646 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx +++ b/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx @@ -2,11 +2,11 @@ title: Introduction --- -[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. +[Graph Assistant](https://thegraph.com/graph-assistant) [Beta] 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 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. +[Graph Assistant](https://thegraph.com/graph-assistant) 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. diff --git a/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx b/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx index c5602bfe6039..abdb742ff9ae 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx +++ b/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx @@ -8,7 +8,7 @@ This guide provides step-by-step instructions for getting started with Graph Ass ### Step 1. Create an Account -Go to: [Graph AI](https://graph-assistant.vercel.app/) +Go to: [Graph AI](https://thegraph.com/graph-assistant) - Click Sign Up (or Log In if you already have an account). - Use your GitHub or email credentials. @@ -23,7 +23,7 @@ After logging in: ### Step 3: Ask Your First Question -> [!IMPORTANT] All users can process 10 free queries per user per hour +> [!IMPORTANT] All users can process 10 free queries per user per hour. In the input bar, type a natural-language query (everyday language). @@ -33,6 +33,8 @@ Example: Show me the 24-hour trading volume of XYZ token on Ethereum ``` +> [!NOTE] Disclaimer: By using Graph Assistant, you acknowledge that your requests may be logged and used to improve the performance of the AI interface. Do not share sensitive, personal, or private information. + The Assistant will: - Digest your question From d5510924261dc4cb2b84544cc5ce0d683d905982 Mon Sep 17 00:00:00 2001 From: Idalith Bustos Date: Thu, 26 Jun 2025 15:28:56 -0700 Subject: [PATCH 09/10] Minor edits --- website/src/pages/en/ai-suite/ai-introduction.mdx | 8 ++++---- website/src/pages/en/ai-suite/graph-assistant/faq.mdx | 6 +++--- .../pages/en/ai-suite/graph-assistant/how-to-guide.mdx | 2 +- .../pages/en/ai-suite/graph-assistant/introduction.mdx | 6 +++--- .../src/pages/en/ai-suite/subgraph-mcp/introduction.mdx | 4 +++- .../src/pages/en/ai-suite/token-api-mcp/introduction.mdx | 4 +++- 6 files changed, 17 insertions(+), 13 deletions(-) diff --git a/website/src/pages/en/ai-suite/ai-introduction.mdx b/website/src/pages/en/ai-suite/ai-introduction.mdx index d6485aa34877..2b9b1070aaea 100644 --- a/website/src/pages/en/ai-suite/ai-introduction.mdx +++ b/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** 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/). +Instead of relying on static datasets or centralized APIs, you can now access live blockchain data through **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 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 @@ -32,8 +32,8 @@ Using onchain data with AI unlocks powerful new ways to interact with and unders - "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?" +- "What's the best liqudity pool to put my ETH into?" +- "What is the total delegated stake in The Graph network?" [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. diff --git a/website/src/pages/en/ai-suite/graph-assistant/faq.mdx b/website/src/pages/en/ai-suite/graph-assistant/faq.mdx index 2f8e88a27422..8addf9935524 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/faq.mdx +++ b/website/src/pages/en/ai-suite/graph-assistant/faq.mdx @@ -7,7 +7,7 @@ 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, 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? @@ -15,11 +15,11 @@ An agentic application combines AI-driven reasoning with external data sources o 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 multiple 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. +Yes, 10 questions per hour. 5. What if the Assistant can't interpret my question? diff --git a/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx b/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx index 056107ffd8a5..aab658b0bf14 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx +++ b/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx @@ -53,4 +53,4 @@ You don't need to write queries or understand a Subgraph's schema, you simply as - “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. +To get started follow the [quickstart](/ai-suite/graph-assistant/quick-start/) and explore its capabilities. diff --git a/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx b/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx index 044dc8ea4646..902a5a91296d 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx +++ b/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx @@ -2,7 +2,7 @@ title: Introduction --- -[Graph Assistant](https://thegraph.com/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://thegraph.com/graph-assistant) (Beta) gives instant, code-free access to blockchain data, transforming natural language into precise, AI-powered queries without the need to code. ## Overview @@ -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 | -| **Backed by Subgraphs** | Uses subgraphs to index protocol-specific data like transactions, events, and protocol metrics | +| **Friendly Interface** | Conversational access to blockchain data via natural language. You simply ask questions, the Assistant fetches the answer, and renders results. | +| **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. | diff --git a/website/src/pages/en/ai-suite/subgraph-mcp/introduction.mdx b/website/src/pages/en/ai-suite/subgraph-mcp/introduction.mdx index 92ca552030d3..da1272cf9a36 100644 --- a/website/src/pages/en/ai-suite/subgraph-mcp/introduction.mdx +++ b/website/src/pages/en/ai-suite/subgraph-mcp/introduction.mdx @@ -5,7 +5,9 @@ sidebarTitle: 'Introduction' 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. +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. diff --git a/website/src/pages/en/ai-suite/token-api-mcp/introduction.mdx b/website/src/pages/en/ai-suite/token-api-mcp/introduction.mdx index b039660a1a06..d35905196d22 100644 --- a/website/src/pages/en/ai-suite/token-api-mcp/introduction.mdx +++ b/website/src/pages/en/ai-suite/token-api-mcp/introduction.mdx @@ -5,7 +5,9 @@ sidebarTitle: 'Introduction' 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. +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. From 3ebe439a8c7730d7a0a84d63d99f81510dfc114b Mon Sep 17 00:00:00 2001 From: Idalith Bustos Date: Fri, 27 Jun 2025 11:14:23 -0700 Subject: [PATCH 10/10] touchups --- website/src/pages/en/ai-suite/ai-introduction.mdx | 4 ++-- .../pages/en/ai-suite/graph-assistant/how-to-guide.mdx | 2 +- .../pages/en/ai-suite/graph-assistant/introduction.mdx | 9 +++++++++ .../pages/en/ai-suite/graph-assistant/quick-start.mdx | 10 ++++++---- 4 files changed, 18 insertions(+), 7 deletions(-) diff --git a/website/src/pages/en/ai-suite/ai-introduction.mdx b/website/src/pages/en/ai-suite/ai-introduction.mdx index 2b9b1070aaea..9b661875bb18 100644 --- a/website/src/pages/en/ai-suite/ai-introduction.mdx +++ b/website/src/pages/en/ai-suite/ai-introduction.mdx @@ -6,7 +6,7 @@ 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 **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/). +Instead of relying on static datasets or centralized APIs, you can now access live blockchain data through our **agentic** app, [Graph Assistant](/ai-suite/graph-assistant/introduction/), and use our AI-native tooling, [Subgraph MCP](/ai-suite/subgraph-mcp/introduction/), and [Token API MCP](/ai-suite/token-api-mcp/introduction/). ### Why Use Onchain Data with AI? @@ -22,7 +22,7 @@ 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. +- **Multi-source support**: Works across multiple Subgraphs and Token API. 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 diff --git a/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx b/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx index aab658b0bf14..463130894ad8 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx +++ b/website/src/pages/en/ai-suite/graph-assistant/how-to-guide.mdx @@ -13,7 +13,7 @@ You type a natural language question into the chat interface, such as: > [!IMPORTANT] All users can process 10 free queries per user per hour. -> [!NOTE] Disclaimer: By using Graph Assistant, you acknowledge that your requests may be logged and used to improve the performance of the AI interface. Do not share sensitive, personal, or private information. +> [!NOTE] Disclaimer: By using Graph Assistant, you acknowledge that your requests may be logged and used to improve the performance of the underlying agents. Do not share sensitive, personal, or private information. ### Behind the Scenes diff --git a/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx b/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx index 902a5a91296d..65fdf0f96028 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx +++ b/website/src/pages/en/ai-suite/graph-assistant/introduction.mdx @@ -2,6 +2,8 @@ title: Introduction --- +> [!IMPORTANT] Graph Assistant is still in **beta**. Expect breaking changes, rate limits, and potential downtime. + [Graph Assistant](https://thegraph.com/graph-assistant) (Beta) gives instant, code-free access to blockchain data, transforming natural language into precise, AI-powered queries without the need to code. ## Overview @@ -20,3 +22,10 @@ title: Introduction | **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. | + +## Help Shape What's Next + +This is in **beta**, and community input is essential. If you have ideas, questions, or run into anything unexpected, we'd love to hear from you: + +- Join the community on [Discord](https://discord.com/invite/graphprotocol): Provide feedback and stay in the loop with other builders. You'll be able to join the `#graph-assistant` channel to share your experience directly. +- Interested in going deeper? Reach out to become a dedicated beta tester so your specific use case can be better supported. diff --git a/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx b/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx index abdb742ff9ae..13f8478b8d2b 100644 --- a/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx +++ b/website/src/pages/en/ai-suite/graph-assistant/quick-start.mdx @@ -2,23 +2,25 @@ title: Quick Start --- +> [!IMPORTANT] Graph Assistant is still in **beta**. Expect breaking changes, rate limits, and potential downtime. + This guide provides step-by-step instructions for getting started with Graph Assistant quickly. ## Step-by Step ### Step 1. Create an Account -Go to: [Graph AI](https://thegraph.com/graph-assistant) +Go to: [Graph Assistant](https://thegraph.com/graph-assistant) - Click Sign Up (or Log In if you already have an account). -- Use your GitHub or email credentials. -- No additional setup is required +- Use your Google, GitHub, X, email or wallet credentials to log in. +- No additional setup is required. ### Step 2. Open the Assistant Chat After logging in: -- You'll see the Assistant interface. +- You'll see Graph Assistant's 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