From 56dc489b1c80e9792c71accf10c3f2878961ce20 Mon Sep 17 00:00:00 2001 From: William Lyon Date: Tue, 3 Jun 2025 19:16:13 -0700 Subject: [PATCH 1/7] add Hypermode Graph MCP doc --- docs.json | 3 +- graphs/graph-mcp.mdx | 350 +++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 352 insertions(+), 1 deletion(-) create mode 100644 graphs/graph-mcp.mdx diff --git a/docs.json b/docs.json index d3c5cb18..1c6a7e38 100644 --- a/docs.json +++ b/docs.json @@ -59,7 +59,8 @@ "graphs/connect", "graphs/manage-schema", "graphs/manage-data", - "graphs/manage-graph" + "graphs/manage-graph", + "graphs/graph-mcp" ] }, { diff --git a/graphs/graph-mcp.mdx b/graphs/graph-mcp.mdx new file mode 100644 index 00000000..54945c62 --- /dev/null +++ b/graphs/graph-mcp.mdx @@ -0,0 +1,350 @@ +--- +title: Hypermode Graph MCP +description: + "Connect your Dgraph database to AI coding assistants using the Model Context + Protocol for exploratory data analysis and intelligent graph operations" +mode: "wide" +sidebarTitle: "Graph MCP" +"og:title": "Graph MCP" +--- + +## Overview + +The Hypermode Graph MCP (Model Context Protocol) server enables seamless +integration between your graph database and AI coding assistants like Claude +Desktop, Cursor, a nd other MCP-compatible tools. Two MCP endpoints are +available with common tools for AI coding assistants: `mcp` – a server that +provides tools and data from your Dgraph cluster · `mcp-ro` – a server that +provides tools and data from your Dgraph cluster in read-only mode + + + **What is MCP?** The Model Context Protocol is an open standard that enables + developers to build secure, two-way connections between their data sources and + AI-powered tools. Think of it as a universal connector that allows AI + assistants to understand and interact with your graph data. + + +## Why use Hypermode Graph MCP? + +### For exploratory data analysis + +- **Interactive graph exploration**: Query your knowledge graphs using natural + language through your AI assistant +- **Pattern Discovery**: Let AI help identify relationships, clusters, and + anomalies in your graph data +- **Dynamic schema understanding**: AI assistants can introspect your graph + structure and suggest optimal queries +- **Real-time insights**: Get immediate answers about your data without writing + complex DQL queries + +### For AI coding assistants + +- **Context-aware development**: Your coding assistant understands your graph + schema and data patterns +- **Intelligent query generation**: AI can write and optimize DQL queries based + on your specific use case +- **Schema evolution support**: Get suggestions for schema changes and + migrations +- **Debugging assistance**: AI can help troubleshoot graph queries and + performance issues + +## Architecture + +The Dgraph MCP server follows the standard MCP architecture: + +```mermaid +graph LR + A[AI Assistant
Claude/Cursor] --> B[MCP Client] + B --> C[Dgraph MCP Server] + C --> D[Hypermode Graph] + C --> E[Local Dgraph Cluster] +``` + +**Components:** + +- **MCP Host**: Your AI-powered application (Claude Desktop, IDE with AI + features) +- **MCP Client**: Protocol client that maintains connection with the Dgraph + server +- **Dgraph MCP Server**: Exposes graph capabilities through standardized MCP + interface +- **Graph Database**: Your Dgraph cluster (local or on Hypermode) + +## MCP server types + +Dgraph provides two MCP server variants to match your security and usage +requirements: + +### Standard MCP server (`mcp`) + +- **Full Access**: Read and write operations on your graph +- **Use Cases**: Development environments, data modeling, schema evolution +- **Capabilities**: Query execution, mutations, schema modifications, namespace + management + +### Read-only MCP server (`mcp-ro`) + +- **Safe Exploration**: Query-only access to your graph data +- **Use Cases**: Production analysis, reporting, exploratory data analysis +- **Capabilities**: DQL queries, schema introspection, data visualization + support + + + Choose the read-only server (`mcp-ro`) for production environments or when + working with sensitive data to prevent accidental modifications. + + +## Setup guide + +When using Hypermode Graphs, the MCP configuration is available on the graph +details screen in the console: + + + +Navigate to your Hypermode workspace and select your graph instance. + + + + From the graph details screen, copy the provided MCP configuration. + + + +Add the configuration to your AI assistant's settings: + +```json +{ + "mcpServers": { + "hypermode-graph": { + "command": "npx", + "args": [ + "mcp-remote", + "https://.hypermode.host/mcp/sse", + "--header", + "Authorization: Bearer " + ] + } + } +} +``` + + + + +## Available Capabilities + +```mermaid +graph TD + subgraph TopRow [" "] + direction LR + subgraph Client ["MCP Client"] + C1["Invokes Tools"] + C2["Queries for Resources"] + C3["Interpolates Prompts"] + end + + subgraph Server ["MCP Server"] + S1["Exposes Tools"] + S2["Exposes Resources"] + S3["Exposes Prompt Templates"] + end + + Client <--> Server + end + + subgraph BottomRow [" "] + direction LR + subgraph Tools ["Tools"] + direction TB + T1["Functions and tools that
can be invoked by the
client"] + T2["Retrieve / search"] + T3["Send a message"] + T4["Update DB records"] + end + + subgraph Resources ["Resources"] + direction TB + R1["Read-only data or
exposed by the server"] + R2["Files"] + R3["Database Records"] + R4["API Responses"] + end + + subgraph Templates ["Prompt Templates"] + direction TB + P1["Pre-defined templates
for AI interactions"] + P2["Document Q&A"] + P3["Transcript Summary"] + P4["Output as JSON"] + end + end + + TopRow --> BottomRow + + classDef clientBox fill:#f9f9f9,stroke:#d4b896,stroke-width:2px,color:#000 + classDef serverBox fill:#e8dcc6,stroke:#d4b896,stroke-width:2px,color:#000 + classDef sectionHeader fill:#8b4513,color:#fff,font-weight:bold + classDef description fill:#e8dcc6,stroke:#d4b896,stroke-width:1px,color:#000 + classDef example fill:#e8dcc6,stroke:#d4b896,stroke-width:1px,color:#000 + + class Client clientBox + class Server serverBox + class T1,R1,P1 description + class T2,T3,T4,R2,R3,R4,P2,P3,P4 example +``` + +### Tools + +Interactive tools for graph operations: + +The MCP servers provide the following tools: + +#### `get_schema` + +Retrieve the current schema of your graph database. + +#### `run_query` + +Run a DQL query on your graph database. + +**Parameters:** + +- `query` (string): DQL query to execute + +#### `run_mutation` + +Run a DQL mutation on your graph database. + +**Parameters:** + +- `mutation` (string): DQL mutation to execute + +#### `alter_schema` + +Modify the DQL schema of your graph database. + +**Parameters:** + +- `schema` (string): DQL schema to apply + +#### `get_common_queries` + +Provides reference queries to aide in query syntax. + +### Resources + +The MCP server exposes your graph data as accessible resources: + +#### `dgraph://schema` + +The current Dgraph DQL schema. + +#### `dgraph://common_queries` + +Pre-built query patterns for common operations. + +### Prompts + +Pre-configured prompt templates for common graph operations: + +- **Data Exploration**: "Analyze the structure and relationships in this graph" +- **Performance Optimization**: "Suggest improvements for this query + performance" +- **Schema Design**: "Help design an optimal schema for this data model" +- **Migration Planning**: "Plan a migration strategy for this schema change" + +#### `quickstart_prompt` + +A quickstart prompt for getting started with graph MCP. + +## Example workflows + +### Exploratory data analysis + + + + + +Ask your AI assistant: "What does my graph schema look like and what are the main entity types?" + + + + "Find all users who have more than 10 connections and show me their + relationship patterns." + + + + "What's the distribution of node types in my graph? Are there any outliers or + interesting clusters?" + + + +"Which queries are running slowly and how can I optimize them?" + + + +### AI-assisted development + + + +"I want to model a social network with users, posts, and interactions. What's the optimal schema design?" + + + + "This query is slow: `[paste query]`. How can I improve its performance?" + + + + "Based on my query patterns, what indices should I add to improve + performance?" + + + +"I need to add a new 'tags' predicate to existing posts. What's the safest migration approach?" + + + +## Best practices + +### Security + +- **Use Read-Only Servers**: Default to `mcp-ro` for analysis and exploration +- **Authentication**: Always use bearer tokens for Hypermode connections + +### Development workflow + +- **Start with Read-Only**: Begin exploration with `mcp-ro` to understand your + data +- **Iterative Schema Design**: Use AI assistance for gradual schema evolution +- **Query Testing**: Validate AI-generated queries in development before + production +- **Documentation**: Keep schema documentation updated for better AI + understanding + +## Community and support + + + +Join discussions about Graph MCP and get help from the community + + + + Report bugs and request features for the MCP server + + + +Comprehensive Dgraph documentation and guides + + +``` From 5cce00fd56fc2fe57ccd9fd807c22751c8f017e9 Mon Sep 17 00:00:00 2001 From: William Lyon Date: Tue, 3 Jun 2025 19:46:24 -0700 Subject: [PATCH 2/7] fix formatting --- graphs/graph-mcp.mdx | 47 +++++++++---------- styles/config/vocabularies/general/accept.txt | 1 + 2 files changed, 24 insertions(+), 24 deletions(-) diff --git a/graphs/graph-mcp.mdx b/graphs/graph-mcp.mdx index 54945c62..2c31384e 100644 --- a/graphs/graph-mcp.mdx +++ b/graphs/graph-mcp.mdx @@ -12,13 +12,13 @@ sidebarTitle: "Graph MCP" The Hypermode Graph MCP (Model Context Protocol) server enables seamless integration between your graph database and AI coding assistants like Claude -Desktop, Cursor, a nd other MCP-compatible tools. Two MCP endpoints are -available with common tools for AI coding assistants: `mcp` – a server that -provides tools and data from your Dgraph cluster · `mcp-ro` – a server that -provides tools and data from your Dgraph cluster in read-only mode +Desktop, Cursor, and other MCP-compatible tools. Two MCP endpoints are available +with common tools for AI coding assistants: `mcp` (a server that provides tools +and data from your Dgraph cluster) and `mcp-ro` (a server that provides tools +and data from your Dgraph cluster in read-only mode). - **What is MCP?** The Model Context Protocol is an open standard that enables + **What's MCP?** The Model Context Protocol is an open standard that enables developers to build secure, two-way connections between their data sources and AI-powered tools. Think of it as a universal connector that allows AI assistants to understand and interact with your graph data. @@ -62,13 +62,12 @@ graph LR **Components:** -- **MCP Host**: Your AI-powered application (Claude Desktop, IDE with AI - features) -- **MCP Client**: Protocol client that maintains connection with the Dgraph +- **MCP host**: Your AI-powered app (Claude Desktop, IDE with AI features) +- **MCP client**: Protocol client that maintains connection with the Dgraph server -- **Dgraph MCP Server**: Exposes graph capabilities through standardized MCP +- **Dgraph MCP server**: Exposes graph capabilities through standardized MCP interface -- **Graph Database**: Your Dgraph cluster (local or on Hypermode) +- **Graph database**: Your Dgraph cluster (local or on Hypermode) ## MCP server types @@ -130,7 +129,7 @@ Add the configuration to your AI assistant's settings: -## Available Capabilities +## Available capabilities ```mermaid graph TD @@ -272,21 +271,21 @@ encrypted-media; gyroscope; picture-in-picture" -Ask your AI assistant: "What does my graph schema look like and what are the main entity types?" +Ask your AI assistant: "What does the graph schema look like and what are the main entity types?" - - "Find all users who have more than 10 connections and show me their - relationship patterns." + + "Find all users who have more than 10 connections and show their relationship + patterns." - - "What's the distribution of node types in my graph? Are there any outliers or + + "What's the distribution of node types in the graph? Are there any outliers or interesting clusters?" - -"Which queries are running slowly and how can I optimize them?" + +"Which queries are running slowly and how can we optimize them?" @@ -297,16 +296,16 @@ Ask your AI assistant: "What does my graph schema look like and what are the mai "I want to model a social network with users, posts, and interactions. What's the optimal schema design?" - - "This query is slow: `[paste query]`. How can I improve its performance?" + + "This query is slow: `[paste query]`. How can we improve its performance?" - - "Based on my query patterns, what indices should I add to improve + + "Based on the query patterns, what indices should we add to improve performance?" - + "I need to add a new 'tags' predicate to existing posts. What's the safest migration approach?" diff --git a/styles/config/vocabularies/general/accept.txt b/styles/config/vocabularies/general/accept.txt index 9803b44c..c9e9f431 100644 --- a/styles/config/vocabularies/general/accept.txt +++ b/styles/config/vocabularies/general/accept.txt @@ -25,6 +25,7 @@ [Hh]ypermode [Ii]nferencing [Ll]og +[Mm][Cc][Pp] [Mm]odus [Nn]amespace [Nn]amespaces From c2379e57dd8cefebde00bba4e68877972667ba71 Mon Sep 17 00:00:00 2001 From: William Lyon Date: Wed, 4 Jun 2025 10:50:06 -0700 Subject: [PATCH 3/7] updates --- graphs/graph-mcp.mdx | 41 ++++++++++++++++++++--------------------- 1 file changed, 20 insertions(+), 21 deletions(-) diff --git a/graphs/graph-mcp.mdx b/graphs/graph-mcp.mdx index 2c31384e..e8790a91 100644 --- a/graphs/graph-mcp.mdx +++ b/graphs/graph-mcp.mdx @@ -1,7 +1,7 @@ --- title: Hypermode Graph MCP description: - "Connect your Dgraph database to AI coding assistants using the Model Context + "Connect your Hypermode Graph to AI coding assistants using the Model Context Protocol for exploratory data analysis and intelligent graph operations" mode: "wide" sidebarTitle: "Graph MCP" @@ -10,18 +10,19 @@ sidebarTitle: "Graph MCP" ## Overview -The Hypermode Graph MCP (Model Context Protocol) server enables seamless -integration between your graph database and AI coding assistants like Claude -Desktop, Cursor, and other MCP-compatible tools. Two MCP endpoints are available -with common tools for AI coding assistants: `mcp` (a server that provides tools -and data from your Dgraph cluster) and `mcp-ro` (a server that provides tools -and data from your Dgraph cluster in read-only mode). +The Hypermode Graph MCP (Model Context Protocol) server enables integration +between your Hypermode Graph and AI coding assistants like Claude Desktop, +Cursor, and other MCP-compatible tools. Two MCP endpoints are available with +common tools for AI coding assistants: `mcp` (an endpoint that provides tools +and data from your Graph) and `mcp-ro` (an endpoint that provides tools and data +from your Graph in read-only mode). **What's MCP?** The Model Context Protocol is an open standard that enables developers to build secure, two-way connections between their data sources and - AI-powered tools. Think of it as a universal connector that allows AI - assistants to understand and interact with your graph data. + AI-powered tools. Think of the Hypermode Graph MCP server as a universal + connector that allows AI assistants to understand and interact with your graph + data. ## Why use Hypermode Graph MCP? @@ -50,7 +51,7 @@ and data from your Dgraph cluster in read-only mode). ## Architecture -The Dgraph MCP server follows the standard MCP architecture: +The Hypermode Graph MCP server follows the standard MCP architecture: ```mermaid graph LR @@ -71,8 +72,8 @@ graph LR ## MCP server types -Dgraph provides two MCP server variants to match your security and usage -requirements: +Hypermode Graph provides two MCP server variants to match your security and +usage requirements: ### Standard MCP server (`mcp`) @@ -195,7 +196,7 @@ graph TD Interactive tools for graph operations: -The MCP servers provide the following tools: +The Hypermode Graph MCP server provide the following tools: #### `get_schema` @@ -231,7 +232,12 @@ Provides reference queries to aide in query syntax. ### Resources -The MCP server exposes your graph data as accessible resources: +The MCP server exposes read only data from your graph as resources: + + + Due to current limitations in some MCP clients that don't yet support MCP + resources, some tools are exposed as both tools and resources. + #### `dgraph://schema` @@ -245,12 +251,6 @@ Pre-built query patterns for common operations. Pre-configured prompt templates for common graph operations: -- **Data Exploration**: "Analyze the structure and relationships in this graph" -- **Performance Optimization**: "Suggest improvements for this query - performance" -- **Schema Design**: "Help design an optimal schema for this data model" -- **Migration Planning**: "Plan a migration strategy for this schema change" - #### `quickstart_prompt` A quickstart prompt for getting started with graph MCP. @@ -346,4 +346,3 @@ Join discussions about Graph MCP and get help from the community Comprehensive Dgraph documentation and guides -``` From a3780dfff0bd4a03feca812755e984d16be9cc62 Mon Sep 17 00:00:00 2001 From: William Lyon Date: Wed, 4 Jun 2025 11:58:44 -0600 Subject: [PATCH 4/7] Update graphs/graph-mcp.mdx Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- graphs/graph-mcp.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/graphs/graph-mcp.mdx b/graphs/graph-mcp.mdx index e8790a91..2363c480 100644 --- a/graphs/graph-mcp.mdx +++ b/graphs/graph-mcp.mdx @@ -228,7 +228,7 @@ Modify the DQL schema of your graph database. #### `get_common_queries` -Provides reference queries to aide in query syntax. +Provides reference queries to aid in query syntax. ### Resources From f905bdee0b6439853307a63b0427ac964ea8ee98 Mon Sep 17 00:00:00 2001 From: William Lyon Date: Wed, 4 Jun 2025 11:59:11 -0600 Subject: [PATCH 5/7] Update styles/config/vocabularies/general/accept.txt Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- styles/config/vocabularies/general/accept.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/styles/config/vocabularies/general/accept.txt b/styles/config/vocabularies/general/accept.txt index c9e9f431..0c53ac6f 100644 --- a/styles/config/vocabularies/general/accept.txt +++ b/styles/config/vocabularies/general/accept.txt @@ -25,7 +25,7 @@ [Hh]ypermode [Ii]nferencing [Ll]og -[Mm][Cc][Pp] +(?i)mcp [Mm]odus [Nn]amespace [Nn]amespaces From af5ef6546f5377dd069f44b372ddc1bf6fd33586 Mon Sep 17 00:00:00 2001 From: danstarns Date: Fri, 6 Jun 2025 12:34:36 +0700 Subject: [PATCH 6/7] add local mcp notes + example tool query and response. --- graphs/graph-mcp.mdx | 346 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 346 insertions(+) diff --git a/graphs/graph-mcp.mdx b/graphs/graph-mcp.mdx index 2363c480..cf3d0564 100644 --- a/graphs/graph-mcp.mdx +++ b/graphs/graph-mcp.mdx @@ -96,6 +96,8 @@ usage requirements: ## Setup guide +### Running with Hypermode Graphs + When using Hypermode Graphs, the MCP configuration is available on the graph details screen in the console: @@ -130,6 +132,68 @@ Add the configuration to your AI assistant's settings: +### Running with local Dgraph + +You can also run MCP with your local Dgraph instance by starting the Alpha +server with the `--mcp` flag: + +#### Starting Dgraph Alpha with MCP + +```bash +# Start Dgraph Zero +dgraph zero --my=localhost:5080 + +# Start Dgraph Alpha with MCP enabled +dgraph alpha --my=localhost:7080 --zero=localhost:5080 --mcp +``` + +This enables two MCP endpoints on your Alpha server: + +- **Full access**: `http://localhost:8080/mcp/sse` +- **Read-only**: `http://localhost:8080/mcp-ro/sse` + +#### Configure AI assistant for local Dgraph + +```json +{ + "mcpServers": { + "dgraph-local": { + "command": "npx", + "args": ["mcp-remote", "http://localhost:8080/mcp/sse"] + }, + "dgraph-local-readonly": { + "command": "npx", + "args": ["mcp-remote", "http://localhost:8080/mcp-ro/sse"] + } + } +} +``` + +#### Standalone MCP server + +For development or testing, you can also run a standalone MCP server: + +```bash +# Run standalone MCP server +dgraph mcp --conn-str="dgraph://localhost:9080" + +# Run in read-only mode +dgraph mcp --conn-str="dgraph://localhost:9080" --read-only +``` + +For standalone servers, configure your AI assistant with: + +```json +{ + "mcpServers": { + "dgraph-standalone": { + "command": "dgraph", + "args": ["mcp", "--conn-str=dgraph://localhost:9080"] + } + } +} +``` + ## Available capabilities ```mermaid @@ -202,6 +266,60 @@ The Hypermode Graph MCP server provide the following tools: Retrieve the current schema of your graph database. +##### Example schema query + +**User request:** + +```text +"What's the current schema for our financial data model?" +``` + +**Tool call:** + +```json +{ + "name": "get_schema", + "arguments": {} +} +``` + +**Response:** + +```json +{ + "schema": [ + { + "predicate": "account_number", + "type": "string", + "index": true, + "tokenizer": ["exact"] + }, + { + "predicate": "balance", + "type": "float" + }, + { + "predicate": "amount", + "type": "float" + }, + { + "predicate": "status", + "type": "string", + "index": true, + "tokenizer": ["exact"] + }, + { + "predicate": "from_account", + "type": "uid" + }, + { + "predicate": "to_account", + "type": "uid" + } + ] +} +``` + #### `run_query` Run a DQL query on your graph database. @@ -210,6 +328,63 @@ Run a DQL query on your graph database. - `query` (string): DQL query to execute +##### Example query + +**User request:** + +```text +"Show me all pending transactions and their amounts" +``` + +**Tool call:** + +```json +{ + "name": "run_query", + "arguments": { + "query": "{ + transactions(func: eq(status, \"pending\")) { + uid + amount + status + timestamp + from_account { + account_number + balance + } + to_account { + account_number + balance + } + } + }" + } +} +``` + +**Response:** + +```json +{ + "transactions": [ + { + "uid": "0x1a", + "amount": 150.5, + "status": "pending", + "timestamp": "2024-06-06T10:30:00Z", + "from_account": { + "account_number": "ACC001", + "balance": 2500.0 + }, + "to_account": { + "account_number": "ACC002", + "balance": 1800.0 + } + } + ] +} +``` + #### `run_mutation` Run a DQL mutation on your graph database. @@ -218,6 +393,47 @@ Run a DQL mutation on your graph database. - `mutation` (string): DQL mutation to execute +##### Example mutation + +**User request:** + +```text +"Process a $500 transfer from account ACC001 to account ACC003" +``` + +**Tool call:** + +```json +{ + "name": "run_mutation", + "arguments": { + "mutation": "{ + \"set\": [ + { + \"uid\": \"_:txn\", + \"dgraph.type\": \"Transaction\", + \"amount\": 500.00, + \"status\": \"pending\", + \"timestamp\": \"2024-06-06T11:15:00Z\", + \"from_account\": { + \"uid\": \"0x10\" + }, + \"to_account\": { + \"uid\": \"0x11\" + } + } + ] + }" + } +} +``` + +**Response:** + +```text +Mutation completed, 1 UIDs created +``` + #### `alter_schema` Modify the DQL schema of your graph database. @@ -226,6 +442,34 @@ Modify the DQL schema of your graph database. - `schema` (string): DQL schema to apply +##### Example schema update + +**User request:** + +```text +"Add support for transaction fees and currency types to our payment system" +``` + +**Tool call:** + +```json +{ + "name": "alter_schema", + "arguments": { + "schema": "transaction_fee: float . + currency: string @index(exact) . + exchange_rate: float . + fee_type: string @index(term) ." + } +} +``` + +**Response:** + +```text +Schema updated successfully +``` + #### `get_common_queries` Provides reference queries to aid in query syntax. @@ -255,6 +499,108 @@ Pre-configured prompt templates for common graph operations: A quickstart prompt for getting started with graph MCP. +## Example tool interactions + +Here are additional examples of AI assistant interactions with the MCP tools +using a financial transaction theme: + +### Complex transaction analysis + +**User request:** + +```text +"Find all high-value transactions over $1000 from the last week and show +which accounts were involved" +``` + +**Tool call:** + +```json +{ + "name": "run_query", + "arguments": { + "query": "{ + high_value_txns(func: ge(amount, 1000.0)) + @filter(ge(timestamp, \"2024-05-30T00:00:00Z\")) { + uid + amount + timestamp + status + from_account { + account_number + account_holder + balance + } + to_account { + account_number + account_holder + balance + } + } + }" + } +} +``` + +**Response:** + +```json +{ + "high_value_txns": [ + { + "uid": "0x2b", + "amount": 2500.0, + "timestamp": "2024-06-05T14:22:00Z", + "status": "completed", + "from_account": { + "account_number": "ACC005", + "account_holder": "Tech Corp Ltd", + "balance": 45000.0 + }, + "to_account": { + "account_number": "ACC007", + "account_holder": "Supplier Inc", + "balance": 12000.0 + } + } + ] +} +``` + +### Account balance updates + +**User request:** + +```text +"Update account ACC001's balance to $3000 after processing pending +transactions" +``` + +**Tool call:** + +```json +{ + "name": "run_mutation", + "arguments": { + "mutation": "{ + \"set\": [ + { + \"uid\": \"0x10\", + \"balance\": 3000.00, + \"last_updated\": \"2024-06-06T11:30:00Z\" + } + ] + }" + } +} +``` + +**Response:** + +```text +Mutation completed, 1 UIDs created +``` + ## Example workflows ### Exploratory data analysis From f4eeb85837b29b2ecdaacc694ae9c8f995418a95 Mon Sep 17 00:00:00 2001 From: danstarns Date: Fri, 6 Jun 2025 12:41:53 +0700 Subject: [PATCH 7/7] headers --- graphs/graph-mcp.mdx | 20 ++++++-------------- 1 file changed, 6 insertions(+), 14 deletions(-) diff --git a/graphs/graph-mcp.mdx b/graphs/graph-mcp.mdx index cf3d0564..6a4b41c2 100644 --- a/graphs/graph-mcp.mdx +++ b/graphs/graph-mcp.mdx @@ -266,9 +266,7 @@ The Hypermode Graph MCP server provide the following tools: Retrieve the current schema of your graph database. -##### Example schema query - -**User request:** +**Example User request:** ```text "What's the current schema for our financial data model?" @@ -328,9 +326,7 @@ Run a DQL query on your graph database. - `query` (string): DQL query to execute -##### Example query - -**User request:** +**Example User request:** ```text "Show me all pending transactions and their amounts" @@ -393,9 +389,7 @@ Run a DQL mutation on your graph database. - `mutation` (string): DQL mutation to execute -##### Example mutation - -**User request:** +**Example User request:** ```text "Process a $500 transfer from account ACC001 to account ACC003" @@ -442,9 +436,7 @@ Modify the DQL schema of your graph database. - `schema` (string): DQL schema to apply -##### Example schema update - -**User request:** +**Example User request:** ```text "Add support for transaction fees and currency types to our payment system" @@ -506,7 +498,7 @@ using a financial transaction theme: ### Complex transaction analysis -**User request:** +**Example User request:** ```text "Find all high-value transactions over $1000 from the last week and show @@ -569,7 +561,7 @@ which accounts were involved" ### Account balance updates -**User request:** +**Example User request:** ```text "Update account ACC001's balance to $3000 after processing pending