MCP Tools Overview

The default release profile contains 47 business and workflow tools and two connection and evidence helpers. MCP uses the existing Coconut operations and ontology. Your credential controls the tools that discovery returns.

Discovery returns only tools that your deployment and credential permit. Deployment configuration and your grant can reduce the tools available to your agent. Use discovery from your connected server as the authority for tool names and input schemas.

Set up your agent or give it the Markdown setup guide.

Connection and evidence helpers

workspace_get: read the credential's Workspace, Brand, capabilities, expiry, and channel context. Start with {}.
operation_receipts: inspect governed evidence for an invocation within the authorized Brand.

The connection helper requires the workspace_discover capability. A narrow grant can expose fewer than 49 tools.

Maris and MCP coverage

Maris has 44 selectable tools. This profile exposes 41 matching Maris names, six additional workflow tools, and two helpers. Matching names do not prove identical schemas or complete workflow qualification. Read the complete domain comparison and tool inventory.

The absent Maris names are brand_switch, asset_publication_command_create, and publication_command_retry. Credentials bind one Brand. Use another explicit consent grant for another Brand. Use the single-branch publication_propose workflow for publication. Canonical batch creation and manual command retry remain unavailable.

Business and workflow tools

Brand (2)

Tool	Purpose
`brand_create`	Create a Brand in the authorized Workspace.
`brand_update`	Update Brand identity and Brain settings with version checks.

Workspace and channels (4)

Tool	Purpose
`workspace_find`	Find authorized objects through the shared ontology.
`workspace_read`	Read an authorized object and its current state.
`workspace_query`	Query authorized objects through the shared ontology.
`channel_list`	Read connected channels and their current state.

Sources and analysis (5)

Tool	Purpose
`creator_subscribe`	Subscribe the Brand to a creator.
`creator_subscription_update`	Update or cancel a creator subscription.
`creator_analyze`	Analyze a creator within the authorized scope.
`content_analyze`	Analyze content delivered to the Brand.
`content_ingest`	Request content ingestion for a creator.

Sources organization (7)

Tool	Purpose
`sources_collection_create`	Create a Sources collection.
`sources_collection_update`	Update a Sources collection.
`sources_tag_create`	Create a Sources tag.
`sources_tag_update`	Update a Sources tag.
`sources_membership_update`	Update Sources collection or tag membership.
`sources_reference_update`	Update a Sources reference.
`sources_stash_update`	Update the Sources stash state.

Vault (6)

Tool	Purpose
`vault_collection_create`	Create a Vault collection.
`vault_collection_update`	Update a Vault collection.
`vault_tag_create`	Create a Vault tag.
`vault_tag_update`	Update a Vault tag.
`vault_membership_update`	Update Vault collection or tag membership.
`vault_notes_update`	Update Vault notes.

Media upload (3)

Tool	Purpose
`media_upload_begin`	Admit one file by byte count, MIME type, and checksum.
`media_upload_complete`	Commit acknowledged parts and request verification.
`media_status`	Confirm verified Media readiness before Asset reuse.

Assets and history (10)

Tool	Purpose
`asset_create_structured`	Create an Asset from structured input.
`asset_operation_apply`	Apply an operation to an Asset.
`asset_branch_list`	Read the branches of an Asset.
`asset_branch_create`	Create an Asset branch.
`asset_branch_operation_apply`	Apply an operation to an Asset branch.
`asset_branch_diff`	Compare Asset branch state.
`asset_journal_read`	Read Asset history.
`asset_journal_undo`	Undo an eligible Asset history entry.
`asset_journal_redo`	Redo an eligible Asset history entry.
`asset_journal_restore`	Restore an eligible Asset history revision.

Publication and import reuse (9)

Tool	Purpose
`asset_publication_readiness_inspect`	Inspect publication requirements and blockers.
`publication_readiness`	Read readiness and the exact binding for a publication request.
`publication_propose`	Publish or schedule one Asset branch under the explicit grant.
`publication_status`	Read the durable state of a publication.
`asset_publication_readiness_repair`	Apply a supported publication readiness repair.
`import_reuse_prepare`	Prepare imported content for reuse.
`import_reuse_schedule`	Admit an approved import reuse manifest for scheduling.
`asset_publication_cancel`	Cancel an eligible publication.
`asset_publication_reschedule`	Reschedule an eligible publication.

Web search (1)

Tool	Purpose
`web_search`	Search the web through the configured provider.

Start with a read

Discover the tools and their input schemas.
Call workspace_get with {}.
Check the Workspace, Brand, capabilities, and expiry.
Use workspace_find, workspace_read, or workspace_query to obtain authorized targets.
Read channel_list before a workflow that needs a connected channel.

Use identifiers and versions from current reads. Do not supply actor or scope overrides. Host tool names can include a namespace.

Subscribe, ingest, and analyze

Use creator_subscribe to create a subscription. Use creator_subscription_update to change or cancel it. Subscription creation does not prove ingestion.

Use content_ingest to request content for the selected creator. Inspect the returned state and operation evidence before analysis. Use content_analyze only for content delivered to the authorized Brand. Analysis, ingestion, and web search can consume credits or provider usage.

Create and edit Assets

Use asset_create_structured to create an Asset. Read its branches before edits. Use asset_branch_operation_apply for branch operations. Inspect the journal before undo, redo, or restore.

Publication and scheduling

Read the current Asset, branch, channel, and publication state.
Inspect readiness with asset_publication_readiness_inspect.
Apply only supported repairs with asset_publication_readiness_repair.
Read publication_readiness for the exact branch, content, Media, and account binding.
Copy that binding into publication_propose. Preserve the inspected intent and a stable idempotency key.
Set scheduledAt to null to publish now. Supply an absolute timestamp with an offset to schedule.
Use bounded publication_status reads. Confirm scheduled state and the requested time for scheduling. Confirm terminal publication for publish-now.
For an import reuse workflow, use import_reuse_prepare.
Supply the exact approved manifest to import_reuse_schedule.
Read operation evidence and current publication state until the workflow reaches a terminal state.

Import reuse scheduling requires its approved 100-item manifest. It is not a general single-post publish command. Use asset_publication_cancel or asset_publication_reschedule for eligible existing publications. Follow the discovered schema and current version requirements.

The single-branch publication workflow requires explicit readiness, publication, and status grants. Existing credentials do not gain publication permission automatically. Authorize a new grant when required. Interactive approval and publication_resume are unsupported. Stop after an authority denial. This workflow does not accept channel batches or local wall-clock times. An accepted or queued operation does not prove provider publication. After a timeout or an unknown result, inspect receipts and current state before retrying.

Local files and the private helper

The default profile exposes media_upload_begin, media_upload_complete, and media_status. The private upload helper transfers local bytes under its own explicit authorization. Authorize the helper with a separate OAuth profile. The native agent can read its Media through media_status within the same actor, Workspace, and Brand scope. Upload session control remains bound to the helper credential. Confirm verified ready state before Asset reuse. Do not attempt an upload when discovery does not return the required tools. The helper has no public npm installation.

Read the helper availability limits and the credential and receipt contract.

Coconut

Workflows

Resources

Company