Latest edits

Author: MichaelMacaulay

website/src/pages/en/resources/_meta.js

@@ -7,4 +7,5 @@ export default {
   roles: titles.roles,
   'migration-guides': titles['migration-guides'],
   'subgraph-studio-faq': '',
+  'claud-mcp': '',
 }

website/src/pages/en/resources/claud-mcp.mdx

@@ -0,0 +1,123 @@
+---
+title: Claude MCP
+---
+
+This guide walks you through configuring Claude Desktop to use The Graph ecosystem's Model Context Protocol (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**: Explore Subgraph schemas, execute GraphQL queries, and find relevant Subgraphs for specific contracts
+
+## 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
+
+Follow these steps to configure both Token API and Subgraph MCP in Claude Desktop:
+
+### Step 1: Open Configuration File
+
+Edit your `claude_desktop_config.json` file:
+
+> **Claude Desktop** > **Settings** > **Developer** > **Edit Config**
+
+File locations 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`
+
+### Step 2: Add Configuration
+
+Replace the existing configuration with this template:
+
+```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: Bearer GATEWAY_API_KEY",
+        "https://subgraph-ai.graphops.xyz/sse"
+      ]
+    }
+  }
+}
+```
+
+### Step 3: Add Your API Keys
+
+1. Replace `ACCESS_TOKEN` with your Token API key from [The Graph Market](https://thegraph.market/)
+2. Replace `GATEWAY_API_KEY` with your Gateway API key from [Subgraph Studio](https://thegraph.com/studio/apikeys/)
+
+### Step 4: Save and Restart
+
+Save the configuration file and restart Claude Desktop.
+
+## Using 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 "The Graph" resource by entering `graphql://subgraph` for Subgraph MCP and/or `token-api://token-api` for Token API
+
+**Important**: You must manually add The Graph resources to your chat context for each conversation where you want to use them.
+
+## Example Queries
+
+Here are some example queries you can try after setting up the resources:
+
+### Subgraph Queries
+
+```
+What are the top pools in Uniswap?
+```
+
+```
+Top delegators of The Graph Protocol?
+```
+
+```
+Number of active loans in Compound for the last 7 days? Please make it a bar chart
+```
+
+### 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

website/src/pages/en/subgraphs/mcp/claude.mdx

@@ -1,5 +1,5 @@
 ---
-title: Claude
+title: Claude Desktop
 ---
 
 The Subgraph Model Context Protocol (MCP) server enables Claude 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 Claude.
@@ -15,52 +15,25 @@ With the Subgraph MCP integration, you can:
 
 ## Prerequisites
 
-- [Claude Desktop](https://claude.ai/download) installed (latest version)
+- [Node.js](https://nodejs.org/en) installed and available in your path
+- [Claude Desktop](https://claude.ai/download) installed
 - A Gateway API key from [Subgraph Studio](https://thegraph.com/studio/)
-- [`npx`](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) or [`bunx`](https://bun.sh/) installed and available in your path
 
 ## Configuration
 
-Create or edit your `claude_desktop_config.json` file.
+Edit your `claude_desktop_config.json` file.
 
 > **Settings** > **Developer** > **Edit Config**
 
 - OSX: `~/Library/Application Support/Claude/claude_desktop_config.json`
 - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 - Linux: `.config/Claude/claude_desktop_config.json`
 
-```json label="claude_desktop_config.json"
-{
-  "mcpServers": {
-    "subgraph": {
-      "command": "npx",
-      "args": [
-        "mcp-remote",
-        "--header",
-        "Authorization: Bearer GATEWAY_API_KEY",
-        "https://subgraph-ai.graphops.xyz/sse"
-      ]
-    }
-  }
-}
-```
-
-Replace `GATEWAY_API_KEY` with your API key from Subgraph Studio.
-
-## Using Both Token API MCP and Subgraph MCP Together
-
-You can configure Claude Desktop to use both the Token API MCP and Subgraph MCP simultaneously:
+Paste the following settings into your config file:
 
 ```json label="claude_desktop_config.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": [
@@ -74,12 +47,9 @@ You can configure Claude Desktop to use both the Token API MCP and Subgraph MCP
 }
 ```
 
-- For Token API access tokens, visit [The Graph Market](https://thegraph.com/explorer)
-- For Subgraph Gateway API keys, visit [Subgraph Studio](https://thegraph.com/studio/)
-
-## Troubleshooting
+Replace `GATEWAY_API_KEY` with your API key from [Subgraph Studio](https://thegraph.com/studio/).
 
-To enable logs for the MCP, add the `--verbose true` option to your args array.
+Once you've entered your Gateway API key into your settings, you can save the file, and restart Claude desktop.
 
 ## Using The Graph Resource in Claude
 
@@ -92,6 +62,10 @@ After configuring Claude Desktop:
 
 **Important**: Claude Desktop may not automatically utilize the Subgraph MCP. You must manually add "The Graph" resource to your chat context for each conversation where you want to use it.
 
+## Troubleshooting
+
+To enable logs for the MCP, add the `--verbose true` option to your args array.
+
 ## Available Tools and Usage
 
 The Subgraph MCP provides several tools for interacting with Subgraphs:
@@ -125,16 +99,12 @@ One of the most powerful features of the Subgraph MCP integration is the ability
 
 ```
 What are the pairs with maximum volume on deployment 0xde0a7b5368f846f7d863d9f64949b688ad9818243151d488b4c6b206145b9ea3?
+```
 
+```
 Which tokens have the highest market cap in this Subgraph?
+```
 
+```
 Show me the most recent 5 swaps for the USDC/ETH pair
 ```
-
-## Key Identifier Types
-
-When working with Subgraphs, you'll encounter different types of identifiers:
-
-- **Subgraph ID** (e.g., `5zvR82...`): Logical identifier for a Subgraph
-- **Deployment ID** (e.g., `0x4d7c...`): Identifier for a specific, immutable deployment
-- **IPFS Hash** (e.g., `QmTZ8e...`): Identifier for the manifest of a specific deployment