Complete reference for all tools available through the Contextium MCP server.
This reference lists every tool available through the Contextium MCP server. For setup instructions, see Using MCP.
Workspace
| Tool | Description | Required Parameters | Optional Parameters |
|---|
list_workspaces | Lists all workspaces you have access to with your role. Each workspace contains projects, agents, skills, tags, and workflows. | — | — |
Context Libraries
| Tool | Description | Required Parameters | Optional Parameters |
|---|
list_context_libraries | Lists all Context Libraries in a workspace with file counts. Use this to see what context libraries you have before listing files. | — | workspaceId |
get_context_library | Get detailed information about a specific context library including metadata, file structure, and statistics. | libraryId | workspaceId |
get_context_library_structure | Get the complete hierarchical structure of a Context Library's documentation. Shows all folders and files organized by their relationship. | contextLibraryId | includeArchived |
create_context_library | Create a new Context Library in the workspace. Use this to organize documentation into separate libraries. | name | workspaceId, description |
Files
| Tool | Description | Required Parameters | Optional Parameters |
|---|
list_files | Lists files in a Context Library or folder (names and metadata only, no content). Use get_file to retrieve specific file content. | projectId | folderId, status, limit |
get_file | Get the complete content and metadata of a specific documentation file by its ID. | fileId | includeMetadata |
create_file | Create a new file in a Contextium Context Library. Requires write access to the Context Library. | projectId, title, path | content, folderId |
update_file | Update an existing file in Contextium. You can modify the title, path, content, or status. By default, creates a version history entry. | fileId | title, path, content, status, changeSummary, createVersion, folderId, projectId |
delete_file | Delete a file from Contextium (moves to trash, not permanent). The file can be restored later if needed. | fileId | — |
get_file_versions | Get version history for a documentation file. Shows what changed and who made the changes. | fileId | limit, offset |
Search
| Tool | Description | Required Parameters | Optional Parameters |
|---|
search_documentation | Search through all documentation files you have access to. Returns matching files with highlighted excerpts. | query | workspaceId, projectId, limit, offset |
search_by_tags | Search for files by tag IDs. Returns files that have ALL specified tags (AND logic). | tagIds | workspaceId, projectId |
Tags are flat and untyped. A tag exists only as a #value token inside a file's content, and Contextium reconciles a file's tags from its body when the file is saved. The file content is the source of truth — so a tag is created by adding a #value token to a file's content (Contextium auto-creates it on save), either by editing the file directly or by using manage_relationship with type=tag (see below). There is no create action for tags — create does not accept type=tag.
| Tool | Description | Required Parameters | Optional Parameters |
|---|
list_tags | List all tags in a workspace. Returns a flat list of tags with their IDs and usage counts. | — | workspaceId |
file_tags | List the tags applied to a single file (read-only). | fileId | workspaceId |
To apply or remove a tag on a file, use the consolidated manage_relationship tool with type=tag. Each action edits the file content — it writes or deletes a #value token in the file body — and auto-creates the tag if it is new:
| Action | Description | Required Parameters | Optional Parameters |
|---|
add | Add a #value token to a single file's content. | type=tag, action, value, fileId | workspaceId |
remove | Delete the #value token from a single file's content. | type=tag, action, value, fileId | workspaceId |
apply_bulk | Add a #value token to several files' content at once (max 100). | type=tag, action, value, fileIds | workspaceId |
remove_bulk | Delete a #value token from several files' content at once (max 100). | type=tag, action, value, fileIds | workspaceId |
Tag values are lowercase letters, digits, and hyphens (e.g. urgent, api-reference). There are no direct tag apply/remove API endpoints — these actions always go through the file content.
Agents
| Tool | Description | Required Parameters | Optional Parameters |
|---|
list_agents | Lists all agents (AI assistant configurations) in a workspace. Agents define assistant roles and capabilities. | — | workspaceId |
get_agent | Get detailed information about a specific agent including system prompt, persona, configuration, and associated files. | agentId | workspaceId |
create_agent | Create a new agent in the workspace. Agents are specialized AI assistants with custom instructions and context. | name | workspaceId, description |
update_agent | Update an existing agent's name, description, custom context, or system prompt. | agentId | workspaceId, name, description, customContext, systemPrompt |
Skills
| Tool | Description | Required Parameters | Optional Parameters |
|---|
list_skills | Lists all skills (shared knowledge and best practices) in a workspace. Skills contain reusable documentation for AI agents. | — | workspaceId |
get_skill | Get detailed information about a specific skill including code, configuration, and associated files. | skillId | workspaceId |
create_skill | Create a new skill in the workspace. The description should be written in third person: what knowledge the skill provides and when to use it — e.g. "Provides the company refund policy. Use when handling customer queries about refunds." Skills are created with YAML frontmatter by default. | name | workspaceId, description, content |
update_skill | Update an existing skill's name, description, or content. | skillId | workspaceId, name, description, content |
add_skill_to_agent | Add a skill to an agent, giving the agent access to that skill's knowledge and capabilities. | agentId, skillId | workspaceId |
remove_skill_from_agent | Remove a skill from an agent. | agentId, skillId | workspaceId |
Workflows
| Tool | Description | Required Parameters | Optional Parameters |
|---|
list_workflows | List all workflows in a workspace. Workflows bundle agents, skills, tags, and context libraries together for a specific task. | — | workspaceId |
get_workflow | Get detailed information about a specific workflow including name, description, associated agents, tags, and metadata. | workflowId | workspaceId |
create_workflow | Create a new workflow in the workspace. Workflows bundle agents, skills, tags, and context libraries together for a specific task. | name | workspaceId, description, agentIds, skillIds, tagIds, projectIds |
update_workflow | Update an existing workflow. Modify its name, description, or the agents, skills, tags, and libraries it includes. | workflowId | workspaceId, name, description, agentIds, skillIds, tagIds, projectIds |
load_workflow | Load all resources associated with a workflow including agents, skills, files, and context libraries. Returns the complete workflow context. | workflowId | workspaceId, includeFileContent |
Tasks
Tasks are lightweight to-dos tied to a workflow. When load_workflow is called, the response already includes the active task list — use these tools to add, update, or query tasks beyond what is returned automatically.
| Tool | Description | Required Parameters | Optional Parameters |
|---|
add_task | Add a task to a workflow. Pass workflowId for an exact match or workflowName for fuzzy search. If the name matches multiple workflows, candidates are returned so the user can pick. | title | workflowId, workflowName, workspaceId, description |
update_task_status | Update the status of a task. Use in_progress when starting work, done when complete, dismissed when no longer relevant. | taskId, workflowId, status | workspaceId |
list_tasks | List all tasks for a workflow with status, creator, and due date. Use sparingly — load_workflow already includes active tasks. | workflowId | workspaceId, status, includeDismissed |
Valid status values: not_started · in_progress · done · dismissed
Team
| Tool | Description | Required Parameters | Optional Parameters |
|---|
notify_team_members | Notify workspace team members about a resource — file, workflow, agent, or library. Sends a notification to the bell icon and notifications page for each recipient. Respects each member's notification preferences and Do Not Disturb settings. If a name matches more than one member, Claude will ask you to clarify before sending. | resourceType, resourceId, resourceName | workspaceId, message, notificationType, memberNames, memberEmails, memberIds |
Notes
- Tool names use snake_case. Pass them exactly as shown.
- All tools require authentication. See Using MCP for setup.
- This reference covers the Node.js MCP server at mcp.contextium.io.
