MCP tools reference

The QueryLane MCP server offers 57 tools in QueryLane 1.0.94. An agent connected over MCP sees all of them. The built-in assistant uses the same tools, except the ones marked No in the Assistant column.

Every tool except querylane_profiles_list and querylane_connectors_list accepts an optional profileId. Without it, the tool works in the profile the server was started with (--profile in the client configuration).

What the effect column means

• Reads: looks at jobs, connections, schemas, runs, results or plugins and changes nothing.
• Changes: saves or deletes something: a job, a connection, run history, a stored query result or an export file.
• Executes: starts or stops work that reaches outside the profile: a database query, a step or job run, a connection test or a plugin tool.

The read tools querylane_jobs_export and querylane_chart_render accept an optional filePath and then also save a copy of their result to that file.

In the built-in assistant, a tool that changes or executes waits for your approval, and read tools cannot write files: their optional filePath argument is removed. See Assistant.

QueryLane does not ask for approval when an MCP client calls a tool. Your agent decides that with its own permission settings. See Connect your agent.

Profile and capabilities

Tool	What it does	Effect	Assistant
querylane_capabilities_get	Read the QueryLane agent API version, available operations, run scopes, execution policy, and the job authoring guide with step field contracts and ${variable}/${step_id} template rules	Reads	Yes
querylane_profiles_list	List QueryLane storage profiles available to this local client	Reads	No
querylane_packages_list	List packages installed for JavaScript pipeline steps	Reads	Yes

Connections

Tool	What it does	Effect	Assistant
querylane_connectors_list	List supported QueryLane connector variants, configuration fields, defaults, and adapter capabilities before creating a connection	Reads	Yes
querylane_connections_list	Find redacted source and target connections by name, role, or adapter type	Reads	Yes
querylane_connection_get	Read one redacted connection and its semantic revision before testing, updating, or deleting it	Reads	Yes
querylane_connection_validate	Validate a new connection document or a patch merged with a stored connection without connecting or saving	Reads	Yes
querylane_connection_test	Test a stored or unsaved connection using normal adapter semantics and return structured diagnostics without exposing credentials	Executes	Yes
querylane_connection_create	Create and atomically persist a validated source or target connection in the selected profile	Changes	Yes
querylane_connection_update	Atomically patch a connection when its semantic revision still matches; omitted secrets are preserved	Changes	Yes
querylane_connection_usage_get	List jobs, steps, outputs, saved queries, and workspace state that reference one connection	Reads	Yes
querylane_connection_delete	Delete a connection at an expected revision; referenced connections require force=true and return affected objects	Changes	Yes
querylane_connection_capabilities_get	Inspect adapter capabilities and optionally effective database privileges for one connection without returning credentials	Reads	Yes

Database

Tool	What it does	Effect	Assistant
querylane_schema_get	Read or refresh database schema metadata for one configured source or target connection	Reads	Yes
querylane_db_explorer_list	List databases, schemas, tables, collections, views, indexes, and other children through a stored connection	Reads	Yes
querylane_db_object_get	Read structured metadata and DDL details for one database object through a stored connection	Reads	Yes
querylane_db_query_execute	Execute arbitrary SQL or MongoDB code using the configured database user and return bounded rows plus an optional result reference	Executes	Yes
querylane_db_result_page	Read a bounded page from a large ad-hoc database query result reference	Reads	Yes
querylane_db_result_dispose	Release a stored ad-hoc database query result reference	Changes	No

Jobs and schedules

Tool	What it does	Effect	Assistant
querylane_jobs_list	Primary agent tool to find, search, list, or locate QueryLane jobs, tasks, and pipelines by natural-language terms	Reads	Yes
querylane_job_get	Read a redacted job definition and its content revision before editing or running it	Reads	Yes
querylane_job_create	Create and validate a complete QueryLane job in the selected profile	Changes	Yes
querylane_jobs_export	Export jobs to a portable package for sharing without git: steps, variables with secret values removed, connection hints without credentials, and required JavaScript packages	Reads	No
querylane_jobs_import	Import jobs from a package made by querylane_jobs_export	Changes	No
querylane_job_delete	Delete a local job, optionally asserting the revision previously read by the agent	Changes	Yes
querylane_job_revisions_list	List durable job revision snapshots available for inspection or revert	Reads	Yes
querylane_job_validate	Validate a stored job or an supplied candidate against step, dependency, and connection contracts	Reads	Yes
querylane_schedules_list	Read the schedules of the profile: their cron expression, whether macOS runs them, the next run, and why a schedule is not running	Reads	Yes

Job changes

Tool	What it does	Effect	Assistant
querylane_change_propose	Build an immutable semantic job change, validate it, and return its diff without changing the job	Reads	Yes
querylane_change_get	Read a proposed change, redacted candidate, semantic diff, validation, and application status	Reads	Yes
querylane_change_apply	Atomically apply an already validated change if the job revision still matches its base revision	Changes	Yes
querylane_change_revert	Restore a job to a known durable revision while checking the current revision	Changes	Yes

Steps, runs and results

Tool	What it does	Effect	Assistant
querylane_step_preview	Inspect a step and its resolved execution plan without executing database, HTTP, file, or JavaScript effects	Reads	Yes
querylane_step_test	Execute a step using normal QueryLane semantics, including dependencies by default, and optionally wait for completion	Executes	Yes
querylane_runs_list	List unified durable UI, CLI, MCP, and scheduled pipeline executions and filter them by job, origin, or status	Reads	Yes
querylane_run_get	Read the current durable state and receipt of one pipeline run	Reads	Yes
querylane_run_diagnose	Return a compact deterministic diagnosis with failed step, reason code, details, statuses, and result handle	Reads	Yes
querylane_run_plan	Resolve which steps and connections a requested run scope will execute and whether a baseline is required	Reads	Yes
querylane_run_start	Start a durable asynchronous pipeline run with normal local-client execution permissions	Executes	Yes
querylane_run_wait	Wait for a durable run to finish or until a bounded timeout expires	Reads	Yes
querylane_run_cancel	Request cancellation of a queued or running local pipeline execution	Executes	Yes
querylane_runs_clear	Clear durable execution history for one job or the selected profile	Changes	No
querylane_result_sample	Read a bounded sample from the final output or a selected step output of a durable run	Reads	Yes
querylane_result_check	Evaluate declarative row-count, field-presence, or non-null assertions against a run result	Reads	Yes
querylane_chart_render	Render one chart of a chart step from a finished run to PNG (returned as an image you can look at) or SVG, to check the drawing after querylane_step_test or querylane_run_wait	Reads	Yes
querylane_run_artifact_get	Read an image a run left behind, such as the screenshot of a failed plugin step	Reads	Yes

Data exports

Tool	What it does	Effect	Assistant
querylane_exports_list	List durable data export operations and filter them by status, connection, or pipeline run	Reads	Yes
querylane_export_start	Export exactly one source—database object, query result reference, pipeline run result, step result, or supplied rows—to CSV, JSON, JSONL, or XLSX	Changes	Yes
querylane_export_get	Read current status, progress, output metadata, or structured failure for one export	Reads	Yes
querylane_export_wait	Wait for a durable export to finish or until a bounded timeout expires	Reads	Yes
querylane_export_cancel	Cancel a queued or running data export and remove its incomplete atomic output	Changes	No

Plugins

Tool	What it does	Effect	Assistant
querylane_plugins_list	List installed QueryLane plugins and plugins available in the catalog, with their status (ready, needsPrepare, disabled, available)	Reads	Yes
querylane_plugin_get	Read one installed plugin: its step types and code language, settings schema, the profile presets, the AI tools it offers and its authoring guide for writing step code	Reads	Yes
querylane_plugin_tool_call	Call an AI tool of an installed plugin, for example open a page and look at it with the browser plugin	Executes	Yes
querylane_plugin_session_close	Close a plugin tool session and release its resources, such as an open browser page	Reads	Yes

Desktop app

Tool	What it does	Effect	Assistant
querylane_ui_link_get	Create a querylane:// link that opens a job, exact step, connection, or settings section in the QueryLane desktop app	Reads	No
querylane_ui_open	Open and navigate the QueryLane desktop app directly to a job, exact pipeline step, connection, or settings section	Reads	Yes