Skip to main content
Glama
awictor

flow-agent-mcp

by awictor

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
FLOWCTL_PATHNoPath to a specific flowctl binary.
ESTUARY_DRY_RUNNoSet to 'true' to echo flowctl commands without executing them.
WEATHER_INGEST_URLNoIngest URL for the weather demo to push data to Estuary.
WEATHER_INGEST_TOKENNoToken for the weather demo ingest URL.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_tasksB

List catalog entities (captures, materializations, collections). Wraps flowctl catalog list.

task_statusB

Control-plane status for one task. Wraps flowctl catalog status <task> --output json. Status types include OK, WARNING, TASK_DISABLED, and error states.

task_statsB

Throughput and document counts for a task. Wraps flowctl raw stats --task <task> --since <since>.

task_logsB

Recent task logs, optionally filtered by level. Wraps flowctl logs --task <task> --since <since>.

task_healthA

End-to-end health check: combines status, throughput, and error-level logs in one call.

discover_bindingsA

Discover available bindings for a source connector. Writes a temporary flow.yaml and runs flowctl discover --source flow.yaml, returning the discovered spec without publishing.

create_captureA

Publish a capture. Writes the spec to a temporary flow.yaml and runs flowctl catalog publish --source flow.yaml --auto-approve.

create_materializationA

Publish a materialization. Writes the spec to a temporary flow.yaml and runs flowctl catalog publish --source flow.yaml --auto-approve.

pull_specsA

Pull a task's live spec for local inspection. Wraps flowctl catalog pull-specs --name <task>.

set_task_enabledA

Enable or disable a task by toggling shards.disable in its spec, then republishing. Disabling stops processing; re-enabling resumes from the last checkpoint with no data loss. After enabling, status reads WARNING for 30-120s while shards start, then OK.

restart_taskA

Force a connector restart: disable the task, then re-enable it. Resumes from the last checkpoint, so no data is lost. Use to clear transient errors or load updated config.

read_collectionA

Read documents from a collection to verify data is landing. Wraps flowctl collections read --collection <name>, which is non-blocking: it outputs everything currently available and exits.

generate_synthetic_dataA

Generate synthetic records for demo pipelines. Returns a sample plus the full payload size.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.6/5.0

Scored across 13 tools

Disambiguation4/5

Most tools have clearly distinct purposes: stats, logs, health, status, create, discover, etc. The health tool intentionally combines status and stats, but its description clearly delineates its role. Minor confusion is possible between task_status and task_health, but each serves a distinct need.

Naming Consistency3/5

Names mix noun-first patterns (task_stats, task_logs, task_health, task_status) with verb-first patterns (discover_bindings, create_capture, list_tasks). While all names use snake_case and are readable, the inconsistent prefix style makes the naming less predictable.

Tool Count5/5

13 tools is a well-scoped count for a Flow management server. It covers monitoring, lifecycle operations, discovery, and data verification without excessive overlap or unnecessary bloat.

Completeness3/5

The toolset covers monitoring, creation, enable/disable, restart, and inspection well. However, there is no explicit delete or general update operation beyond toggling enabled state, which is a notable gap for full task lifecycle management.

Maintenance

ActivityMaintained
ResponsivenessNo issues