MCP Tools

The Marcora MCP Server exposes a set of tools that your AI assistant can call directly to interact with your workspace. Each tool maps to a specific action — from generating content to retrieving context — and can be invoked naturally through conversation.

The tools below are available to any connected AI assistant once the Marcora MCP Server is configured.

Tools

Workflows

create_workflow

Create a new workflow template. Workflows start as status="draft"; activate them via update_workflow once the user confirms.

get_workflow

Fetch a single workflow's full definition plus its triggers and latest run. Use before updating a workflow to avoid clobbering unknown fields.

get_workflow_runs

Inspect workflow run history. Two modes: list mode (paginated runs for a workflow) or single mode (one run with step logs and tool call logs) controlled by run_id presence.

list_workflows

List workflows for the authenticated user's active team. Supports optional status filter and name search.

run_workflow

Manually dispatch a workflow run. Creates a workflow_run row and dispatches a Managed Agents session. Returns the run row — check .status to know what happened.

update_workflow

Partial update of a workflow template. Only keys present in the input mutate — unspecified keys are preserved. Call get_workflow first to see the current state.

Context & Resources

get_brand_foundation

Get the team's Brand Foundation — company overview, brand voice, writing style, and writing examples.

list_context_collections

Returns all context collections accessible to the current user. Collections organize reference materials (context items) that inform AI-generated content.

update_brand_foundation

Overwrite a single Brand Foundation element (company overview, brand voice, writing style, or writing examples).

create_context_collection

Create a new context collection to organize your reference materials. Collections group related context items together for easier management and targeted retrieval.

add_context

Add a new context item to your reference library. Context items are reference materials that power AI generation — they help the AI produce more accurate, on-brand, and relevant content. You can supply the body two ways: - **`content`** — paste the markdown body directly. Best for short or hand-authored material. - **`content_url`** — pass a public URL and the backend fetches it and converts it to clean markdown server-side using a headless browser + Mozilla Readability (the same engine used for the user-website context-import flow). Use this whenever the body is large, comes from a presigned-link export (e.g. Google Doc, Composio sandbox), or you'd otherwise have to pull the page into your own conversation just to forward it. Exactly one of `content` or `content_url` is required — providing both returns a 400.

update_context

Update an existing context item — change its name, content, or move it between collections / projects. If the item has a linked editing canvas open in the Marcora sidebar, its title and content stay in sync automatically. Like `add_context`, you can supply a new body either as inline `content` or as a `content_url` the backend fetches and converts to markdown server-side. Pass at most one — providing both returns a 400. Omit both to leave the body untouched (e.g. when you're only renaming the item or moving it between collections).

get_relevant_context

Searches the team's context library and returns the most relevant chunks for a given prompt. Use this to gather supporting context before generating or refining content.

Blueprints

list_blueprints

Get all blueprints in your team's library, organized as a flat list. Each blueprint includes its content category and a web URL.

get_blueprint

Retrieve the full details of a specific blueprint by its UUID, including content, AI-generated analysis, and metadata.

create_blueprint

Create a reusable blueprint template for generating content at scale. Blueprints define the structure and AI instructions for a document type. NOTE: Takes 1-3 minutes to return.

create_blueprint_draft

Create an AI-assisted blueprint DRAFT from a prompt. This creates a draft blueprint template you can review before saving as a full blueprint.

finalize_blueprint_draft

Finalize (publish) a previously created blueprint draft into a full, usable blueprint. This is the final step in the draft workflow: create_blueprint_draft → user reviews → finalize_blueprint_draft.

list_community_blueprints

Browse community blueprints available for import. Returns blueprints shared by Marcora users, including name, summary, contributor info, and category.

get_community_blueprint_details

Get the full details for a specific community blueprint, including complete content, content description/style guide, and contributor information.

import_community_blueprint

Import a blueprint from the Marcora community exchange into your team's library. Once imported, use it like any of your own blueprints to generate content.

Reference

list_content_categories

Returns all content categories available to your team. Categories organize blueprints and content by type (e.g. GTM Strategy, Product Launch, etc).

list_targeting_dimensions

Returns targeting dimensions and their options for the current team. Dimensions are categories (e.g. Buying Stage, Persona) with selectable options used to target content generation.

Content

create_content

Create content by supplying your own text directly, generating from an AI prompt, or generating from a blueprint. With content: synchronous, saves directly. With instructions: synchronous (1-3 min), returns content. With instructions + blueprint_uuid: async, returns generation_id to poll via get_generation_status.

get_generation_status

Check the status of an async content generation. Call this after create_content (with blueprint_uuid), which returns a generation_id.

list_content

Returns all content visible to the current user as a single unified array. Content created from scratch and from blueprints are merged with consistent field names.

get_content

Retrieves the full content of a specific document by its content_id (UUID).

update_content

Update a content document (canvas or deliverable) by content_id. Partial-update — omit fields to leave them unchanged.

Sharing

create_external_share

Creates a public share link for content, with optional expiration. Accessible publicly without a Marcora account.

convert_markdown_to_word_doc

Export a markdown document as a downloadable Word (.docx) file. Returns a download URL.

Projects

list_projects

Returns all projects visible to the current user. Projects organize content into workstreams.

get_project

Returns details for a specific project including its members, documents, context items, and (when set) a project brief shortcut so the brief is directly addressable for follow-up edits.

create_project

Create a new project for organizing content and context into a workstream. Optionally generates a project brief document in the same call.

update_project

Update mutable fields on an existing project (name, visibility, status, project brief).

Scroll to Top