{"openapi":"3.1.0","info":{"title":"Shortcutkey API","version":"0.1.0","description":"A hand-curated reference of well-known, cross-platform keyboard-shortcut conventions across 9 generic software categories, plus a computed Windows<->Mac shortcut-notation converter.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://shortcutkey.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/shortcutkey/docs"},"termsOfService":"https://connectorbay.com/shortcutkey/terms"},"servers":[{"url":"https://shortcutkey.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/shortcutkey/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/shortcuts_by_category":{"post":{"operationId":"shortcuts_by_category","summary":"Every shortcut in one generic software category. Use for \"what are all the web browser shortcuts\".","description":"Every shortcut in one generic software category. Use for \"what are all the web browser shortcuts\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"A category name — see category_list.","examples":["web browser","code editor"],"title":"Category","type":"string"}},"required":["category"],"title":"shortcuts_by_categoryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/category_list":{"post":{"operationId":"category_list","summary":"Every supported category with how many shortcuts it has. Use for \"what categories do you cover\".","description":"Every supported category with how many shortcuts it has. Use for \"what categories do you cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"category_listArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_shortcuts":{"post":{"operationId":"search_shortcuts","summary":"Keyword search across every shortcut's action, category and notes. Use for \"any shortcut for zoom\".","description":"Keyword search across every shortcut's action, category and notes. Use for \"any shortcut for zoom\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Keyword to search for.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"search_shortcutsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/shortcut_for_action":{"post":{"operationId":"shortcut_for_action","summary":"Look up an action's shortcut(s) across categories, optionally filtered to one platform. Use for \"how do I","description":"Look up an action's shortcut(s) across categories, optionally filtered to one platform. Use for \"how do I\n    select all\", \"what's the Mac shortcut for redo\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"action":{"description":"The action to look up.","examples":["copy","find and replace"],"minLength":1,"title":"Action","type":"string"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"windows | mac, to filter to one platform's keys.","title":"Platform"}},"required":["action"],"title":"shortcut_for_actionArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/platform_diff":{"post":{"operationId":"platform_diff","summary":"Windows and Mac keys for an action, side by side. Use for \"what's the Mac equivalent of Ctrl+Shift+T\".","description":"Windows and Mac keys for an action, side by side. Use for \"what's the Mac equivalent of Ctrl+Shift+T\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"action":{"description":"The action to compare across platforms.","minLength":1,"title":"Action","type":"string"}},"required":["action"],"title":"platform_diffArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/convert_shortcut_to_mac":{"post":{"operationId":"convert_shortcut_to_mac","summary":"Computed modifier-key substitution converting a Windows-style shortcut string to its Mac notation","description":"Computed modifier-key substitution converting a Windows-style shortcut string to its Mac notation\n    (Ctrl->Cmd, Alt->Option, Enter->Return). Use for \"convert Ctrl+Shift+T to Mac\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"shortcut":{"description":"A Windows-style shortcut, e.g. 'Ctrl+Shift+T'.","minLength":1,"title":"Shortcut","type":"string"}},"required":["shortcut"],"title":"convert_shortcut_to_macArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/convert_shortcut_to_windows":{"post":{"operationId":"convert_shortcut_to_windows","summary":"Computed modifier-key substitution converting a Mac-style shortcut string to its Windows notation (Cmd->","description":"Computed modifier-key substitution converting a Mac-style shortcut string to its Windows notation (Cmd->\n    Ctrl, Option->Alt, Return->Enter). Use for \"convert Cmd+Option+Esc to Windows\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"shortcut":{"description":"A Mac-style shortcut, e.g. 'Cmd+Shift+T'.","minLength":1,"title":"Shortcut","type":"string"}},"required":["shortcut"],"title":"convert_shortcut_to_windowsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/beginner_shortcuts":{"post":{"operationId":"beginner_shortcuts","summary":"The handful of shortcuts most worth learning first, overall or in one category. Use for \"what shortcuts","description":"The handful of shortcuts most worth learning first, overall or in one category. Use for \"what shortcuts\n    should I learn first\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Limit to one category; omit for the cross-category essentials.","title":"Category"}},"title":"beginner_shortcutsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/shortcut_glossary":{"post":{"operationId":"shortcut_glossary","summary":"Definitions of modifier-key terms — Ctrl, Cmd, Option, Meta, chord, Fn key. Use for \"what does chord mean","description":"Definitions of modifier-key terms — Ctrl, Cmd, Option, Meta, chord, Fn key. Use for \"what does chord mean\n    in keyboard shortcuts\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"shortcut_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/random_shortcut_tip":{"post":{"operationId":"random_shortcut_tip","summary":"A useful, less-obvious shortcut you might not know. Use for \"give me a shortcut tip\".","description":"A useful, less-obvious shortcut you might not know. Use for \"give me a shortcut tip\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Limit the tip to one category.","title":"Category"}},"title":"random_shortcut_tipArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}