url-manager-mcp
The URL Manager MCP server provides comprehensive tools for AI agents to manage, organize, and share web bookmarks with zero manual setup.
Account Management
agent_register()— Automatically create a new account (no params needed)my_info()— Verify connection and retrieve user identity/membership status
Bookmark Operations
add_footprint(url, ...)— Save a bookmark with optional title, description, categories, and tagsget_footprint(id)— Retrieve full details of a single bookmarklist_footprints(category_id)— Browse bookmarks, optionally filtered by categorysearch_footprints(query)— Full-text search across titles, descriptions, and URLsupdate_footprint(id, ...)— Edit a bookmark's title, description, categories, or tagsbatch_update_footprints(updates)— Bulk-edit up to 50 bookmarks at oncecopy_footprint(id, category_ids)— Copy a shared bookmark into your personal categories
Category & Tag Management
list_categories()— List all personal and shared categoriescreate_category(name)— Create a new personal categorylist_tags()— List all existing tags to avoid duplicateslist_category_sets()/create_category_set(name)— Manage category set containers
Collaborative Sharing
create_shared_category(name, mode)— Create a shared category incocreate(editable) orsubscribe(read-only) modecreate_invite_link(shared_category_id)— Generate a shareable invite link for collaboratorsjoin_shared_category(invite_code)— Join a shared category via an invite codeadd_to_shared_category(sc_id, footprint_id)— Add a bookmark to a shared categoryremove_from_shared_category(sc_id, footprint_id)— Remove a bookmark from a shared category
Delivery
agent_magic_link()— Generate a 30-day reusable magic link so users can view their bookmarks in a card-based web interface
Allows to search the web via Brave Search and directly add search results to the URL Manager collection using add_footprint.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@url-manager-mcp收藏这个链接 https://example.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
URL Manager MCP Server
Agent-first MCP server for managing users' web bookmarks. Agents auto-register, collect, categorize, tag, search, and share URLs — zero manual setup for end users.
📖 For detailed workflows, patterns, and behavioral guidelines, see the URL Manager Skill.
First Conversation (Every Time)
If no token provided, ask "Do you have a URL Manager account?"
No → Call
agent_register()to create one (token auto-applied)Yes → Have the user provide their token, set
FOOTPRINTS_TOKENenv varCall
my_info()to confirm the connection works
⚠️
agent_register()creates a NEW account every time. Never call it twice — if the user forgot they already have an account, you'll create a duplicate empty one.
Related MCP server: veyra-bookmarks
Tool Reference
Registration & Identity
Tool | When to Use |
| User has no account. No params, returns token auto-memorized |
| First-conversation connection check, or user asks "Who am I?" |
Bookmarks
Tool | When to Use | Key Param Source |
| User says "find that article about..." | query from user input |
| User says "show me my bookmarks" | category_id from |
| View full details of one bookmark | footprint_id from search or list results |
| User says "save/bookmark this" | url required; category_ids/tags from |
| User says "change title/move to another category" | id from search or list results |
Categories & Tags
Tool | When to Use | Notes |
| ALWAYS call before operating on bookmarks — discover existing structure | Returns personal + shared categories. mode=null → personal, mode="cocreate"/"subscribe" → shared |
| User says "create a new category" | Call |
| Before tagging — avoid duplicate tags | Returns existing tags |
Shared Categories
Tool | When to Use |
| User says "create a shared collection". mode="cocreate" (editable) / "subscribe" (read-only) |
| User says "send the invite link to..." — id from |
| User says "I have an invite code" |
| Add an existing bookmark to a shared category |
| Remove a bookmark from a shared category |
| Copy from shared category to your personal category |
Batch Operations
Tool | When to Use |
| Bulk edit bookmarks — change categories/titles/tags on up to 50 items at once |
Delivery to User
Tool | When to Use |
| 🔑 The delivery loop core. After organizing, generate a link → send to user. They open it to see a card-based interface |
⚠️ Critical Pitfalls
update_footprint: 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.
Rate Limiting
Rapid consecutive calls may trigger HTTP 429. Add short delays between batch operations; on 429, wait a few seconds and retry.
Typical Workflows
New User From Scratch
1. agent_register() → get token (auto-memorized)
2. add_footprint(url="...") × N → save bookmarks one by one
3. list_categories() → understand current structure
4. create_category(name="Learning") → create a category
5. update_footprint(id, category_ids="...") → categorize
6. Tell user: "Done! Open https://ai.ocean94.com to view" (their token-based account)Returning User — Daily Use
1. my_info() → confirm identity
2. list_categories() + list_tags() → understand current structure
3. search_footprints(query) or list_footprints(category_id) → find targets
4. add_footprint / update_footprint → operateCreate Shared Category
1. create_shared_category(name="Team Knowledge Base", mode="cocreate")
2. create_invite_link(shared_category_id=<returned ID>)
3. Send the invite code to the user → user shares with teammates
4. Teammates' Agents join via join_shared_category(invite_code)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 resultsAgents just pass the upstream MCP's URL + title as params to add_footprint.
Deployment (for Humans)
git clone https://github.com/Piccolo123/url-manager-mcp.git
cd url-manager-mcp && pip install -r requirements.txtCherry Studio / Claude Desktop config:
{
"mcpServers": {
"url-manager": {
"command": "python",
"args": ["path/to/server.py"]
}
}
}If user already has an account, add: "env": {"FOOTPRINTS_TOKEN": "FA_xxx"}
ModelScope: url-manager-mcp
Maintenance
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Piccolo123/url-manager-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server