MCP

Connect StackLinker to Cursor or Claude with your API key and the hosted MCP endpoint. This page is focused on end-user setup and quick connection steps.

1. Connection Values

Generate an API key in your profile, then use the hosted MCP endpoint and Authorization header below in your MCP client.

Production MCP URL

https://mcp.stacklinker.com/mcp

Authorization header

Authorization: Bearer YOUR_API_KEY

Recommended scopes

Use read for safe browsing. Add write only if the app should create, move, rename, or delete bookmarks and folders.

2. Create an API Key

Open Profile → API Keys, create a key for your integration, choose the required scopes, and save the JWT token immediately. It is shown only once. Create API Key

3. Choose Your App

Select the app you want to connect and follow the matching setup instructions.

Cursor

Cursor supports remote MCP servers directly. Add a server in Cursor settings and include the Authorization header.

Open Cursor settings and go to MCP / Tools.
Add a new remote MCP server.
Use the MCP URL and Authorization header shown on this page.

Example Cursor config

{
  "mcpServers": {
    "stacklinker": {
      "url": "https://mcp.stacklinker.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Available Tools

Expand only the area you care about. Each section summarizes what the hosted MCP tools are for.

Account & Access

Core tools for identity, workspace overview, and member access.

who_am_i

Return information about the currently authenticated user, including preferredLocale (emails and similar; on the web it changes via the footer language switch—MCP does not update it).

list_workspaces

List workspaces available to the current API key.

get_workspace

Load detailed information for one workspace.

get_workspace_tree

Return the folder and bookmark tree for a workspace.

list_workspace_members

List workspace members and their roles.

remove_workspace_member

Remove a member from a workspace when you have admin access.

update_workspace_member_role

Change a member role to view, editor, or admin.

Invitations

Manage inbound invites and create new workspace invitations.

list_workspace_invitations

List your inbound workspace invitations.

get_workspace_invitation

Load the details of a single invitation.

create_workspace_invitation

Create a new workspace invitation for an email address.

accept_workspace_invitation

Accept an inbound workspace invitation.

reject_workspace_invitation

Reject an inbound workspace invitation.

Public Workspaces

Discover public workspaces and work with their shared content.

list_public_workspaces

Search public workspaces, optionally by text query.

get_public_workspace

Load metadata for one public workspace.

get_public_workspace_tree

Return the public folder and bookmark tree.

copy_public_workspace

Copy a public workspace into your own private workspace.

Watched Workspaces

Follow public workspaces without copying them into your account.

list_watched_workspaces

List the public workspaces you currently watch.

get_watched_workspace

Load one watched workspace record from your list.

watch_workspace

Start watching a public workspace.

unwatch_workspace

Stop watching a selected public workspace.

Workspace Management

Create, update, and manage workspaces directly from your MCP client.

create_workspace

Create a new workspace.

update_workspace

Update workspace name or icon.

delete_workspace

Delete a workspace when permissions and backend rules allow it.

leave_workspace

Leave a workspace.

update_workspace_public

Enable or disable public sharing and update the public description.

reorganize_workspace_ai

Let AI reorganize all bookmarks in a workspace into a new logical folder hierarchy. All bookmarks are preserved, existing folders are replaced. Requires admin role. Runs asynchronously — you receive an email when done.

User Groups

Manage workspace groups used for access control and team organization.

list_user_groups

List user groups in a workspace.

create_user_group

Create a new user group.

update_user_group

Rename an existing group.

delete_user_group

Delete a group.

add_user_group_member

Add a user to a group.

remove_user_group_member

Remove a user from a group.

Bookmarks

Search, create, update, move, and secure bookmarks.

search_bookmarks

Search bookmarks by name, URL, or folder path.

create_bookmark

Create a new bookmark and optionally place it into a folder.

update_bookmark

Update bookmark name or URL.

move_bookmark

Move a bookmark to another folder or position.

delete_bookmark

Delete a bookmark.

set_bookmark_groups

Define which groups have direct access to a bookmark.

clear_bookmark_groups

Remove all direct group assignments from a bookmark.

Bookmark Labels

Personal bookmark labels inside a workspace. Each user can only see and manage their own labels.

list_workspace_bookmark_labels

List your personal bookmark labels for a workspace. Requires read scope.

create_workspace_bookmark_label

Create a new personal bookmark label in a workspace. Requires write scope.

update_workspace_bookmark_label

Rename one of your existing bookmark labels. Requires write scope.

delete_workspace_bookmark_label

Delete one of your personal bookmark labels. Requires write scope.

set_bookmark_labels

Set which of your personal labels are assigned to a specific bookmark. Requires write scope.

Folders & Structure

Build and manage folder hierarchy inside a workspace.

ensure_folder_path

Ensure a folder path exists and return the resolved folder.

rename_folder

Rename a folder.

move_folder

Move a folder under a different parent or position.

delete_folder

Delete a folder.

set_folder_groups

Set direct group access on a folder or mark it as public.

clear_folder_groups

Remove all direct group assignments from a folder.

apply_folder_groups_recursively

Apply folder access settings to the folder and all descendants.

Practical Tips

Use a dedicated API key per app so you can revoke one integration without affecting the others.
Start with read scope first. Add write only when you want the client to modify bookmark hierarchy.
Keep one key for Cursor and a separate key for Claude so usage stays isolated.
Use https://mcp.stacklinker.com/mcp as the server URL.

MCP