QuerySculptor

by flinstonedev

308 downloads

Not rated

GitHub

About

QuerySculptor is a GraphQL query builder designed for AI agents that provides 26 structured tools via the Model Context Protocol (MCP). Instead of generating complex GraphQL queries from scratch, AI agents can build queries step-by-step with real-time validation, schema introspec

Details

Author: flinstonedev
Downloads: 308
Categories: Other, AI, Cloud Service, Developer Tools, Automation

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name QuerySculptor

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "querysculptor": {
            "querysculptor": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://agent-query-builder-toolbox.vercel.app/mcp",
                    "--allow-http"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "querysculptor": {
            "querysculptor": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://agent-query-builder-toolbox.vercel.app/mcp",
                    "--allow-http"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "querysculptor": {
            "querysculptor": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://agent-query-builder-toolbox.vercel.app/mcp",
                    "--allow-http"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "querysculptor": {
            "querysculptor": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://agent-query-builder-toolbox.vercel.app/mcp",
                    "--allow-http"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "querysculptor": {
            "querysculptor": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://agent-query-builder-toolbox.vercel.app/mcp",
                    "--allow-http"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "querysculptor": {
            "querysculptor": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://agent-query-builder-toolbox.vercel.app/mcp",
                    "--allow-http"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "querysculptor": {
            "querysculptor": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://agent-query-builder-toolbox.vercel.app/mcp",
                    "--allow-http"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "querysculptor": {
            "querysculptor": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://agent-query-builder-toolbox.vercel.app/mcp",
                    "--allow-http"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "querysculptor": {
            "querysculptor": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://agent-query-builder-toolbox.vercel.app/mcp",
                    "--allow-http"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "querysculptor": {
            "querysculptor": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://agent-query-builder-toolbox.vercel.app/mcp",
                    "--allow-http"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "querysculptor": {
            "querysculptor": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://agent-query-builder-toolbox.vercel.app/mcp",
                    "--allow-http"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "querysculptor": {
            "querysculptor": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://agent-query-builder-toolbox.vercel.app/mcp",
                    "--allow-http"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "querysculptor": {
            "querysculptor": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://agent-query-builder-toolbox.vercel.app/mcp",
                    "--allow-http"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "querysculptor": {
            "querysculptor": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://agent-query-builder-toolbox.vercel.app/mcp",
                    "--allow-http"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "querysculptor": {
            "querysculptor": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://agent-query-builder-toolbox.vercel.app/mcp",
                    "--allow-http"
                ]
            }
        }
    }
}

From the repository

Add the public demo endpoint to your Cursor mcp.json configuration. For local setup, clone the repository, run pnpm install, copy example.env to .env and customize, then launch with vercel dev. The server becomes available at http://localhost:3000/mcp.

`introspect-schema`

Retrieve the complete GraphQL schema definition for API understanding and exploration

`get-root-ops`

Discover the available root operation types (Query, Mutation, Subscription) and their entry points

`get-type-info`

Get detailed information about a specific GraphQL type including fields, descriptions, and relationships

`get-field-info`

Get detailed information about a specific field within a GraphQL type including arguments and return type

`get-input-help`

Get guidance and field information for GraphQL input object types to help with argument construction

`start-query-session`

Initialize a new GraphQL query building session with persistent state management

`end-query-session`

Clean up and close a GraphQL query building session to free resources

`get-current-query`

Visualize the current GraphQL query structure and generated query string for debugging and review

`get-selections`

Get suggestions for available fields that can be selected at a specific path in the query structure

`select-field`

Add a field to the GraphQL query structure with optional aliasing and validation

`select-multi-fields`

Add multiple fields to the GraphQL query structure in a single operation for efficiency

`set-query-variable`

Define a GraphQL variable with its type and optional default value for use in the query

`set-variable-value`

Assign a runtime value to a previously defined GraphQL variable for query execution

`rm-var`

Remove a previously defined GraphQL variable from the query structure

`set-string-argument`

Set string or enum arguments on GraphQL fields with automatic type detection and validation

`set-typed-argument`

Sets a typed argument (number, boolean, null) on a field in the GraphQL query structure.

`set-input-obj-arg`

Set nested properties within GraphQL input object arguments for complex data structures

`set-var-arg`

Set a field argument to reference a GraphQL variable instead of a literal value

`define-fragment`

Create reusable named fragments for common field selections across queries

`apply-fragment`

Apply a previously defined named fragment to a specific location in the query

`apply-inline-frag`

Apply type-conditional field selections using inline fragments for union/interface types

`set-field-directive`

Add GraphQL directives like @include or @skip to fields for conditional selection

`set-op-directive`

Add directives to the root operation for query-level behavior control

`validate-query`

Validate the built GraphQL query against the schema for syntax and semantic correctness

`execute-query`

Execute the built GraphQL query against the configured endpoint and return results

`analyze-query-complexity`

Analyze the complexity, depth, and performance characteristics of the current query structure

`get-rate-limit-status`

Get current rate limit status for the client

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "querysculptor": {
            "querysculptor": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://agent-query-builder-toolbox.vercel.app/mcp",
                    "--allow-http"
                ]
            }
        }
    }
}

McpServers

{
    "querysculptor": {
        "command": "npx",
        "args": [
            "mcp-remote",
            "https://agent-query-builder-toolbox.vercel.app/mcp",
            "--allow-http"
        ]
    }
}

⚒️ QuerySculptor

🚀 GraphQL for AI Agents

A server application that helps AI agents interact with GraphQL APIs through structured tools instead of raw query generation.

QuerySculptor provides 26 tools via the Model Context Protocol (MCP) that allow agents to build, validate, and execute GraphQL queries step-by-step rather than generating complete query strings.

🎪 Demo and Setup

🌍 Public Demo

MCP Endpoint: https://agent-query-builder-toolbox.vercel.app/mcp

The demo is pre-configured to use the Pokemon API for testing QuerySculptor features.

🎮 Demo: Pokemon API Examples

Our demo uses the Pokemon API - here's what you can ask:

Discover Pokemon:
- "Show me the first 10 Pokemon with their types and sprites"
- "Find all Pokemon that are both Fire and Flying type"
- "What are the stats for Charizard?"

Explore Abilities & Moves:
- "List all Pokemon abilities and their effects"
- "What moves can Pikachu learn?"
- "Show me all Electric-type moves with their power and accuracy"

Regional & Species Data:
- "List all Pokemon from the Kanto region"
- "Show me Pokemon species with their evolution chains"
- "What berries are available and what do they do?"

Complex Queries:
- "Find Pokemon with abilities that boost attack in a pinch"
- "Show me all legendary Pokemon with their types and base stats"
- "List Pokemon that can learn both Water and Ice moves"

Add to your Cursor mcp.json:

{

  "mcpServers": {

    "graphql-query-builder-demo": {

      "url": "https://agent-query-builder-toolbox.vercel.app/mcp"

    }

  }

}

🏃‍♂️ Local Setup

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

introspect-schema

get-root-ops

get-type-info

get-field-info

get-input-help

start-query-session

end-query-session

get-current-query

get-selections

select-field

select-multi-fields

set-query-variable

set-variable-value

rm-var

set-string-argument

set-typed-argument

set-input-obj-arg

set-var-arg

define-fragment

apply-fragment

apply-inline-frag

set-field-directive

set-op-directive

validate-query

execute-query

analyze-query-complexity

get-rate-limit-status

Claude Desktop / Cursor

McpServers

⚒️ QuerySculptor

🚀 GraphQL for AI Agents

🎪 Demo and Setup

🌍 Public Demo

🎮 Demo: Pokemon API Examples

🏃‍♂️ Local Setup

Install

More like this

Sequential Thinking

Aws Kb Retrieval Server

Filesystem

EverArt

Google Drive

Context 7

`introspect-schema`

`get-root-ops`

`get-type-info`

`get-field-info`

`get-input-help`

`start-query-session`

`end-query-session`

`get-current-query`

`get-selections`

`select-field`

`select-multi-fields`

`set-query-variable`

`set-variable-value`

`rm-var`

`set-string-argument`

`set-typed-argument`

`set-input-obj-arg`

`set-var-arg`

`define-fragment`

`apply-fragment`

`apply-inline-frag`

`set-field-directive`

`set-op-directive`

`validate-query`

`execute-query`

`analyze-query-complexity`

`get-rate-limit-status`