io.github.Piccolo123/url-manager-mcp
PYPI · URL-MANAGER-MCP · SCANNED AUG 20
Agent-first bookmark management with auto-registration, categories, tags, and shared collections.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security100
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- Runs hatchling.build at install time, a recognised native-build step with no shell scripting around it. View diagnostics → Pass
- 1 of 30 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 5 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability68
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 2263 tokens (~107/item across 21 items; 21 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage67
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 0% of tool parameters carry a description.Fail
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
pypi · url-manager-mcp
claude mcp add piccolo123-url-manager-mcp -- uvx url-manager-mcp
codex mcp add piccolo123-url-manager-mcp -- uvx url-manager-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"piccolo123-url-manager-mcp": {
"type": "local",
"command": [
"uvx",
"url-manager-mcp"
],
"enabled": true
}
}
} openclaw mcp add piccolo123-url-manager-mcp --command uvx --arg url-manager-mcp
mcp_servers:
piccolo123-url-manager-mcp:
command: "uvx"
args: ["url-manager-mcp"] {
"mcpServers": {
"piccolo123-url-manager-mcp": {
"command": "uvx",
"args": [
"url-manager-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 15 Aug 26 +15
- Malware scan: unverified → pass ▲ security
- 14 Aug 26 49
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Aug 2026 · Analysed pypi/url-manager-mcp@1.0.2
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | pypi |
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | allowlisted | hatchling.build |
Dependencies 30 packages
| Packages resolved | 30 |
|---|---|
| Stale | 1 |
| Tree resolution | Complete |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
add_footprint ~166
Add a new bookmark. Use when the user says "save/bookmark/collect this link". Call list_categories() and list_tags() FIRST to discover existing categories and tags — avoid creating duplicates. If title is empty, it will be auto-extracted. Args: url: Web page URL (required) title: Custom title (leave empty for auto-extraction) description: Summary/notes category_ids: Comma-separated category IDs, e.g. "1,3" tag_names: Comma-separated tag names, e.g. "AI,tutorial"
| Name | Type | Req | Description |
|---|---|---|---|
| category_ids | string | – | – |
| description | string | – | – |
| tag_names | string | – | – |
| title | string | – | – |
| url | string | yes | – |
No output schema declared.
No examples provided.
add_to_shared_category ~114
Add one of your existing bookmarks to a shared category. Use when the user says "add this to the team collection" or wants to contribute to a shared folder. The bookmark must belong to you. In subscribe mode, only the owner can add; members get 403. In cocreate mode, all members can add. Args: shared_category_id: Shared category ID footprint_id: Bookmark ID to add
| Name | Type | Req | Description |
|---|---|---|---|
| footprint_id | integer | yes | – |
| shared_category_id | integer | yes | – |
No output schema declared.
No examples provided.
agent_magic_link ~79
Generate a delivery link to the user. Use after organizing bookmarks — this is the Agent-first delivery loop core. Call this as the final step, then send the link to the user: "Done organizing — view here → [link]" User opens it to see a card-based interface with all organized bookmarks. Link valid for 30 days, reusable.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
agent_register ~88
Create a new URL Manager account. Use when the user has no existing account and no token is configured — the default path for first-time users. No parameters. Token is auto-memorized for all subsequent calls. ⚠️ NEVER call this more than once! Each call creates a fresh empty account. When in doubt, call my_info() first to check if a token is already active.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
batch_update_footprints ~145
Batch update up to 50 bookmarks at once. Use when the user says "reorganize all my bookmarks" or for bulk categorization / renaming. ⚠️ updates must be a valid JSON array. Malformed JSON or > 50 items returns an error. category_ids still REPLACES (not appends) — verify existing categories with get_footprint() first. Args: updates: JSON string, format '[{"id":"uuid","title":"New Title","category_ids":"1,3"}, ...]' Each object requires "id". Optional: title, description, category_ids, tag_names
| Name | Type | Req | Description |
|---|---|---|---|
| updates | string | yes | – |
No output schema declared.
No examples provided.
copy_footprint ~93
Copy a bookmark from a shared category into your personal collection. Use when the user says "save this shared bookmark to my own collection" or "add that to my personal list". Args: footprint_id: Bookmark ID to copy category_ids: Target personal category IDs, comma-separated, e.g. "1,3"
| Name | Type | Req | Description |
|---|---|---|---|
| category_ids | string | yes | – |
| footprint_id | integer | yes | – |
No output schema declared.
No examples provided.
create_category ~80
Create a new category. Use when the user says "create a new category called..." or when organizing bookmarks into a new group. Call list_categories() first to avoid duplicates. Args: name: Category name category_set_id: Parent category set (0=default)
| Name | Type | Req | Description |
|---|---|---|---|
| category_set_id | integer | – | – |
| name | string | yes | – |
No output schema declared.
No examples provided.
create_category_set ~52
Create a new category set (a container of categories). Use when the user says "create a new workspace/set for...". Args: name: Category set name
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | – |
No output schema declared.
No examples provided.
create_invite_link ~97
Generate an invite link for others to join. Use when the user says "send the invite link to my team" or "invite someone to this shared category". Args: shared_category_id: Shared category ID (from list_categories — pick ones where mode is not null) duration_hours: Link validity in hours (default: 24)
| Name | Type | Req | Description |
|---|---|---|---|
| duration_hours | integer | – | – |
| shared_category_id | integer | yes | – |
No output schema declared.
No examples provided.
create_shared_category ~145
Create a shared category for team collaboration. Use when the user says "create a shared collection" or "let's share a folder with my team". ⚠️ In subscribe mode, only the owner can add bookmarks — members get 403 from add_to_shared_category. Use mode="cocreate" for full team editing. Args: name: Category name (required) mode: "cocreate" (multiple editors) or "subscribe" (read-only). Default: "cocreate" description: Optional description for the shared category
| Name | Type | Req | Description |
|---|---|---|---|
| description | string | – | – |
| mode | string | – | – |
| name | string | yes | – |
No output schema declared.
No examples provided.
get_footprint ~72
Get full details of a single bookmark. Use when the user says "show me the details of that bookmark" or before updating to see existing categories. Args: footprint_id: Bookmark ID (from list_footprints or search results, field "id")
| Name | Type | Req | Description |
|---|---|---|---|
| footprint_id | integer | yes | – |
No output schema declared.
No examples provided.
join_shared_category ~56
Join a shared category by invite code. Use when the user says "I have an invite code" or "join this shared collection". Args: invite_code: 8-character invite code
| Name | Type | Req | Description |
|---|---|---|---|
| invite_code | string | yes | – |
No output schema declared.
No examples provided.
list_categories ~84
List all categories (personal + shared). Use at the start of any bookmark operation to discover available categories and their IDs. Returns each category with id, name, and mode fields. mode=null → personal category. mode="cocreate"/"subscribe" → shared category. Use the 'id' field in add_footprint / update_footprint category_ids parameter.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_category_sets ~35
List all category sets. Use when the user asks about their organizational structure or needs to create a category in a specific set.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_content_types ~67
List all content types the user has used. Use before adding bookmarks to pick a content_type consistent with the user's existing library. Returns each type with a usage count, ordered most-used first. Common values: article, video, image, audio, page — but any string is valid.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_footprints ~98
List bookmarks by category. Use when the user says "show me my bookmarks", "what have I saved?", or "list everything in this category". Args: category_id: Category ID (0=all, get IDs from list_categories) limit: Results per page (max 100) offset: Pagination offset
| Name | Type | Req | Description |
|---|---|---|---|
| category_id | integer | – | – |
| limit | integer | – | – |
| offset | integer | – | – |
No output schema declared.
No examples provided.
list_tags ~24
List all tags. Use before tagging bookmarks to see existing tags and avoid duplicates.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
my_info ~47
Verify token validity and confirm connection. Use at the start of every conversation, or when the user asks "Who am I?" / "What account is this?" Returns username and membership status.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
remove_from_shared_category ~77
Remove a bookmark from a shared category. Use when the user says "take this out of the shared collection". Does not delete the bookmark itself. Args: shared_category_id: Shared category ID footprint_id: Bookmark ID to remove
| Name | Type | Req | Description |
|---|---|---|---|
| footprint_id | integer | yes | – |
| shared_category_id | integer | yes | – |
No output schema declared.
No examples provided.
search_footprints ~85
Full-text search across titles, descriptions, and URLs. Use when the user says "find that article about Docker" or "search for...". Args: query: Search keywords limit: Results per page (max 100) offset: Pagination offset
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | – |
| offset | integer | – | – |
| query | string | yes | – |
No output schema declared.
No examples provided.
update_footprint ~168
Update a bookmark. Use when the user says "change the title", "move to another category", or "add a description". ⚠️ category_ids REPLACES the entire category list — NOT append! Correct approach: get_footprint(id) → see current categories → merge in new IDs. Example: existing [3,5], want to add 7 → category_ids="3,5,7" (NOT just "7") Args: footprint_id: Bookmark ID (from search or list results) title/description/category_ids/tag_names: Leave empty to keep unchanged
| Name | Type | Req | Description |
|---|---|---|---|
| category_ids | string | – | – |
| description | string | – | – |
| footprint_id | integer | yes | – |
| tag_names | string | – | – |
| title | string | – | – |
No output schema declared.
No examples provided.