shebang!

Tools reference

Every shebang-mcp tool, grouped by service, with its real arguments and which ones require confirm.

Tools reference

The local server registers 39 tools (38 always on, plus store_upload_file); the hosted server (see hosted MCP) registers the same 38 plus store_upload_content in place of store_upload_file — 40 distinct tool names between the two. Arguments marked ? are optional; everything else is required. confirm columns name the exact value the argument must equal — get it wrong and the tool throws client-side before any network call.

platform

HTTP routes: platform.

Tool Arguments Confirm
oauth_list_clients none
oauth_create_client name (string, 1-60), redirect_uris (string[], min 1), client_type? (confidential | public, default confidential)
project_create name (string, 1-60), tag (string, 1-24), color (enum, see below), slug (string, 3-30, ^[a-z0-9_]{3,30}$)
project_list none
project_get id (string)
project_set id (string), name?, tag?, color?, slug?, oauth_client_id? (string | null)
project_resources id (string)
project_delete id (string), confirm (string), move_to? (string, another project's slug) = id
project_assign id (string), resource_type (page | object | link | database | key), resource_id (string)
project_unassign id (string), resource_type (same enum), resource_id (string)
project_grant_key key_id (string), project (string, slug or id), level (read | full)
project_revoke_grant key_id (string), project (string, slug or id)
key_create_app name (string, 1-60), apps (array of page | serve | link | base, min 1), project? (string, slug)
key_list none
key_revoke keyId (string), confirm (string) = keyId
email_send to (string), subject (string, 1-200), text (string, 1-50,000)

project_create/project_set's color is a curated enum, not an arbitrary hex value — one of: #ef4444, #f97316, #f59e0b, #84cc16, #22c55e, #14b8a6, #06b6d4, #3b82f6, #6366f1, #8b5cf6, #a855f7, #ec4899.

sherpage

HTTP routes: sherpage.

Tool Arguments Confirm
sherpage_publish title (string, 1-200), slug?, access? (private | password | allow_list | public), entrypoint?, expiresAt? (ISO 8601), maxViews? (positive int), password?, allow? (string[]), files (array of `{path, content, encoding: "utf8" "base64"}, min 1), project?`
sherpage_update id (string), title? (string, 1-200), slug?, expiresAt? (string | null), maxViews? (positive int | null), project?
sherpage_list status? (active | archived), project?
sherpage_get id (string), project?
sherpage_set_access id (string), access (same enum as publish), password? (string | null), project?
sherpage_archive id (string), restore? (boolean), project?
sherpage_delete id (string), confirm (string), project? = id

sherserve

HTTP routes: sherserve.

Tool Arguments Confirm
store_upload_file (local only) path (string, local filesystem path), slug?, title?, access?, password?, expiresAt?, maxViews? (positive int), allow? (string[]), project?
store_upload_content (hosted only) path? (filename hint, no filesystem access), slug (string), contentBase64? | text? (exactly one required), contentType (string), title?, access?, password?, expiresAt?, maxViews? (positive int), allow?, project?
store_list_objects project?
store_get_object slug? | id? (one required), project?
store_delete_object slug? | id? (one required), confirm (string), project? = whichever of slug/id was passed

HTTP routes: sherlink.

Tool Arguments Confirm
link_list project?
link_get code_or_id (string), project?
link_set_access code_or_id (string), access?, password? (string | null), expires_at? (string | null), max_views? (positive int | null), project?
link_set_alias code_or_id (string), alias (string | null), project?
link_delete code_or_id (string), confirm (string), project? = code_or_id

sherbase

HTTP routes: sherbase.

Tool Arguments Confirm
base_list_databases project?
base_create_database slug (string), project?
base_run_sql database (string), sql (string, a single statement)
base_drop_database slug (string), confirm (string) = slug
base_rotate_secret database (string), confirm (string), project? = database
base_enable_api database (string), project?
base_reload_schema database (string), project?

Next

Troubleshooting — what the errors these tools raise actually mean.