mkdshare.DEV

List all mkdshare.DEV documents owned by or shared with the authenticated user.

{
  "type": "object",
  "properties": {},
  "required": []
}

Read the full markdown content of a document by its slug.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "8-character document slug from the URL"
    }
  },
  "required": [
    "slug"
  ]
}

Create a new mkdshare.DEV document. If visibility is omitted the document is owner-only (login_required, restricted to your email).

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Document title"
    },
    "content": {
      "type": "string",
      "description": "Markdown content"
    },
    "visibility": {
      "type": "string",
      "enum": [
        "public",
        "login_required",
        "domain_restricted"
      ],
      "description": "Who can view the document. If the user didn't specify who should see it, ask them. Omitted = owner-only (login_required, restricted to your email)."
    },
    "allowed_emails": {
      "type": "string",
      "description": "Comma-separated emails allowed to view (login_required visibility)"
    },
    "allowed_domain": {
      "type": "string",
      "description": "Domain allowed to view, e.g. company.com (domain_restricted visibility)"
    },
    "domain_can_edit": {
      "type": "boolean",
      "description": "When true, all users in allowed_domain can edit (not just view)"
    },
    "editor_emails": {
      "type": "string",
      "description": "Comma-separated emails that can edit this document (in addition to the owner)"
    },
    "expires_at": {
      "type": "string",
      "description": "ISO 8601 datetime after which the document expires, e.g. 2026-06-01T00:00:00Z"
    }
  },
  "required": [
    "title",
    "content"
  ]
}

Update an existing document you own. Omit any field to keep its current value.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Document slug"
    },
    "title": {
      "type": "string",
      "description": "New title"
    },
    "content": {
      "type": "string",
      "description": "New markdown content"
    },
    "visibility": {
      "type": "string",
      "enum": [
        "public",
        "login_required",
        "domain_restricted"
      ],
      "description": "New visibility level"
    },
    "allowed_emails": {
      "type": "string",
      "description": "Comma-separated emails allowed to view; pass empty string to clear"
    },
    "allowed_domain": {
      "type": "string",
      "description": "Domain allowed to view, e.g. company.com; required for domain_restricted"
    },
    "domain_can_edit": {
      "type": "boolean",
      "description": "When true, all users in allowed_domain can edit (not just view)"
    },
    "editor_emails": {
      "type": "string",
      "description": "Comma-separated emails that can edit; pass empty string to clear"
    },
    "expires_at": {
      "type": "string",
      "description": "ISO 8601 expiry datetime; omit to keep current"
    }
  },
  "required": [
    "slug"
  ]
}

List all annotations (comments) on a document.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Document slug"
    }
  },
  "required": [
    "slug"
  ]
}

Add an annotation (comment) to a document. Pass quoted_text with the exact passage you want to annotate — the server will locate it automatically. Omit quoted_text to attach to the whole document. You can also provide start_offset + end_offset explicitly if needed.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Document slug"
    },
    "body": {
      "type": "string",
      "description": "Annotation text"
    },
    "quoted_text": {
      "type": "string",
      "description": "The exact text being annotated"
    },
    "start_offset": {
      "type": "integer",
      "description": "Character offset where annotation starts"
    },
    "end_offset": {
      "type": "integer",
      "description": "Character offset where annotation ends"
    }
  },
  "required": [
    "slug",
    "body"
  ]
}

Archive a document. For documents you own, archives it for everyone. For shared documents, archives it only for you.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Document slug"
    }
  },
  "required": [
    "slug"
  ]
}

Search mkdshare.DEV documents by title and content. Returns documents owned by or shared with the authenticated user that match the query.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search string matched case-insensitively against document title and content"
    }
  },
  "required": [
    "query"
  ]
}

Upload an image (png, jpeg, gif, webp; max 1MB) for embedding in documents. Returns a URL and a ready-to-paste markdown snippet. Images are served at an unguessable URL — anyone with the exact link can view.

{
  "type": "object",
  "properties": {
    "filename": {
      "type": "string",
      "description": "Original filename, e.g. screenshot.png"
    },
    "data": {
      "type": "string",
      "description": "Base64-encoded image bytes (standard alphabet, no data: URI prefix)"
    }
  },
  "required": [
    "filename",
    "data"
  ]
}

Start a headless Google sign-in. Call this FIRST if you don't have an API token yet. Returns a user_code and verification_url for the user to visit, plus a device_code to use with poll_device_auth. No Bearer token required.

{
  "type": "object",
  "properties": {},
  "required": []
}

Check whether the user has approved the device authorization. Call every 5 seconds (or the interval returned by a slow_down response) until status is 'complete'. Save the returned api_token to your MCP server config.

{
  "type": "object",
  "properties": {
    "device_code": {
      "type": "string",
      "description": "device_code returned by request_device_auth"
    }
  },
  "required": [
    "device_code"
  ]
}