OxagenDocs
MCP server

MCP tools

The full list of tools exposed by the Oxagen MCP server, their parity with the REST API, and known gaps.

Tool naming convention

MCP tool names use double-underscore (__) as the namespace separator because the dot (.) is not valid in MCP tool names. The capability agent.memory.recall is exposed as the tool agent__memory__recall.

Available tools

All capabilities declared with 'mcp' in their surfaces array are available. The list below mirrors the capabilities reference filtered to MCP-surfaced capabilities.

Agent

ToolCapabilityDescription
agent__tool__listagent.tool.listList available tools for the current workspace
agent__skill__listagent.skill.listList available skills
agent__mcp__listagent.mcp.listList registered external MCP servers
agent__mcp__registeragent.mcp.registerRegister an external MCP server
agent__plan__approveagent.plan.approveApprove a pending agent plan
agent__approval__resolveagent.approval.resolveApprove or deny a pending tool-call approval request
agent__memory__recallagent.memory.recallRecall memories from the workspace knowledge graph
agent__memory__writeagent.memory.writeWrite a new memory to the workspace knowledge graph
agent__task__background__startagent.task.background.startStart a long-running background task
agent__task__background__readagent.task.background.readRead the status of a background task
agent__task__background__cancelagent.task.background.cancelCancel a running background task

Chat and conversations

ToolCapabilityDescription
chat__message__sendchat.message.sendSend a message to a conversation
conversation__listconversation.listList conversations in the workspace
conversation__archiveconversation.archiveArchive a conversation
conversation__renameconversation.renameRename a conversation
conversation__deleteconversation.deleteDelete a conversation
conversation__purgeconversation.purgePermanently purge a conversation and all its messages

Knowledge and assets

ToolCapabilityDescription
asset__uploadasset.uploadUpload a binary asset (image, PDF, document)

Content generation

ToolCapabilityDescription
documents__generatedocuments.generateGenerate a document (Word, Markdown, or HTML)
documents__pdf__createdocuments.pdf.createGenerate a PDF document
image__generateimage.generateGenerate an image
svg__generatesvg.generateGenerate an SVG graphic
video__generatevideo.generateGenerate a video (async; returns task ID)
form__fillform.fillFill a form with structured data

Organization and workspace

ToolCapabilityDescription
organization__createorganization.createCreate a new organization
org__member__addorg.member.addAdd a member to the organization
org__member__removeorg.member.removeRemove a member from the organization
org__member__role__changeorg.member.role.changeChange a member's role
org__member__invite__acceptorg.member.invite.acceptAccept a pending invitation
org__member__invite__declineorg.member.invite.declineDecline a pending invitation
workspace__createworkspace.createCreate a new workspace
workspace__model__settings__readworkspace.model.settings.readRead workspace model configuration
workspace__model__settings__writeworkspace.model.settings.writeWrite workspace model configuration

Billing

ToolCapabilityDescription
billing__subscription__readbilling.subscription.readRead current subscription and credit balance

Notifications and preferences

ToolCapabilityDescription
notifications__listnotifications.listList notifications
notifications__marknotifications.markMark notifications as read
user__preferences__readuser.preferences.readRead user preferences
user__preferences__writeuser.preferences.writeUpdate user preferences

Plugins

ToolCapabilityDescription
plugin__catalog__browseplugin.catalog.browseBrowse the plugin marketplace
plugin__catalog__getplugin.catalog.getGet details for a specific plugin
plugin__org__listplugin.org.listList org-installed plugins
plugin__registry__listplugin.registry.listList configured plugin registries

System

ToolCapabilityDescription
system__install__instructionssystem.install.instructionsGet workspace context and connection verification

Parity model

The MCP tool list is generated from the same contract registry as the REST API. Every capability that declares 'mcp' in its surfaces array is a tool; every capability that does not is excluded. This is not maintained by hand — it is structural.

Known gaps

The following capabilities are not available via MCP due to transport or UX constraints:

CapabilityReason
OAuth plugin install flowsBrowser redirect required

The capability parity check reports the current parity gap automatically at build time.

On this page