MCP

flowly mcp commands

Complete reference for the flowly mcp command group. Changes take effect at the next agent boot — restart the gateway (flowly restart) or start a new session.

Discover & install

flowly mcp catalog — list the curated, version-pinned servers shipped with Flowly.
flowly mcp install <name> — install a catalog server. Prompts for any secret, probes the connection, enables it. OAuth entries point you at flowly mcp login next.
flowly mcp picker — interactive catalog browser; install with arrow keys.

Manage servers

flowly mcp add <name> … — add a custom server. --command (+ --arg/--env) for stdio, or --url (+ --header/--auth oauth) for HTTP/SSE.
flowly mcp list — table of configured servers (transport, tool filter, status).
flowly mcp test <name> — connect, list tools, disconnect. A health check.
flowly mcp configure <name> — interactively pick which of a server's tools are enabled.
flowly mcp enable / disable <name> — flip a server on or off without removing it.
flowly mcp remove <name> — delete a server (and its cached OAuth tokens).

bash

# stdio
flowly mcp add myfs --command npx -a -y -a @modelcontextprotocol/server-filesystem -a /tmp

# HTTP with a bearer header sourced from ~/.flowly/.env
flowly mcp add api --url https://x.example/mcp --header "Authorization: Bearer ${API_KEY}"

flowly mcp list
flowly mcp disable myfs
flowly mcp remove myfs

Auth

flowly mcp login <name> — run (or re-run) the OAuth 2.1 / PKCE browser flow for an OAuth server. Tokens are stored and auto-refreshed under ~/.flowly/mcp-tokens/.

Serve

flowly mcp serve — run Flowly as an MCP server on stdio (read-only).
flowly mcp serve --allow-writes — also expose send + approval tools (requires a running gateway).