Url Manager MCP

Name: Url Manager MCP
Author: Piccolo123

by Piccolo123version 1.0.2i★ –iRuns on your computer

Registry nameio.github.Piccolo123/url-manager-mcp

Install

Overview

Description from the maker (original English)

Agent-first bookmark management with auto-registration, categories, tags, and shared collections.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiVery new↓ 24/wk · ★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Other
You need to fill in: FOOTPRINTS_TOKEN

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: FOOTPRINTS_ENDPOINT, FOOTPRINTS_TOKEN

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

PyPIPython’s uv installed (for the uvx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "url-manager": {
      "command": "uvx",
      "args": [
        "url-manager-mcp"
      ],
      "env": {
        "FOOTPRINTS_ENDPOINT": "your-value",
        "FOOTPRINTS_TOKEN": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add url-manager --env FOOTPRINTS_ENDPOINT=your-value --env FOOTPRINTS_TOKEN=your-value -- uvx url-manager-mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "url-manager": {
      "command": "uvx",
      "args": [
        "url-manager-mcp"
      ],
      "env": {
        "FOOTPRINTS_ENDPOINT": "your-value",
        "FOOTPRINTS_TOKEN": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "url-manager": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "url-manager-mcp"
      ],
      "env": {
        "FOOTPRINTS_ENDPOINT": "your-value",
        "FOOTPRINTS_TOKEN": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

FOOTPRINTS_ENDPOINT env
URL Manager API endpoint
FOOTPRINTS_TOKEN secret env
URL Manager API token. Leave empty for agent-first auto-registration.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account Piccolo123, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Otheri

More stars than 0% of the other 18486 servers in this category
Published to the registry more recently than 20% of the other 18486 servers in this category
Basic checks equal to or better than 100% of the other 18486 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Url Manager MCP safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: FOOTPRINTS_TOKEN

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (1.0.2) reached the registry 3 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, Compose Preview Catalogs

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

by formulahendryEarly↓ 66/wk★ 440Updated 14 months ago

Runs on your computer

Install

Remote Desktop Commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

by desktop-commanderGrowing★ 211Updated 3 days ago

Runs in the cloud✓ desktopcommander.app

Install

Compose Preview Catalogs

Browse, inspect and render Jetpack Compose Material 3 and Wear component catalogs.

by yschimkeVery newUpdated today

Runs in the cloud

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

URL Manager MCP Server

English | 简体中文

Deliver results as beautiful cards, not raw link dumps. A Model Context Protocol server for saving, organizing, searching, and sharing web resources — cross-device sync, categories, tags, full-text search, batch operations, and team sharing. 21 tools with auto-registration so no manual setup is required.

📖 Usage patterns and best practices → [URL Manager Skill](https://github.com/Piccolo123/url-manager/blob/main/SKILL.md)

What This Tool Gives Humans

The content human users want to save is everywhere — a YouTube workout video, an Amazon gear link, a Substack training plan — scattered across platforms with no connection.

URL Manager fixes this. Paste any link from any platform. AI auto-identifies the content and suggests a category — confirm and it's a footprint. All saves flow into one platform-agnostic library, organized and always findable. Then share in one click — hand your curated knowledge base to your team, and everyone stays in sync.

System Concepts

Footprint (the fundamental unit)

A structured, searchable record — a web link, a plain-text note, an idea, or anything worth saving.

Field	Type	Description
`id`	UUID	Permanent unique identifier — use for all operations
`url`	string (8192)	Original link. Can be empty for text-only footprints
`title`	string (512)	Short title
`description`	string (1024)	Additional context or notes
`content_type`	string (50)	Free text (e.g. `article`, `video`, `image`). Use `list_content_types()` to see existing values
`category_ids`	list[int]	Which categories this belongs to — you assign
`tag_names`	list[str]	Free-form keywords — you assign

A footprint can belong to multiple categories simultaneously.

Category (a named label)

Like a folder, but a footprint can be in several at once.

Field	Type	Description
`id`	int	Permanent numeric identifier — always reference by ID
`name`	string (50)	Display name
`mode`	string \	null	`null` = personal, `"cocreate"` = shared co-edit, `"subscribe"` = shared read-only

Category Set (a workspace)

A container that groups related categories. Every user starts with "My Categories" (personal) and "Shared Categories" (shared container).

Data hierarchy

Category Sets (workspaces)

└── Categories (labels like "Shopping", "Learning") └── Footprints └── Tags (free-form keywords)

Personal vs Shared

	Personal	Shared
`mode`	`null`	`"cocreate"` or `"subscribe"`
Visible to	Only you	You + invited members
Members & invite links	No	Yes

Cocreate — everyone adds/removes footprints. Subscribe — read-only for members (writing returns 403).

Action	Owner	Admin	Member
Add/remove footprints (cocreate)	✅	✅	✅
Add/remove footprints (subscribe)	✅	❌	❌
Generate invite link (cocreate)	✅	✅	✅
Generate invite link (subscribe)	✅	❌	❌
Switch cocreate ↔ subscribe	✅	❌	❌
Manage members	Web UI only	—	—

Tools

Registration & Identity

`agent_register()` Create a new account. No parameters. Token is auto-applied for all subsequent calls. ⚠️ Call once only — each invocation creates a fresh account.

`my_info()` Verify connection and token validity. Returns username and membership status.

Bookmarks

`search_footprints(query, limit, offset)` Full-text search across titles, descriptions, and URLs.
query _(required)_ — Search keywords
limit — Results per page (default 10, max 100)
offset — Pagination offset (default 0)

`list_footprints(category_id, limit, offset)` List bookmarks by category. category_id=0 returns all.
limit — Results per page (default 20, max 100)
offset — Pagination offset (default 0)

`get_footprint(footprint_id)` Get full details of a single bookmark.
footprint_id _(required)_ — From list_footprints or search_footprints results (field id)

`add_footprint(url, title, description, category_ids, tag_names)` Add a new bookmark. Call list_categories() and list_tags() first to discover existing structure.
url _(required)_ — Web page URL
title — Leave empty to auto-extract from the page
description — Summary or notes
category_ids — Comma-separated IDs, e.g. "1,3"
tag_names — Comma-separated names, e.g. "AI,tutorial"

`update_footprint(footprint_id, title, description, category_ids, tag_names)` Update a bookmark. Omitted fields stay unchanged. ⚠️ category_ids replaces the entire list — not append. Call get_footprint() first, then merge IDs.
footprint_id _(required)_ — From search or list results

Categories & Tags

`list_categories()` List all categories (personal + shared). Returns id, name, and mode fields. mode=null → personal; mode="cocreate"/"subscribe" → shared.

`create_category(name, category_set_id)` Create a new category. Check list_categories() first to avoid duplicates.
name _(required)_ — Category name
category_set_id — Parent category set (0 = default)

`list_tags()` List all tags used by this account.

`list_content_types()` List all content types the user has used (e.g. article, video, image), ordered most-used first. Use before adding to pick a consistent content_type.

Category Sets

`list_category_sets()` List all category sets.

`create_category_set(name)` Create a new category set (a container of categories).
name _(required)_ — Category set name

Shared Categories

`create_shared_category(name, mode, description)` Create a shared category for team collaboration.
name _(required)_
mode _(required)_ — "cocreate" (multiple editors) or "subscribe" (read-only)
description — Optional description ⚠️ In subscribe mode, adding bookmarks returns 403. Use "cocreate" for editable collaboration.

`create_invite_link(shared_category_id, duration_hours)` Generate an invite link for others to join.
shared_category_id _(required)_ — From list_categories() (shared entries)
duration_hours — Default 24

`join_shared_category(invite_code)` Join a shared category by invite code.
invite_code _(required)_ — 8-character code from the invite link

`add_to_shared_category(shared_category_id, footprint_id)` Add one of your own bookmarks to a shared category.
Both parameters required

`remove_from_shared_category(shared_category_id, footprint_id)` Remove a bookmark from a shared category. Does not delete the bookmark itself.
Both parameters required

`copy_footprint(footprint_id, category_ids)` Copy a bookmark from a shared category into your personal collection.
Both parameters required

Batch & Delivery

`batch_update_footprints(updates)` Bulk edit up to 50 bookmarks at once.
updates _(required)_ — JSON string: [{"id":"...", "title":"New Title", "category_ids":"1,3"}, ...] Each object may contain title, description, category_ids, tag_names; id is required.

`agent_magic_link()` 🔑 The delivery loop core. After organizing, generate a link → send to user. They click to see a card-based interface with all their organized bookmarks. Valid for 30 days, reusable.

Workflows

New User — Zero Setup

1. agent_register() → get token (auto-memorized)

add_footprint(url="...") × N → save bookmarks one by one
list_categories() → understand current structure
create_category(name="Learning") → create a category
update_footprint(id, category_ids="...") → categorize
agent_magic_link() → "Done! View your collection here → [link]"

Returning User — Daily Use

1. my_info() → confirm identity

list_categories() + list_tags() → understand current structure
search_footprints(query) or list_footprints(category_id) → find targets
add_footprint / update_footprint → operate
agent_magic_link() → deliver results

Create Shared Category

1. create_shared_category(name="Team KB", mode="cocreate")

create_invite_link(shared_category_id= )
Send invite code to user → user shares with teammates
Teammates' agents join via join_shared_category(invite_code)

⚠️ Critical Pitfalls

category_ids REPLACES, not appends

# ❌ Wrong: moving bookmark 42 to category 7 loses existing categories 3 and 5

update_footprint(42, category_ids="7")

✅ Right: fetch current categories first, then merge

get_footprint(42) → existing categories [3, 5] update_footprint(42, category_ids="3,5,7")

Subscribe mode is READ-ONLY

Writing to a subscribe-mode shared category returns 403. If the user says "I subscribed but can't add anything", explain it's read-only — the creator needs to change it to cocreate.

NEVER call agent_register twice

Each call creates a fresh empty account. Always check for a saved token first. If unsure, call my_info() to verify the current token is valid.

Rate Limiting

Rapid consecutive calls may trigger HTTP 429. Add short delays between batch operations; on 429, wait a few seconds and retry.

No member management via API

Inviting or removing members from shared categories requires the web UI at https://ai.ocean94.com. You cannot do this programmatically.

Guidelines

Always

Auto-register silently — never interrupt the user for account setup
Search before listing — use search_footprints for targeted queries instead of dumping everything
Discover before creating — call list_categories() and list_tags() before adding to avoid duplicates
Deliver with magic link — after organizing, always generate and share a link

Confirm before

Removing bookmark-category associations (irreversible)
Clearing tags
Modifying cocreate shared categories (affects others)
Removing bookmarks from shared categories (other members lose access)

Pairing with Popular MCP Servers

URL Manager excels at saving and organizing. Pair it with tools that excel at discovering and fetching:

Fetch MCP scrapes web  →  add_footprint()  →  auto-categorized, permanent, searchable

Firecrawl crawls pages → add_footprint() → organized into cards Brave Search finds URLs → add_footprint() → one-click save from search results

Agents just pass the upstream MCP's URL + title as params to add_footprint.

Installation

git clone https://github.com/Piccolo123/url-manager-mcp.git

cd url-manager-mcp pip install -r requirements.txt

Or from PyPI:

uvx url-manager-mcp   # or: pip install url-manager-mcp

Prerequisites

Python 3.10+
Network access to https://ai.ocean94.com

DeepSeek Harness (dsh)

Add to your profile's cordis.patch.yml (e.g. ~/.dsh/profiles/headless/cordis.patch.yml or the web profile):

- insert:

id: mcp-url-manager name: '@deepseek-ai/dsh-mcp-client' config: serverName: url_manager transport: stdio command: uvx args: ['url-manager-mcp'] env: FOOTPRINTS_ENDPOINT: 'https://ai.ocean94.com'

All 21 tools appear as mcp__url_manager__* (add_footprint, search_footprints, list_categories, agent_magic_link, …). The model auto-registers on first use — no API key needed.

Only the beginning is shown; read the rest in the repo

Url Manager MCP

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

Compose Preview Catalogs

README from the maker

URL Manager MCP Server

What This Tool Gives Humans

System Concepts

Footprint (the fundamental unit)

Category (a named label)

Category Set (a workspace)

Data hierarchy

Personal vs Shared

Tools

Registration & Identity

Bookmarks

Categories & Tags

Category Sets

Shared Categories

Batch & Delivery

Workflows

New User — Zero Setup

Returning User — Daily Use

Create Shared Category

⚠️ Critical Pitfalls

category_ids REPLACES, not appends

✅ Right: fetch current categories first, then merge

Subscribe mode is READ-ONLY

NEVER call agent_register twice

Rate Limiting

No member management via API

Guidelines

Always

Confirm before

Pairing with Popular MCP Servers

Installation

Prerequisites

DeepSeek Harness (dsh)