CLI MCP & Tools

MCP is how Gestura grows beyond built-in capabilities. The CLI is the clearest place to add servers, choose scope, and confirm that a tool is actually reachable before you rely on it.

Add a server

gestura mcp add --name "local-files" --command "npx" --args "-y @modelcontextprotocol/server-filesystem /Users/me/Documents"

Start with one practical server and validate it before adding more complexity.

Validate connectivity

gestura mcp status

Run this after setup changes, provider changes, or when a workflow suddenly stops being able to access a known tool.

Think about scope first

User scope: good for tools you want available broadly.
Project scope: best for repo-specific servers or credentials.
Local scope: best for temporary experiments.

When a tool appears but does not work

Re-check the command, args, and working directory.
Confirm the server can run outside Gestura.
Verify the relevant provider keys or environment variables.
Run gestura config check to catch malformed related config.

← CLI Knowledge & Context

CLI Diagnostics →