Updating & scaffolding

MichaelMacaulay · MichaelMacaulay · commit d60f8d6e4312 · 2025-05-12T12:59:13.000-04:00
diff --git a/website/src/pages/en/subgraphs/mcp/claude.mdx b/website/src/pages/en/subgraphs/mcp/claude.mdx
@@ -2,100 +2,84 @@
 title: Claude
 ---
 
-## Using Claude Desktop to Access Subgraphs via MCP
+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.
 
-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.
-
-### What You Can Do
+## What You Can Do
 
 With the Subgraph MCP integration, you can:
 
-- Access the GraphQL schema for any subgraph on The Graph Network
-- Execute GraphQL queries against any subgraph deployment
-- Find top subgraph deployments for a contract address on a specific chain
-- Ask natural language questions about subgraph data without writing GraphQL queries manually
-
-### Requirements
-
-Before setting up the Subgraph MCP server, make sure you have:
-
-- **Claude Desktop**: Latest version installed
-- **Rust**: Latest stable version (1.75+)
-- **Gateway API key**: An API key from The Graph Network
+- Access the GraphQL schema for any Subgraph on The Graph Network
+- Execute GraphQL queries against any Subgraph deployment
+- Find top Subgraph deployments for a contract address on a specific chain
+- Ask natural language questions about Subgraph data without writing GraphQL queries manually
 
-## Installation
+## Prerequisites
 
-### Step 1: Install Rust (if not already installed)
+- [Claude Desktop](https://claude.ai/download) installed (latest version)
+- 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
 
-```bash
-curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
-```
+## Configuration
 
-Follow the on-screen instructions. For other platforms, see the [official Rust installation guide](https://www.rust-lang.org/tools/install).
+Create or edit your `claude_desktop_config.json` file.
 
-### Step 2: Install the Subgraph MCP Server
+> **Settings** > **Developer** > **Edit Config**
 
-```bash
-# Clone the repository
-git clone git@github.com:graphops/subgraph-mcp.git
-cd subgraph-mcp
+- OSX: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+- Linux: `.config/Claude/claude_desktop_config.json`
 
-# Build the project
-cargo build --release
+```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"
+      ]
+    }
+  }
+}
 ```
 
-### Step 3: Get your Gateway API Key
-
-You'll need an API key from [Subgraph Studio](https://thegraph.com/studio/) to authenticate requests to The Graph Network.
-
-## Configuration
+Replace `GATEWAY_API_KEY` with your API key from Subgraph Studio.
 
-### Configure Claude Desktop
-
-1. Open Claude Desktop and click on the top left corner to access Settings
-2. Add the Subgraph MCP server to your `claude_desktop_config.json`
+## Using Both Token API MCP and Subgraph MCP Together
 
-Here's how to set up your configuration:
+You can configure Claude Desktop to use both the Token API MCP and Subgraph MCP simultaneously:
 
-```json
+```json label="claude_desktop_config.json"
 {
   "mcpServers": {
-    "subgraph": {
-      "command": "/path/to/your/subgraph-mcp/target/release/subgraph-mcp",
+    "token-api": {
+      "command": "npx",
+      "args": ["@pinax/mcp", "--sse-url", "https://token-api.thegraph.com/sse"],
       "env": {
-        "GATEWAY_API_KEY": "your-api-key-here"
+        "ACCESS_TOKEN": "ACCESS_TOKEN"
       }
+    },
+    "subgraph": {
+      "command": "npx",
+      "args": [
+        "mcp-remote",
+        "--header",
+        "Authorization: Bearer GATEWAY_API_KEY",
+        "https://subgraph-ai.graphops.xyz/sse"
+      ]
     }
   }
 }
 ```
 
-#### Finding the Command Path
-
-After building the project, you need to specify the absolute path to the compiled binary:
-
-1. Navigate to your `subgraph-mcp` directory in the terminal
-2. Run `pwd` to get the full path to the directory
-3. Add `/target/release/subgraph-mcp` to that path
-
-For example, if `pwd` outputs `/Users/username/subgraph-mcp`, your full command path would be: `/Users/username/subgraph-mcp/target/release/subgraph-mcp`
-
-### Troubleshooting Installation
-
-If you encounter issues with the setup:
-
-1. Clean any existing build and rebuild:
+- 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/)
 
-   ```bash
-   cd subgraph-mcp
-   cargo clean
-   cargo build --release
-   ```
+## Troubleshooting
 
-2. Ensure the executable has proper permissions:
-   ```bash
-   chmod +x target/release/subgraph-mcp
-   ```
+To enable logs for the MCP, add the `--verbose true` option to your args array.
 
 ## Using The Graph Resource in Claude
 
@@ -110,91 +94,47 @@ After configuring Claude Desktop:
 
 ## Available Tools and Usage
 
-The Subgraph MCP provides several tools for interacting with subgraphs:
+The Subgraph MCP provides several tools for interacting with Subgraphs:
 
 ### Schema Retrieval Tools
 
 - **Get schema by deployment ID**: Access the GraphQL schema using a deployment ID (0x...)
-- **Get schema by subgraph ID**: Access the schema for the current deployment of a subgraph (5zvR82...)
-- **Get schema by IPFS hash**: Access the schema using a subgraph's IPFS manifest hash (Qm...)
+- **Get schema by Subgraph ID**: Access the schema for the current deployment of a Subgraph (5zvR82...)
+- **Get schema by IPFS hash**: Access the schema using a Subgraph's IPFS manifest hash (Qm...)
 
 ### Query Execution Tools
 
 - **Execute query by deployment ID**: Run GraphQL queries against specific, immutable deployments
-- **Execute query by subgraph ID**: Run GraphQL queries against the latest version of a subgraph
+- **Execute query by Subgraph ID**: Run GraphQL queries against the latest version of a Subgraph
 
 ### Discovery Tools
 
-- **Get top subgraph deployments**: Find the top 3 subgraph deployments indexing a specific contract on a particular chain
+- **Get top Subgraph deployments**: Find the top 3 Subgraph deployments indexing a specific contract on a particular chain
 
 ## Natural Language Queries
 
 One of the most powerful features of the Subgraph MCP integration is the ability to ask questions in natural language. Claude will:
 
-1. Understand your goal (lookup, find subgraphs, query, get schema)
+1. Understand your goal (lookup, find Subgraphs, query, get schema)
 2. Find relevant deployments if needed
-3. Fetch and interpret the subgraph schema
+3. Fetch and interpret the Subgraph schema
 4. Convert your question into an appropriate GraphQL query
 5. Execute the query and present the results in a readable format
 
 ### Example Natural Language Queries
 
 ```
-What are the pairs with maximum volume on 0xde0a7b5368f846f7d863d9f64949b688ad9818243151d488b4c6b206145b9ea3?
+What are the pairs with maximum volume on deployment 0xde0a7b5368f846f7d863d9f64949b688ad9818243151d488b4c6b206145b9ea3?
 
-Which tokens have the highest market cap in this subgraph?
+Which tokens have the highest market cap in this Subgraph?
 
 Show me the most recent 5 swaps for the USDC/ETH pair
 ```
 
-## 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:
-
-```json
-{
-  "mcpServers": {
-    "token-api": {
-      "command": "path-to-bunx",
-      "args": ["@pinax/mcp", "--sse-url", "https://token-api.thegraph.com/sse"],
-      "env": {
-        "ACCESS_TOKEN": "access-token-from-graph-market"
-      }
-    },
-    "subgraph": {
-      "command": "/path/to/subgraph-mcp/target/release/subgraph-mcp",
-      "env": {
-        "GATEWAY_API_KEY": "api-key-from-subgraph-studio"
-      }
-    }
-  }
-}
-```
-
-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/).
-
 ## Key Identifier Types
 
-When working with subgraphs, you'll encounter different types of identifiers:
+When working with Subgraphs, you'll encounter different types of identifiers:
 
-- **Subgraph ID** (e.g., `5zvR82...`): Logical identifier for a subgraph
+- **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
-
-## Example Interactions
-
-Here are some examples of how you can interact with Claude once the Subgraph MCP is set up:
-
-```
-Get the schema for subgraph deployment 0xYourDeploymentIdHere
-
-Run this query against subgraph 5zvR82YourSubgraphIdHere: { users(first: 1) { id } }
-
-Find the top subgraphs for contract 0x1f98431c8ad98523631ae4a59f267346ea31f984 on arbitrum-one
-```
-
-## Additional Resources
-
-- [The Graph Documentation](https://thegraph.com/docs/)
-- [Subgraph MCP GitHub Repository](https://github.com/graphops/subgraph-mcp)
-- [Token API MCP Documentation](https://thegraph.com/docs/en/token-api/mcp/claude/)
diff --git a/website/src/pages/en/subgraphs/mcp/cline.mdx b/website/src/pages/en/subgraphs/mcp/cline.mdx
@@ -2,3 +2,120 @@
 title: Cline
 ---
 
+The Subgraph Model Context Protocol (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.
+
+## Prerequisites
+
+- [Cline](https://cline.bot/) installed (latest version)
+- 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 `cline_mcp_settings.json` file.
+
+> **MCP Servers** > **Installed** > **Configure MCP Servers**
+
+```json label="cline_mcp_settings.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 Cline to use both the Token API MCP and Subgraph MCP simultaneously:
+
+```json label="cline_mcp_settings.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"
+      ]
+    }
+  }
+}
+```
+
+- 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/)
+
+## Using The Graph Resource in Cline
+
+After configuring Cline:
+
+1. Restart Cline
+2. Start a new conversation
+3. Enable the Subgraph MCP from the context menu
+4. Add "The Graph" resource to your chat context
+
+## Available Tools and Usage
+
+The Subgraph MCP provides several tools for interacting with Subgraphs:
+
+### Schema Retrieval Tools
+
+- **Get schema by deployment ID**: Access the GraphQL schema using a deployment ID (0x...)
+- **Get schema by Subgraph ID**: Access the schema for the current deployment of a Subgraph (5zvR82...)
+- **Get schema by IPFS hash**: Access the schema using a Subgraph's IPFS manifest hash (Qm...)
+
+### Query Execution Tools
+
+- **Execute query by deployment ID**: Run GraphQL queries against specific, immutable deployments
+- **Execute query by Subgraph ID**: Run GraphQL queries against the latest version of a Subgraph
+
+### Discovery Tools
+
+- **Get top Subgraph deployments**: Find the top 3 Subgraph deployments indexing a specific contract on a particular chain
+
+## Natural Language Queries
+
+One of the most powerful features of the Subgraph MCP integration is the ability to ask questions in natural language. Cline will:
+
+1. Understand your goal (lookup, find Subgraphs, query, get schema)
+2. Find relevant deployments if needed
+3. Fetch and interpret the Subgraph schema
+4. Convert your question into an appropriate GraphQL query
+5. Execute the query and present the results in a readable format
+
+### Example Natural Language Queries
+
+```
+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
diff --git a/website/src/pages/en/subgraphs/mcp/cursor.mdx b/website/src/pages/en/subgraphs/mcp/cursor.mdx
