Manage and invoke Model Context Protocol servers.

Synopsis

mcp <command> [args]

Description

Registers, lists, and calls tools on MCP (Model Context Protocol) servers, handling OAuth where required.

Options

add <url> <name> Register an MCP server. Runs OAuth if required.

list List configured MCP servers.

delete <name> Remove a server, its alias, sprinkles, and OAuth.

invoke <name> [tool] ... Call a tool through a configured server.

search <query> Find cached tools by name/description match.

refresh <name> Re-fetch tools/apps and AS metadata.

auth <name> Re-authenticate an MCP server (silent renewal, with an interactive popup fallback).

Examples

$ mcp add https://mcp.example.com/sse weather

Register an MCP server under the name 'weather'.

$ mcp invoke weather get-forecast --lat 51.5 --lon -0.12

Call a tool on a registered server.

$ mcp search forecast

Find cached tools matching 'forecast'.

Notes

'refresh' only reloads the tool catalog; use 'auth' when a token has actually expired.

See Also

oauth-token, oauth-domain, agent