Release a public Marketplace package or privately share one with selected workspaces.
Publish the package and the manifest together. The package contains executable code; the Hub stores immutable manifest versions, catalog metadata, ownership, install counts, and access grants.
Keep HUB_PUBLISH_KEY in CI/deployment secrets. Do not put it in the package, its example environment file, or a client application. The Hub records the publisher from the manifest author and prevents a different publisher from taking the same tool id.
Private means the Hub hides a tool from browse and search unless a workspace has been granted access. It is not a substitute for protecting a public npm tarball: use a private package registry or a signed package delivery mechanism as well.Set this in the manifest before publishing a new version:
{ "distribution": "private" }
Then issue a scoped invite key for the recipient. The plaintext key is returned once; the Hub stores only its hash.
After redemption, that workspace can discover and install the private tool. Revoke a key to stop new redemptions; revoke the workspace grant separately if existing access must end.
The Marketplace catalog uses the manifest’s name, icon/emoji, description, tags, author, version, pricing, installSize, runtime modes, and install count. Install count is available today; popularity rankings and stars require a separate catalog-ranking and feedback feature, so do not present them as current metrics.For a first-party or shared repository tool, add a companion page at:
docs/marketplace/tools/<tool-id>.mdx
Then add it under the Marketplace tab in docs/docs.json. Cover what the tool does, runtime choices, required user credentials, retention/deletion behavior, rate limits/quotas, pricing or entitlement model, and how to uninstall it. Keep the package README.md as the portable reference included with the package itself.
Use billing to declare meters such as source-minute, api-call, or seat, and enforce an entitlement inside the runtime. The Marketplace does not require a payment provider in the tool package. When billing is added, the entitlement service should authorize install/access and update the runtime entitlement; the tool’s action, UI, and runtime protocol stay unchanged.
Marketplace distribution controls discovery and Hub grants. It does not authorize a third-party
API on its own. Your runtime must still authenticate requests, validate the entitlement, and
enforce its own rate and quota limits.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Larkup","colors":{"primary":"#000000","light":"#000000","dark":"#222222"},"logo":{"light":"https://mintcdn.com/larkup/J0lnyYIE7T-PEajl/documentation/logo/logo-light2.png?fit=max\u0026auto=format\u0026n=J0lnyYIE7T-PEajl\u0026q=85\u0026s=a8d0f36de4d9d0698e8a6ee73e6bf1aa","dark":"https://mintcdn.com/larkup/J0lnyYIE7T-PEajl/documentation/logo/logo-dark2.png?fit=max\u0026auto=format\u0026n=J0lnyYIE7T-PEajl\u0026q=85\u0026s=fa0405df7faa06592472499c015d828c"},"favicon":"https://mintcdn.com/larkup/J0lnyYIE7T-PEajl/documentation/images/favicon.ico?fit=max\u0026auto=format\u0026n=J0lnyYIE7T-PEajl\u0026q=85\u0026s=feef65be53c3a3fe73a8289e38d3fd83","background":{"color":{"light":"#F9FAFB","dark":"#0F1117"}},"navbar":{"links":[{"href":"mailto:abdelrahmanaboneda@gmail.com","label":"Support"}],"primary":{"type":"button","label":"GitHub","href":"https://github.com/Larkup-AI/larkup"}},"footer":{"socials":{"github":"https://github.com/Larkup-AI/larkup"}},"contextual":{"options":["copy"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"larkup","hasAudioNarration":false,"actualSubdomain":"larkup","customDomains":["larkup.de"],"gitSource":{"type":"github","owner":"larkup-ai","repo":"larkup","deployBranch":"main","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"chroma":{"collectionId":"41ed47f6-9e92-488c-bf50-0a09ec845389","liveDeploymentHistoryId":"6ad54ec7cfe0d5be20f803dd","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad54ec7cfe0d5be20f803dd"},"entitlements":{},"buildId":"6ad54ec7cfe0d5be20f803dd","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Documentation","count":13},{"language":"default","tag":"API Reference","count":11},{"language":"default","tag":"Use Cases","count":6},{"language":"default","tag":"Documents","count":5},{"language":"default","tag":"Getting Started","count":5},{"language":"default","tag":"Marketplace","count":5},{"language":"default","tag":"SDK","count":5},{"language":"default","tag":"Developer Guide","count":4},{"language":"default","tag":"Querying","count":2},{"language":"default","tag":"Overview","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/documentation","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"documentation/style.css","content":""}],"page":{"pagePath":"documentation/marketplace/publishing-tools","slug":"/documentation/marketplace/publishing-tools","pageMetadata":{"title":"Publish and share tools","description":"Release a public Marketplace package or privately share one with selected workspaces.","icon":"rocket","href":"/documentation/marketplace/publishing-tools"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Release a public Marketplace package or privately share one with selected workspaces.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Publish the package and the manifest together. The package contains executable code; the Hub stores immutable manifest versions, catalog metadata, ownership, install counts, and access grants.`}),`\n`,_jsx(Heading,{level:`2`,id:`public-release`,children:`Public release`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Build, test, and publish the package to the registry named by `,_jsx(_components.code,{children:`packageName`}),`.`]}),`\n`,_jsx(_components.li,{children:`Bump the package and manifest version together. A published Hub version is immutable.`}),`\n`,_jsxs(_components.li,{children:[`Set `,_jsx(_components.code,{children:`\"distribution\": \"public\"`}),` (or omit it; public is the default).`]}),`\n`,_jsx(_components.li,{children:`Publish the manifest from CI using the Hub publish secret.`}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --fail-with-body`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$LARKUP_HUB_URL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/v1/tools/publish\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"$(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`jq`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -n`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --arg`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` key \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$HUB_PUBLISH_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\" `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`--slurpfile`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` manifest tool.manifest.json `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{apiKey: $key, manifest: $manifest[0]}')\"`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Keep `,_jsx(_components.code,{children:`HUB_PUBLISH_KEY`}),` in CI/deployment secrets. Do not put it in the package, its example environment file, or a client application. The Hub records the publisher from the manifest author and prevents a different publisher from taking the same tool id.`]}),`\n`,_jsx(Heading,{level:`2`,id:`private-distribution`,children:`Private distribution`}),`\n`,_jsx(_components.p,{children:`Private means the Hub hides a tool from browse and search unless a workspace has been granted access. It is not a substitute for protecting a public npm tarball: use a private package registry or a signed package delivery mechanism as well.`}),`\n`,_jsx(_components.p,{children:`Set this in the manifest before publishing a new version:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{ `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"distribution\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"private\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Then issue a scoped invite key for the recipient. The plaintext key is returned once; the Hub stores only its hash.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --fail-with-body`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$LARKUP_HUB_URL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/v1/tools/acme-translator/access-keys\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-hub-admin-key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$HUB_PUBLISH_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"scope\":\"workspace\",\"scopeId\":\"workspace_123\",\"maxInstalls\":5,\"createdBy\":\"acme-release\"}'`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`The recipient redeems the key for their workspace:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --fail-with-body`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$LARKUP_HUB_URL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/v1/tools/acme-translator/redeem-key\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"accessKey\":\"lk_key_…\",\"workspaceId\":\"workspace_123\"}'`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`After redemption, that workspace can discover and install the private tool. Revoke a key to stop new redemptions; revoke the workspace grant separately if existing access must end.`}),`\n`,_jsx(Heading,{level:`2`,id:`marketplace-listing-and-documentation`,children:`Marketplace listing and documentation`}),`\n`,_jsxs(_components.p,{children:[`The Marketplace catalog uses the manifest’s name, icon/emoji, description, tags, author, version, pricing, `,_jsx(_components.code,{children:`installSize`}),`, runtime modes, and install count. Install count is available today; popularity rankings and stars require a separate catalog-ranking and feedback feature, so do not present them as current metrics.`]}),`\n`,_jsx(_components.p,{children:`For a first-party or shared repository tool, add a companion page at:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`docs/marketplace/tools/\u003ctool-id>.mdx`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`Then add it under the `,_jsx(_components.strong,{children:`Marketplace`}),` tab in `,_jsx(_components.code,{children:`docs/docs.json`}),`. Cover what the tool does, runtime choices, required user credentials, retention/deletion behavior, rate limits/quotas, pricing or entitlement model, and how to uninstall it. Keep the package `,_jsx(_components.code,{children:`README.md`}),` as the portable reference included with the package itself.`]}),`\n`,_jsx(Heading,{level:`2`,id:`selling-a-tool-later`,children:`Selling a tool later`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`billing`}),` to declare meters such as `,_jsx(_components.code,{children:`source-minute`}),`, `,_jsx(_components.code,{children:`api-call`}),`, or `,_jsx(_components.code,{children:`seat`}),`, and enforce an entitlement inside the runtime. The Marketplace does not require a payment provider in the tool package. When billing is added, the entitlement service should authorize install/access and update the runtime entitlement; the tool’s action, UI, and runtime protocol stay unchanged.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Marketplace distribution controls discovery and Hub grants. It does not authorize a third-party\nAPI on its own. Your runtime must still authenticate requests, validate the entitlement, and\nenforce its own rate and quota limits.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Publish and share tools","description":"Release a public Marketplace package or privately share one with selected workspaces.","icon":"rocket","href":"/documentation/marketplace/publishing-tools"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Public release","slug":"public-release","depth":2,"children":[]},{"title":"Private distribution","slug":"private-distribution","depth":2,"children":[]},{"title":"Marketplace listing and documentation","slug":"marketplace-listing-and-documentation","depth":2,"children":[]},{"title":"Selling a tool later","slug":"selling-a-tool-later","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"larkup","siteName":"Larkup","title":"Publish and share tools - Larkup","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-03T12:34:35.084Z","originalFileLocation":"documentation/marketplace/publishing-tools.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Release a public Marketplace package or privately share one with selected workspaces.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Larkup\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/larkup/O-SbaNQDkZFAZqod/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/larkup/O-SbaNQDkZFAZqod/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/larkup/O-SbaNQDkZFAZqod/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/larkup/O-SbaNQDkZFAZqod/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/larkup/O-SbaNQDkZFAZqod/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/larkup/O-SbaNQDkZFAZqod/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/larkup/O-SbaNQDkZFAZqod/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/larkup/O-SbaNQDkZFAZqod/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/larkup/O-SbaNQDkZFAZqod/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Publish and share tools - Larkup\">\u003cmeta data-mint-head property=\"og:description\" content=\"Release a public Marketplace package or privately share one with selected workspaces.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Larkup\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://larkup.de/documentation/marketplace/publishing-tools\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://larkup.mintlify.app/_mintlify/api/og/v2?division=Tool+Authors\u0026amp;title=Publish+and+share+tools\u0026amp;description=Release+a+public+Marketplace+package+or+privately+share+one+with+selected+workspaces.\u0026amp;theme=bde185ca85eb94a198a8ed1e\u0026amp;signature=811441a95d36e08b1695f0667442a8a53be28905bf1f9c4ca71a82f9747b3af6\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Publish and share tools - Larkup\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Release a public Marketplace package or privately share one with selected workspaces.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://larkup.mintlify.app/_mintlify/api/og/v2?division=Tool+Authors\u0026amp;title=Publish+and+share+tools\u0026amp;description=Release+a+public+Marketplace+package+or+privately+share+one+with+selected+workspaces.\u0026amp;theme=bde185ca85eb94a198a8ed1e\u0026amp;signature=811441a95d36e08b1695f0667442a8a53be28905bf1f9c4ca71a82f9747b3af6\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/larkup/O-SbaNQDkZFAZqod/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Larkup\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://larkup.de/documentation/marketplace/publishing-tools\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/documentation/marketplace/publishing-tools.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://larkup.de/#organization\",\"name\":\"Larkup\",\"url\":\"https://larkup.de\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/larkup/J0lnyYIE7T-PEajl/documentation/logo/logo-light2.png?fit=max\u0026auto=format\u0026n=J0lnyYIE7T-PEajl\u0026q=85\u0026s=a8d0f36de4d9d0698e8a6ee73e6bf1aa\"}},{\"@type\":\"WebSite\",\"@id\":\"https://larkup.de#website\",\"name\":\"Larkup\",\"url\":\"https://larkup.de\",\"publisher\":{\"@id\":\"https://larkup.de/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://larkup.de/documentation/marketplace/publishing-tools#webpage\",\"url\":\"https://larkup.de/documentation/marketplace/publishing-tools\",\"name\":\"Publish and share tools\",\"description\":\"Release a public Marketplace package or privately share one with selected workspaces.\",\"dateModified\":\"2026-09-03T12:34:35.084Z\",\"isPartOf\":{\"@id\":\"https://larkup.de#website\"},\"breadcrumb\":{\"@id\":\"https://larkup.de/documentation/marketplace/publishing-tools#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://larkup.de/documentation/marketplace/publishing-tools#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tool Authors\",\"item\":\"https://larkup.de/documentation/marketplace/creating-tools\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Publish and share tools\",\"item\":\"https://larkup.de/documentation/marketplace/publishing-tools\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://larkup.de/documentation/marketplace/publishing-tools#article\",\"headline\":\"Publish and share tools\",\"name\":\"Publish and share tools\",\"description\":\"Release a public Marketplace package or privately share one with selected workspaces.\",\"url\":\"https://larkup.de/documentation/marketplace/publishing-tools\",\"mainEntityOfPage\":{\"@id\":\"https://larkup.de/documentation/marketplace/publishing-tools#webpage\"},\"dateModified\":\"2026-09-03T12:34:35.084Z\",\"publisher\":{\"@id\":\"https://larkup.de/#organization\"},\"isPartOf\":{\"@id\":\"https://larkup.de#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Larkup\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Larkup","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/documentation"}]},{"tab":"Marketplace","groups":[{"group":"Getting Started","pages":[{"title":"Marketplace","icon":"store","href":"/documentation/marketplace/overview"},{"title":"Installing tools","icon":"download","href":"/documentation/marketplace/installing-tools"}]},{"group":"Tool Authors","pages":[{"title":"Create a portable tool","description":"Build a Marketplace tool with its own logic, chat actions, settings, runtime, and UI surfaces.","icon":"hammer","href":"/documentation/marketplace/creating-tools"},{"title":"Publish and share tools","icon":"rocket","href":"/documentation/marketplace/publishing-tools"}]},{"group":"Media Tools","pages":[{"title":"Video Intelligence","description":"Index video into timestamped evidence for accurate chat answers.","icon":"video","href":"/documentation/marketplace/tools/video-intelligence"}]}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/documentation/sdk/overview"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/documentation/api-reference/overview"}]}]},"title":"Publish and share tools - Larkup","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":[],"chunks":[]}
