home / mcp / businessmap mcp server

BusinessMap MCP Server

Model Context Protocol server enabling comprehensive BusinessMap integration with 56 tools, 5 resources, and 4 prompts.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "edicarloslds-businessmap-mcp": {
      "url": "http://your-server:3000/mcp",
      "headers": {
        "LOG_LEVEL": "1",
        "BUSINESSMAP_API_URL": "https://your-account.kanbanize.com/api/v2",
        "BUSINESSMAP_API_TOKEN": "your_token_here",
        "BUSINESSMAP_READ_ONLY_MODE": "false",
        "BUSINESSMAP_DEFAULT_WORKSPACE_ID": "1"
      }
    }
  }
}

You can run the BusinessMap MCP Server to access BusinessMap project management data and operations through a Model Context Protocol interface. This server exposes a rich set of tools, resources, and prompts to integrate BusinessMap with your AI workflows and automation pipelines, enabling programmatic workspaces, boards, cards, and more.

How to use

To use the BusinessMap MCP Server with an MCP client, start by choosing your preferred deployment method. You can run a local MCP server using a fast inline command, or run a remote HTTP endpoint that your client connects to. Once the server is running, connect your MCP client to the HTTP endpoint or invoke the local process via the standard MCP protocol. The server exposes a wide range of operations for managing workspaces, boards, cards, subtasks, relationships, comments, and more, enabling you to automate common project management tasks and to query structured data.

How to install

Follow these concrete steps to get started with the MCP server in a local development environment.

# Install and run via NPX (recommended for quick start)
npx @edicarlos.lds/businessmap-mcp

# Or install globally for easy reuse
npm install -g @edicarlos.lds/businessmap-mcp

Available tools

list_workspaces

Retrieve all workspaces available to the API token.

get_workspace

Fetch details for a specific workspace by ID.

create_workspace

Create a new workspace with provided parameters.

list_boards

List all boards within one or more workspaces.

search_board

Find boards by ID or name using search filters.

get_current_board_structure

Get the full structure of a board including workflows and configurations.

create_board

Create a new board in a workspace (subject to read-only mode).

get_columns

List all columns for a board.

get_lanes

List all lanes (swimlanes) for a board.

get_lane

Get details for a specific lane.

create_lane

Create a new lane in a board.

create_column

Create a new column on a board, including sub-columns.

update_column

Update the properties of a board column.

delete_column

Delete a column from a board.

list_cards

Get cards from a board with optional filters.

get_card

Fetch detailed information for a card.

get_card_size

Retrieve the size or points of a card.

get_card_types

Get all available card types.

create_card

Create a new card in a board.

move_card

Move a card to a different column or lane.

update_card

Update properties of a card.

set_card_size

Set the size/points for a specific card.

delete_card

Permanently delete a card.

get_card_comments

Get all comments for a card.

get_card_comment

Get details of a specific comment on a card.

create_comment

Add a new comment to a card.

update_comment

Update the text of an existing card comment.

delete_comment

Delete a comment from a card.

get_card_custom_fields

List all custom fields for a card.

get_card_outcomes

Get all outcomes for a card.

get_card_history

Retrieve the history of a card's outcomes.

get_card_linked_cards

Get all cards linked to a specific card.

get_card_subtasks

List all subtasks for a card.

get_card_subtask

Get details of a specific subtask.

create_card_subtask

Create a new subtask for a card.

get_card_parents

List parent cards for a card.

get_card_parent

Check if a card is a parent of another card.

add_card_parent

Make a card a parent of another card.

remove_card_parent

Remove the parent-child link between cards.

get_card_parent_graph

Get a graph of parent cards including their ancestors.

get_card_children

List child cards for a parent card.

block_card

Block a card with a reason.

unblock_card

Unblock a card and clear the reason.

create_tag

Create a new tag in the workspace.

add_tag_to_card

Attach a tag to a card.

remove_tag_from_card

Detach a tag from a card.

add_sticker_to_card

Add a sticker to a card.

remove_sticker_from_card

Remove a sticker from a card by association ID.

add_predecessor

Create or update a predecessor-successor relationship between cards.

remove_predecessor

Remove a predecessor relationship between cards.

get_custom_field

Get details for a specific custom field.

get_workflow_cycle_time_columns

Retrieve cycle-time related columns for a workflow.

get_workflow_effective_cycle_time_columns

Get effective cycle-time columns for analysis.

list_users

List all users in the workspace.

get_user

Get details for a specific user.

get_current_user

Get the currently authenticated user.

invite_user

Invite a new user by email.

health_check

Check API connectivity and server health.

get_api_info

Fetch API metadata and version information.