{"serverInfo":{"name":"binhtml","title":"BinHTML","version":"0.1.0","description":"Publish AI-generated HTML artifacts and project share links from MCP clients to secure BinHTML URLs."},"description":"BinHTML turns agent-generated HTML into sandboxed, shareable artifact links and Pro project share links.","homepage":"https://binhtml.com","links":{"docs":"https://binhtml.com/docs/mcp","apiDocs":"https://binhtml.com/docs/api","openapi":"https://binhtml.com/openapi.json","pricing":"https://binhtml.com/pricing","changelog":"https://binhtml.com/changelog"},"icon":"https://binhtml.com/logo.png","logo":"https://binhtml.com/logo-wordmark.png","contact":{"name":"BinHTML","email":"hello@binhtml.com","url":"https://binhtml.com"},"categories":["developer-tools","publishing","ai-artifacts"],"tags":["html","artifact-hosting","mcp","openapi","project-share-links"],"endpoint":"https://binhtml.com/mcp","transport":{"type":"streamable-http","endpoint":"https://binhtml.com/mcp","methods":["POST","OPTIONS"],"protocolVersion":"2025-06-18","description":"BinHTML supports request/response Streamable HTTP over POST. It does not currently provide resumable streams or server-initiated SSE responses."},"capabilities":{"tools":{"listChanged":false}},"authentication":{"required":true,"schemes":["bearer"],"description":"Use a BinHTML API key in the Authorization header as Bearer <key>.","configSchema":{"type":"object","required":["binhtmlApiKey"],"additionalProperties":false,"properties":{"binhtmlApiKey":{"type":"string","title":"BinHTML API key","description":"Create an API key in BinHTML settings. Smithery forwards it in the Authorization header; BinHTML also accepts standard Bearer headers.","minLength":20,"format":"password","writeOnly":true,"x-from":{"header":"binhtml-api-key"},"x-to":{"header":"Authorization"}}}}},"tools":[{"name":"publish_html","title":"Publish HTML to BinHTML","description":"Publish generated HTML to BinHTML, or update an existing artifact when artifactId is provided, and return sandboxed share, management, and source download URLs.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"inputSchema":{"type":"object","required":["sourceHtml"],"properties":{"apiKey":{"type":"string","description":"Fallback authentication value for clients that cannot send headers. Prefer Authorization: Bearer <BinHTML API key>."},"artifactId":{"type":"string","description":"Existing artifact ID to update. When provided, BinHTML uploads a new current version instead of creating a new share link."},"title":{"type":"string","maxLength":120,"description":"Display title for a new artifact. Required when artifactId is omitted."},"description":{"type":"string","description":"Optional short summary for a new artifact. Used in BinHTML management surfaces."},"projectName":{"type":"string","maxLength":80,"description":"Optional project name for grouping a new artifact with related agent outputs. Ignored for version updates."},"sourceHtml":{"type":"string","description":"Complete HTML document to publish. Must include <!doctype html> or an <html> tag and fit within the current size limit."},"label":{"type":"string","description":"Optional label for the uploaded version. Most useful when artifactId is provided."},"visibility":{"type":"string","enum":["private","unlisted"],"default":"unlisted","description":"Share visibility for a new artifact. Use unlisted for anyone-with-link sharing or private for owner-only access."},"expiresAt":{"type":"string","format":"date-time","description":"Optional future ISO timestamp for link expiry. Leave blank for no expiry."}}},"outputSchema":{"type":"object","required":["artifact","version","urls"],"properties":{"operation":{"type":"string","enum":["updated"],"description":"Present when publish_html uploaded a new version for an existing artifact."},"artifact":{"type":"object","required":["id","slug","title","visibility","expiresAt","createdAt","project"],"properties":{"id":{"type":"string","description":"Stable BinHTML artifact ID."},"slug":{"type":"string","description":"Share-link slug."},"title":{"type":"string","description":"Artifact title."},"visibility":{"type":"string","enum":["private","unlisted"],"description":"Current share visibility."},"expiresAt":{"type":["string","null"],"description":"Expiry timestamp, or null when no expiry is set."},"createdAt":{"type":"string","description":"Artifact creation timestamp."},"project":{"type":["object","null"],"required":["id","name","slug"],"properties":{"id":{"type":"string","description":"Project ID."},"name":{"type":"string","description":"Project display name."},"slug":{"type":"string","description":"Owner-scoped project slug."}},"description":"Project metadata when the artifact is grouped, or null."}}},"version":{"type":"object","required":["number","sizeBytes","renderMode"],"properties":{"number":{"type":"number","description":"Current artifact version number."},"sizeBytes":{"type":"number","description":"Published HTML source size in bytes."},"renderMode":{"type":"string","description":"Rendering mode used by BinHTML."}}},"urls":{"type":"object","required":["share","management","sourceDownload"],"properties":{"share":{"type":"string","description":"Share URL for unlisted links or owner-only private links."},"management":{"type":"string","description":"Authenticated dashboard URL for the artifact."},"sourceDownload":{"type":"string","description":"Authenticated source download URL."}}}}}},{"name":"publish_project","title":"Publish a BinHTML project","description":"Publish multiple generated HTML artifacts into one BinHTML project and return a single unlisted project share URL.","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"inputSchema":{"type":"object","required":["projectName","artifacts"],"additionalProperties":false,"properties":{"apiKey":{"type":"string","description":"Fallback authentication value for clients that cannot send headers. Prefer Authorization: Bearer <BinHTML API key>."},"projectName":{"type":"string","maxLength":80,"description":"Project name to create or reuse for the published HTML artifacts."},"artifacts":{"type":"array","minItems":1,"maxItems":20,"description":"HTML artifacts to publish into the project. Each item must include a title and complete HTML document.","items":{"type":"object","required":["title","sourceHtml"],"additionalProperties":false,"properties":{"title":{"type":"string","maxLength":120,"description":"Display title for this artifact."},"description":{"type":"string","description":"Optional short summary shown in BinHTML management surfaces."},"sourceHtml":{"type":"string","description":"Complete HTML document to publish. Must include <!doctype html> or an <html> tag."},"visibility":{"type":"string","enum":["unlisted"],"default":"unlisted","description":"Project share links include unlisted artifacts only."},"expiresAt":{"type":"string","format":"date-time","description":"Optional future ISO timestamp for this artifact's link expiry."}}}},"expiresAt":{"type":"string","format":"date-time","description":"Deprecated alias for projectShareExpiresAt."},"projectShareExpiresAt":{"type":"string","format":"date-time","description":"Optional future ISO timestamp for the project share link expiry."}}},"outputSchema":{"type":"object","required":["project","share","artifacts","urls"],"properties":{"project":{"type":"object","required":["id","name","slug"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"}}},"share":{"type":"object","required":["enabled","slug","expiresAt","createdAt","updatedAt"],"properties":{"enabled":{"type":"boolean"},"slug":{"type":["string","null"]},"expiresAt":{"type":["string","null"]},"createdAt":{"type":["string","null"]},"updatedAt":{"type":["string","null"]}}},"artifacts":{"type":"array","items":{"type":"object","required":["id","slug","title","visibility","expiresAt","createdAt","project","version","urls"]}},"urls":{"type":"object","required":["projectShare"],"properties":{"projectShare":{"type":"string","description":"One share URL for the BinHTML project index."}}}}}}],"resources":[],"prompts":[]}