Knowledge MCP server

Markpin MCP

Version history of discovered tools, schemas, and declared agent authority.

View watchlist

DistributionDistribution: npm
Package@markpin/mcp
Latest analyzed version0.10.0
Current tool count4
Latest analysisNov 2, 2026
Package source

OBSERVED INTERFACE

Capability surface

Modelara’s observed declarations are shown separately from its derived effect classifications.

3 releases analyzed0.8.0 → 0.10.0Latest: 0.10.0
  • read4
  • write0
  • destructive0
  • unknown0

Unknown means Valyd could not determine the capability's effect confidently from the declared interface and static evidence. It is not treated as safe.

Package
@markpin/mcp@0.10.0
Registry
npm
Published
Oct 30, 2026
Integrity
sha512-Qw8mYhawmi6y9k1b7DdMeSpqDkNpSlSRdwPkc0Hc5MrfRw3Oqm40BnwelwZX2/yqS8SvcLx/0ESCVRXjZMgi8Q==
Analyzer
modelara v0.1.7 · policy not recorded
Repository
https://github.com/mud-studio/markpin-mcp

4 capabilities

CapabilityTypeDerived effectFirst observed in Valyd coverageLast changed
get_pagemarkpin:tool:get_page
Observed interface and hashes

Returns one page in full: metadata, tags, summary, the reader's one-line note (`note`), reading state (`bookmark`, `readAt` or `skimmedAt` — at most one), extracted content, every clip with its note, highlight color and reaction mark (`kind`), the absolute path of the Markdown file, and absolute paths of clip images. Accepts a page id or its URL.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "idOrUrl": {
      "description": "Page id (UUID) or the page URL.",
      "type": "string"
    }
  },
  "required": [
    "idOrUrl"
  ],
  "type": "object"
}
sha256:884126aa15b78495816d37a8bd49d2f73dc684136d9d5f0438f6b508376021bf

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:2f3408b6c296eb25e03db1d9971e322635aea05810940e8746af69fedc7e1cca

Interface hash: sha256:466de8896deeeb19954c1f8b5f181845d6eb43c123e331006726745d9da84376

Other observed Modelara metadata
{
  "id": "mcp:markpin/get_page",
  "title": "Get a saved page",
  "source": {
    "type": "mcp",
    "server": "markpin",
    "operation": "get_page"
  },
  "declared": {
    "read_only": "true",
    "destructive": "unknown",
    "idempotent": "false",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:c8fe8e5b1b9fefcb346eab213eaf03ef6921c920eb8c5118259d3a3053af6882"
}
toolread0.8.00.9.0
list_recentmarkpin:tool:list_recent
Observed interface and hashes

Lists the most recently updated pages, newest first. With bookmarked=true, lists pages with a reading bookmark, newest bookmark first.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "bookmarked": {
      "description": "Only pages with a reading bookmark.",
      "type": "boolean"
    },
    "n": {
      "description": "How many pages to return. Default 20.",
      "maximum": 200,
      "minimum": 1,
      "type": "integer"
    }
  },
  "type": "object"
}
sha256:aae920c40115a2ef8cd3968bb4152520c2a7b5cf9ce31671962e1dcf7fb1bc39

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:27d31d98539bc84a0620c0c79604e8fc2ec6d30fbe8ca462942845d4018c478e

Interface hash: sha256:d6fc89efee11d5c1afd99b61da70d54e1f158c3b0d6fe1888c07a367c4323472

Other observed Modelara metadata
{
  "id": "mcp:markpin/list_recent",
  "title": "List recent pages",
  "source": {
    "type": "mcp",
    "server": "markpin",
    "operation": "list_recent"
  },
  "declared": {
    "read_only": "true",
    "destructive": "unknown",
    "idempotent": "false",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:8b618ea6ead23830d5b12d5e23f6fe795c6f2c97c752e8fddd28b18d1d809ba7"
}
toolread0.8.0No change observed
list_tagsmarkpin:tool:list_tags
Observed interface and hashes

Lists every tag in use with the number of pages carrying it, most used first.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {},
  "type": "object"
}
sha256:73fc3af6ba54a1293c44f954cf944c40d069a764ef7974e6fc74addd4231b225

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:b55da7705854251abacc07359eee647f49f479f3d26568390ff4e6e7432fa7cc

Interface hash: sha256:7055ce0177b9c4fc919bf7c71271ad877bb15e97f2c2bcfc292a1e2c133bdea5

Other observed Modelara metadata
{
  "id": "mcp:markpin/list_tags",
  "title": "List tags",
  "source": {
    "type": "mcp",
    "server": "markpin",
    "operation": "list_tags"
  },
  "declared": {
    "read_only": "true",
    "destructive": "unknown",
    "idempotent": "false",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:bf4fcda6d27c7b1232c9cf8f5f56702d11ebabbcf794bbc8d4a2770d822a2bad"
}
toolread0.8.0No change observed
searchmarkpin:tool:search
Observed interface and hashes

Full-text search over pages saved with Markpin (title, extracted content, clipped text, notes, tags). Returns page summaries ranked by relevance with a short snippet around the first match. With an empty query, lists the most recently updated pages (optionally filtered by tags). Summaries include readAt (when the user marked the page read) and bookmark (a reading bookmark: when it was set and, if placed inside the page, the sentence it points at).

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "bookmarked": {
      "description": "Only pages with a reading bookmark (saved to read later or being read). With an empty query they come newest bookmark first.",
      "type": "boolean"
    },
    "limit": {
      "description": "Maximum number of results. Default 10.",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "default": "",
      "description": "Search terms. Prefix matching is on, so \"type\" also matches \"typescript\".",
      "type": "string"
    },
    "tags": {
      "description": "Only return pages that carry every one of these tags.",
      "items": {
        "type": "string"
      },
      "type": "array"
    }
  },
  "type": "object"
}
sha256:53e3a83301f825ee4afaf0f48472bc8a0a4ec7a4b446cba25789bc998ff17f3d

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:b8f870502744a121cb6414935fd69aedda69dd1be8f3e1a23a64efb60180f6b7

Interface hash: sha256:0778525537de40a2faa90e9cecdaa3aab905bdf28275d7aeb9620272d61a8299

Other observed Modelara metadata
{
  "id": "mcp:markpin/search",
  "title": "Search saved pages",
  "source": {
    "type": "mcp",
    "server": "markpin",
    "operation": "search"
  },
  "declared": {
    "read_only": "true",
    "destructive": "unknown",
    "idempotent": "false",
    "open_world": "unknown"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:c0f2aac114de566bb547e60ae319c28c1d585c80c7a671c78dbe69139c1a63d4"
}
toolread0.8.0No change observed

STATIC COMPARISONS

Release history

2 release transitions
  1. 0 added0 removed0 schema0 write0 destructive0 unknown

    Nov 2, 2026· Automated static analysis

  2. 0 added0 removed0 schema0 write0 destructive0 unknown

    Nov 2, 2026· Automated static analysis