Server definition

Hash: sha256:f8d91c07de9b688f3581fd61c118e0423cda9ac63883f5234c670b299335601b
What it is: What a remote MCP server returned when asked what it offers: 11 tools

The blob, as servednamed by its sha256

{
  "instructions": "mkdshare.DEV MCP server. If the user has no API token yet, call request_device_auth first — it walks them through Google sign-in without a browser. No Bearer token is required for that call.",
  "tools": [
    {
      "description": "Archive a document. For documents you own, archives it for everyone. For shared documents, archives it only for you.",
      "inputSchema": {
        "properties": {
          "slug": {
            "description": "Document slug",
            "type": "string"
          }
        },
        "required": [
          "slug"
        ],
        "type": "object"
      },
      "name": "archive_document",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "properties": {
          "body": {
            "description": "Annotation text",
            "type": "string"
          },
          "end_offset": {
            "description": "Character offset where annotation ends",
            "type": "integer"
          },
          "quoted_text": {
            "description": "The exact text being annotated",
            "type": "string"
          },
          "slug": {
            "description": "Document slug",
            "type": "string"
          },
          "start_offset": {
            "description": "Character offset where annotation starts",
            "type": "integer"
          }
        },
        "required": [
          "slug",
          "body"
        ],
        "type": "object"
      },
      "name": "create_annotation",
      "outputSchema": null
    },
    {
      "description": "Create a new mkdshare.DEV document. If visibility is omitted the document is owner-only (login_required, restricted to your email).",
      "inputSchema": {
        "properties": {
          "allowed_domain": {
            "description": "Domain allowed to view, e.g. company.com (domain_restricted visibility)",
            "type": "string"
          },
          "allowed_emails": {
            "description": "Comma-separated emails allowed to view (login_required visibility)",
            "type": "string"
          },
          "content": {
            "description": "Markdown content",
            "type": "string"
          },
          "domain_can_edit": {
            "description": "When true, all users in allowed_domain can edit (not just view)",
            "type": "boolean"
          },
          "editor_emails": {
            "description": "Comma-separated emails that can edit this document (in addition to the owner)",
            "type": "string"
          },
          "expires_at": {
            "description": "ISO 8601 datetime after which the document expires, e.g. 2026-06-01T00:00:00Z",
            "type": "string"
          },
          "title": {
            "description": "Document title",
            "type": "string"
          },
          "visibility": {
            "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).",
            "enum": [
              "public",
              "login_required",
              "domain_restricted"
            ],
            "type": "string"
          }
        },
        "required": [
          "title",
          "content"
        ],
        "type": "object"
      },
      "name": "create_document",
      "outputSchema": null
    },
    {
      "description": "Read the full markdown content of a document by its slug.",
      "inputSchema": {
        "properties": {
          "slug": {
            "description": "8-character document slug from the URL",
            "type": "string"
          }
        },
        "required": [
          "slug"
        ],
        "type": "object"
      },
      "name": "get_document",
      "outputSchema": null
    },
    {
      "description": "List all annotations (comments) on a document.",
      "inputSchema": {
        "properties": {
          "slug": {
            "description": "Document slug",
            "type": "string"
          }
        },
        "required": [
          "slug"
        ],
        "type": "object"
      },
      "name": "list_annotations",
      "outputSchema": null
    },
    {
      "description": "List all mkdshare.DEV documents owned by or shared with the authenticated user.",
      "inputSchema": {
        "properties": {},
        "required": [],
        "type": "object"
      },
      "name": "list_documents",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "properties": {
          "device_code": {
            "description": "device_code returned by request_device_auth",
            "type": "string"
          }
        },
        "required": [
          "device_code"
        ],
        "type": "object"
      },
      "name": "poll_device_auth",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "properties": {},
        "required": [],
        "type": "object"
      },
      "name": "request_device_auth",
      "outputSchema": null
    },
    {
      "description": "Search mkdshare.DEV documents by title and content. Returns documents owned by or shared with the authenticated user that match the query.",
      "inputSchema": {
        "properties": {
          "query": {
            "description": "Search string matched case-insensitively against document title and content",
            "type": "string"
          }
        },
        "required": [
          "query"
        ],
        "type": "object"
      },
      "name": "search_documents",
      "outputSchema": null
    },
    {
      "description": "Update an existing document you own. Omit any field to keep its current value.",
      "inputSchema": {
        "properties": {
          "allowed_domain": {
            "description": "Domain allowed to view, e.g. company.com; required for domain_restricted",
            "type": "string"
          },
          "allowed_emails": {
            "description": "Comma-separated emails allowed to view; pass empty string to clear",
            "type": "string"
          },
          "content": {
            "description": "New markdown content",
            "type": "string"
          },
          "domain_can_edit": {
            "description": "When true, all users in allowed_domain can edit (not just view)",
            "type": "boolean"
          },
          "editor_emails": {
            "description": "Comma-separated emails that can edit; pass empty string to clear",
            "type": "string"
          },
          "expires_at": {
            "description": "ISO 8601 expiry datetime; omit to keep current",
            "type": "string"
          },
          "slug": {
            "description": "Document slug",
            "type": "string"
          },
          "title": {
            "description": "New title",
            "type": "string"
          },
          "visibility": {
            "description": "New visibility level",
            "enum": [
              "public",
              "login_required",
              "domain_restricted"
            ],
            "type": "string"
          }
        },
        "required": [
          "slug"
        ],
        "type": "object"
      },
      "name": "update_document",
      "outputSchema": null
    },
    {
      "description": "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.",
      "inputSchema": {
        "properties": {
          "data": {
            "description": "Base64-encoded image bytes (standard alphabet, no data: URI prefix)",
            "type": "string"
          },
          "filename": {
            "description": "Original filename, e.g. screenshot.png",
            "type": "string"
          }
        },
        "required": [
          "filename",
          "data"
        ],
        "type": "object"
      },
      "name": "upload_image",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:f8d91c07de9b688f3581fd61c118e0423cda9ac63883f5234c670b299335601b | sha256sum