{
  "info": {
    "name": "Miro — mcp.ai",
    "description": "REST API for the Miro MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/miro",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "miro_create_board",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/board",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "board"
          ]
        },
        "description": "Tool to create a new board. use when you need to set up a board with a specific name, description, and policies. example: \"create a new board named project plan\".",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"policy\": {},\n  \"teamId\": \"\",\n  \"projectId\": \"\",\n  \"description\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "miro_delete_app_card_item",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/app/card/item",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "app",
            "card",
            "item"
          ]
        },
        "description": "Tool to delete an app card item from a board. use when you need to remove an app card item created by your app after it is no longer needed.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"item_id\": \"\",\n  \"board_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "miro_delete_document_item",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/document/item",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "document",
            "item"
          ]
        },
        "description": "Tool to delete a document item from a board. use when you need to remove a document item (e.g., pdf or image) that is no longer relevant. example: \"delete the document item with id 'item456' from boar",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"item_id\": \"\",\n  \"board_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "miro_delete_item",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/item",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "item"
          ]
        },
        "description": "Tool to delete a specific item from a board. use when you need to remove an item (e.g., shape, sticky note) after confirming its board and item ids.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"item_id\": \"\",\n  \"board_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "miro_get_app_card_item",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/app/card/item",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "app",
            "card",
            "item"
          ]
        },
        "description": "Tool to retrieve a specific app card item by its id. use when you need the details of an existing app card item.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"item_id\": \"\",\n  \"board_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "miro_get_board",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/board",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "board"
          ]
        },
        "description": "Tool to retrieve details of a specific board. use when you have a board id and need to fetch its metadata.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"board_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "miro_get_board_members",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/board/members",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "board",
            "members"
          ]
        },
        "description": "Tool to retrieve a list of members for a board. use when you need to list all users with access to a board after confirming its id.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"cursor\": \"\",\n  \"board_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "miro_get_boards",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/boards",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "boards"
          ]
        },
        "description": "Tool to retrieve accessible boards with optional filters. use when you need to list or search boards by team, project, owner, or keywords.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"sort\": \"\",\n  \"limit\": 0,\n  \"owner\": \"\",\n  \"query\": \"\",\n  \"offset\": 0,\n  \"team_id\": \"\",\n  \"project_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "miro_get_connectors",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/connectors",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "connectors"
          ]
        },
        "description": "Tool to retrieve a list of connectors on a board. use after confirming the board id and when you need to page through connector items.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"cursor\": \"\",\n  \"board_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "miro_get_tag",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/tag",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "tag"
          ]
        },
        "description": "Tool to retrieve details of a specific tag on a board. use when you have a board id and tag id and need its metadata.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"tag_id\": \"\",\n  \"board_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "miro_list_organizations",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/organizations",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "organizations"
          ]
        },
        "description": "Tool to retrieve list of organizations accessible to the user. use when you need to view all available organizations.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "miro_miro_create_app_card_item",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/miro/create/app/card/item",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "miro",
            "create",
            "app",
            "card",
            "item"
          ]
        },
        "description": "Tool to add an app card item to a board. use when you need to push a rich preview card with custom fields into a miro board (e.g., after assembling card data).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"data\": {},\n  \"style\": {},\n  \"parent\": {},\n  \"board_id\": \"\",\n  \"geometry\": {},\n  \"position\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "miro_update_app_card_item",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/app/card/item",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "app",
            "card",
            "item"
          ]
        },
        "description": "Tool to update an app card item on a board. use when you need to modify properties of an existing app card item. include only fields to change.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"data\": {},\n  \"style\": {},\n  \"parent\": {},\n  \"item_id\": \"\",\n  \"board_id\": \"\",\n  \"geometry\": {},\n  \"position\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "miro_update_board",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/board",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "board"
          ]
        },
        "description": "Tool to update properties of a specific board. use when you have a board id and need to modify its name, description, or permissions policy. use after confirming the board exists.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"policy\": {},\n  \"teamId\": \"\",\n  \"board_id\": \"\",\n  \"projectId\": \"\",\n  \"description\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}