Skip to main content
Glama
list91

MCP CopyQ Server

by list91
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Server capabilities have not been inspected yet.

Tools

Functions exposed to the LLM to take actions

NameDescription
mcp_readA

Read from CopyQ clipboard manager.

MCP tabs (full read/write access):

  • mcp/info - general information storage

  • mcp/заметки - notes storage

  • mcp/workspace - projects (supports subtabs like workspace/myproject)

External tabs (READ-ONLY access with scope="all" or scope="external"):

  • All other CopyQ tabs like "&clipboard", personal tabs, etc.

  • Use scope="all" to see all tabs, scope="external" for non-mcp only

Modes:

  • tree: Get tab structure with previews. Use FIRST to see available tabs.

  • list: Get items from tab with pagination

  • item: Get single item with full content (text, tags, note)

  • search: Search by regex across tabs

Parameters:

  • mode (required): "tree" | "list" | "item" | "search"

  • tab: For mcp tabs use relative path "info", "workspace/proj1". For external use full name "&clipboard"

  • scope: "mcp" (default) | "all" | "external" - controls which tabs are accessible

  • index: Item index (for mode=item)

  • query: Search regex (for mode=search)

Examples:

  • tree of mcp tabs: mode="tree"

  • tree of ALL tabs: mode="tree", scope="all"

  • read external tab: mode="list", tab="&clipboard", scope="external"

  • search everywhere: mode="search", query="pattern", scope="all"

Errors: TAB_NOT_FOUND, INDEX_OUT_OF_BOUNDS, INVALID_MODE

mcp_writeA

Write to CopyQ clipboard manager.

IMPORTANT: All data stored under "mcp/" prefix. When you use tab="info", actual CopyQ path is "mcp/info".

Available tabs:

  • info - general storage (use tab="info")

  • заметки - notes (use tab="заметки")

  • workspace - projects, supports subtabs (use tab="workspace" or "workspace/myproject")

Modes:

  • add: Add item to tab. Params: tab, text, tags (optional), note (optional)

  • update: Update item. Params: tab, index, field, text/tags/note

  • delete: Delete item. Params: tab, index

  • move: Move item. Params: tab, index, to_tab

  • tab_create: Create subtab in workspace only. Params: path (e.g. "workspace/newproject")

  • tab_delete: Delete subtab. Params: path

Response shows full_path (e.g. "mcp/info") confirming where data was written.

Errors: TAB_NOT_FOUND, INDEX_OUT_OF_BOUNDS, PERMISSION_DENIED, MISSING_PARAM

mcp_validateA

Validate parameters for mcp_read or mcp_write without executing.

Use to check if a call will succeed before making it.

Parameters:

  • tool (required): "read" | "write"

  • params (required): Parameters object to validate

Returns:

  • valid: true/false

  • errors: List of error codes and messages

  • warnings: List of warnings

  • estimated_tokens: Estimated response token count

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.5/5.0

Scored across 3 tools

Disambiguation5/5

The three tools have clearly distinct purposes: mcp_read is for reading data from the clipboard manager, mcp_write is for writing data to it, and mcp_validate is for validating parameters before operations. There is no overlap in functionality, making it easy for an agent to select the correct tool.

Naming Consistency5/5

All tool names follow a consistent 'mcp_' prefix with a descriptive verb (read, write, validate), using snake_case uniformly. This predictable pattern enhances readability and reduces confusion.

Tool Count4/5

With three tools, the count is appropriate for the server's purpose of clipboard management, covering read, write, and validation operations. It is well-scoped, though a slightly larger set might offer more granularity, but this is reasonable.

Completeness5/5

The tool set provides complete CRUD and lifecycle coverage for clipboard data management: mcp_read handles retrieval (including search and listing), mcp_write supports creation, updates, deletion, and movement, and mcp_validate ensures parameter integrity. No obvious gaps exist for the domain.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources