MCPサーバー

dochost-mcp

io.github.zyli5313/dochost-mcp

このMCPでできること

Publishes, updates, reads, manages, and deletes Markdown or HTML pages with shareable hosted links.

delete_page
Delete a dochost page
Permanently delete one of your pages by slug. The link stops working immediately and the slug is freed. Deleting an already-deleted page is a safe no-op.
破壊的操作あり 外部アクセスあり
入力スキーマ
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 64, 'minLength': 1}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'required': ['ok', 'slug'], 'properties': {'ok': {'type': 'boolean'}, 'slug': {'type': 'string'}, 'alreadyDeleted': {'type': 'boolean'}}}
get_account
Get my dochost account
Get your plan, page-quota usage, entitlement flags (size cap, custom slug, password, branding, subdomain, custom domain), and the primary host new links publish on. Call before publishing so you know your limits up front. The primary host is chosen in the dashboard (manageDomainsUrl), not through this API.
読み取り専用
入力スキーマ
{'type': 'object', 'properties': {}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'required': ['ok', 'plan'], 'properties': {'ok': {'type': 'boolean'}, 'plan': {'enum': ['free', 'pro', 'max'], 'type': 'string'}, 'password': {'type': 'boolean'}, 'analytics': {'enum': ['none', 'totals', 'full'], 'type': 'string'}, 'pageQuota': {'type': ['integer', 'null']}, 'pagesUsed': {'type': 'integer'}, 'sizeCapMb': {'type': 'integer'}, 'customSlug': {'type': 'boolean'}, 'noBranding': {'type': 'boolean'}, 'primaryHost': {'type': 'string', 'description': 'Host new links publish on: a custom domain, `{sub}.dochost.co`, or `dochost.co/d`.'}, 'customDomain': {'type': 'boolean', 'description': 'Whether this plan may point a hostname the user owns at their pages (set it at manageDomainsUrl).'}, 'pagesRemaining': {'type': ['integer', 'null']}, 'permanentLinks': {'type': 'boolean'}, 'customSubdomain': {'type': 'boolean', 'description': 'Whether this plan may claim a {name}.dochost.co subdomain (set it at manageDomainsUrl).'}, 'manageDomainsUrl': {'type': 'string', 'description': 'Dashboard page where the user adds domains and picks the primary one. Send them here to change it.'}}}
get_page
Get one of my dochost pages
Get one of your pages by slug: title, format, status, view/like counts, expiry, whether it is password-protected, and its current visibility / indexing / branding state. Never returns the page body or the password — call get_page_content when you need the source itself, and set_page_options to change any of the settings it reports.
読み取り専用
入力スキーマ
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 64, 'minLength': 1}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'required': ['ok', 'slug', 'url'], 'properties': {'ok': {'type': 'boolean'}, 'url': {'type': 'string'}, 'slug': {'type': 'string'}, 'likes': {'type': 'integer'}, 'title': {'type': ['string', 'null']}, 'views': {'type': 'integer'}, 'format': {'enum': ['markdown', 'html'], 'type': 'string'}, 'public': {'type': 'boolean'}, 'status': {'type': 'string'}, 'createdAt': {'type': 'string'}, 'expiresAt': {'type': ['string', 'null']}, 'permanent': {'type': 'boolean'}, 'searchable': {'type': 'boolean'}, 'hasPassword': {'type': 'boolean'}, 'brandingHidden': {'type': 'boolean', 'description': 'Whether the RENDERED page hides the dochost mark, resolved from the live plan â\x80\x94 not a per-page setting. Read-only.'}}}
get_page_content
Read one of my dochost pages
Read back the CURRENT Markdown or HTML of one of your pages. Call this before update_page whenever you did not write the live content yourself in this same conversation — update_page replaces the body wholesale, so editing from memory silently discards anything you cannot see, including edits the user made in the browser. Returns `version` and `sha256`; pass them to update_page as ifVersion / ifSha so the write is refused instead of overwriting a change you did not read. Expired pages are readable, and updating one republishes it on the same URL.
読み取り専用
入力スキーマ
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 64, 'minLength': 1}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'required': ['slug', 'url', 'format', 'status', 'version', 'bytes', 'body', 'editable'], 'properties': {'url': {'type': 'string'}, 'body': {'type': 'string', 'description': 'The raw Markdown or HTML exactly as published.'}, 'note': {'type': 'string', 'description': 'Present when the page is expired or under review. Relay it before editing.'}, 'slug': {'type': 'string'}, 'bytes': {'type': 'integer'}, 'title': {'type': ['string', 'null']}, 'format': {'enum': ['markdown', 'html'], 'type': 'string'}, 'sha256': {'type': ['string', 'null'], 'description': 'Pass to update_page as ifSha to guard the write.'}, 'status': {'type': 'string'}, 'version': {'type': 'integer', 'description': 'Pass to update_page as ifVersion to guard the write.'}, 'editable': {'type': 'boolean'}}, 'additionalProperties': False}
list_my_pages
List my dochost pages
List the pages you have published to dochost, newest first. Paginated; returns compact records (no page bodies).
読み取り専用
入力スキーマ
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1}, 'offset': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'required': ['pages', 'total', 'limit', 'offset', 'hasMore'], 'properties': {'limit': {'type': 'integer'}, 'pages': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'url', 'format', 'status'], 'properties': {'url': {'type': 'string'}, 'slug': {'type': 'string'}, 'likes': {'type': 'integer'}, 'title': {'type': ['string', 'null']}, 'views': {'type': 'integer'}, 'format': {'enum': ['markdown', 'html'], 'type': 'string'}, 'status': {'type': 'string'}, 'createdAt': {'type': 'string'}, 'expiresAt': {'type': ['string', 'null']}}}}, 'total': {'type': 'integer'}, 'offset': {'type': 'integer'}, 'hasMore': {'type': 'boolean'}}}
publish
Publish to dochost
Publish Markdown or HTML as a hosted dochost page and get a shareable URL. Respects your plan: link lifetime, password protection, custom slug, and branding all follow your account entitlements. Paid plans publish without dochost branding by default — pass noBranding: false to keep the mark. When the account cannot have an option you asked for, the publish still succeeds and the result carries ignoredOptions + ignoredNote — relay that instead of reporting plain success. The link is issued on the account's primary host (a custom domain or subdomain when one is set in Settings › Domains, otherwise dochost.co/d); get_account reports which.
外部アクセスあり
入力スキーマ
{'type': 'object', 'required': ['body'], 'properties': {'body': {'type': 'string', 'minLength': 1}, 'format': {'enum': ['markdown', 'html'], 'type': 'string'}, 'public': {'type': 'boolean'}, 'password': {'type': 'string'}, 'customSlug': {'type': 'string'}, 'noBranding': {'type': 'boolean'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'required': ['url', 'slug', 'format', 'permanent'], 'properties': {'url': {'type': 'string', 'description': "The shareable page URL, on the account's primary host (custom domain, subdomain, or dochost.co/d). Relay it verbatim."}, 'note': {'type': 'string', 'description': 'Free-tier only: expiry warning + upgrade link. Relay this to the user.'}, 'slug': {'type': 'string'}, 'format': {'enum': ['markdown', 'html'], 'type': 'string'}, 'expiresAt': {'type': ['string', 'null'], 'description': 'ISO timestamp, or null when the link is permanent.'}, 'permanent': {'type': 'boolean'}, 'ignoredNote': {'type': 'string', 'description': 'Plain-language consequence of ignoredOptions. Relay it instead of reporting plain success.'}, 'iterateHint': {'type': 'string', 'description': 'How to revise this page later. Follow it instead of publishing a second time.'}, 'ignoredOptions': {'type': 'array', 'items': {'enum': ['noBranding', 'password', 'customSlug', 'searchable'], 'type': 'string'}, 'description': 'Paid options this account does not have, which were dropped. Present only when non-empty â\x80\x94 the publish still succeeded, but NOT as asked.'}}, 'additionalProperties': False}
set_page_options
Change a published page’s settings
Change a published page's visibility, search-engine indexing or password WITHOUT republishing it — the URL, view count and content all stay the same. Use this instead of deleting and publishing again, which changes the link the user already shared. Send only the fields you want to change. Turning a paid capability off never needs an entitlement; turning one on is checked against the current plan. A password always forces the page private, so asking for both `public: true` and a password is refused rather than silently resolved. dochost branding is NOT settable here: it is resolved from the account's live plan at render time, so there is nothing per-page to flip — read `brandingHidden` from get_page for the rendered answer.
外部アクセスあり
入力スキーマ
{'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'public': {'type': 'boolean', 'description': 'Discoverable on Explore. Cannot be true while a password is set.'}, 'password': {'type': 'string', 'maxLength': 128, 'minLength': 1, 'description': 'Set or replace the page password (paid plans).'}, 'searchable': {'type': 'boolean', 'description': 'Opt in to search-engine indexing. Turning it on requires a permanent page.'}, 'removePassword': {'type': 'boolean', 'description': 'Clear the password. Always allowed, on any plan.'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'required': ['ok', 'slug'], 'properties': {'ok': {'type': 'boolean'}, 'url': {'type': 'string'}, 'slug': {'type': 'string'}, 'public': {'type': 'boolean'}, 'changed': {'type': 'boolean', 'description': 'False when the page already had exactly these settings.'}, 'searchable': {'type': 'boolean'}, 'hasPassword': {'type': 'boolean'}}}
update_page
Update a dochost page
Replace the content of one of your pages in place. The URL, view/like counts, and expiry stay the same; only the body, format, and title change. Resending identical content is a no-op. Prefer this over publishing again whenever the user is revising something you already published for them — a second publish creates a second link and strands the one they already shared. This replaces the WHOLE body, so unless you wrote the live content yourself in this conversation, call get_page_content first and pass its version/sha256 back as ifVersion/ifSha — the write is then refused with the current version instead of overwriting an edit you never saw.
破壊的操作あり 外部アクセスあり
入力スキーマ
{'type': 'object', 'required': ['slug', 'body'], 'properties': {'body': {'type': 'string', 'minLength': 1}, 'slug': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'ifSha': {'type': 'string', 'description': 'Write only if the live body still hashes to this (from get_page_content).'}, 'title': {'type': 'string', 'maxLength': 200}, 'format': {'enum': ['markdown', 'html'], 'type': 'string'}, 'ifVersion': {'type': 'integer', 'minimum': 1, 'description': 'Write only if the page is still at this version (from get_page_content). Omit and the write always wins.'}}, 'additionalProperties': False}
出力スキーマ
{'type': 'object', 'required': ['ok', 'slug'], 'properties': {'ok': {'type': 'boolean'}, 'slug': {'type': 'string'}, 'title': {'type': ['string', 'null']}, 'format': {'enum': ['markdown', 'html'], 'type': 'string'}, 'version': {'type': 'integer'}}}
追加
set_page_options
2026年9月21日2:57
変更
update_page
2026年9月21日2:57
追加
get_page_content
2026年9月21日2:57
変更
get_page
2026年9月21日2:57
変更
get_account
2026年9月21日2:57
変更
publish
2026年9月21日2:57
追加
delete_page
2026年9月17日12:53
追加
update_page
2026年9月17日12:53
追加
get_page
2026年9月17日12:53
追加
get_account
2026年9月17日12:53
追加
list_my_pages
2026年9月17日12:53
追加
publish
2026年9月17日12:53