Agentic Platform
Documentation API reference Tools Skills

Tools

Action Board

action_board MCP

Retrieve actions from ActionBoard for your projects.

Playground

Your organization, project and token stay in this browser's local storage and are sent straight to the API — this page never sees them.

POST
item

No fields.

Billing

Fixed cost per item requested. This tool reads data Botify already holds for your project and calls no outside service, so nothing is added to the per-call price.

These usage SKUs can be charged on a call.

SKU Credits Description
Tool call 1 per request Charged once per successful item.

Schemas

item is what you send, config how the tool behaves, and the response is what you get back.

Item

object
Example
{}

Response

object
Properties
results array required

Action board results

Items: ActionBoardResult

Example
{
  "results": [
    {
      "name": "string",
      "description": "string",
      "relevance": "LOW",
      "impact_metrics": {
        "total_urls_affected": 0,
        "previous_total_urls_affected": 0,
        "active_urls_affected": 0,
        "previous_active_urls_affected": 0,
        "page_rank_impact": 0.0,
        "previous_page_rank_impact": 0.0
      },
      "canvas": [
        {
          "title": "string",
          "description": "string",
          "config": {}
        }
      ]
    }
  ]
}

Type Definitions

3 types

These are the available sub-object types that can be used in the properties above.

ActionBoardCanvas object
#
title string required
description string required
config object required
ActionBoardResult object
#
name string required
description string required
relevance string | null required
impact_metrics ImpactedMetric required

Type: ImpactedMetric

canvas array required

Items: ActionBoardCanvas

ImpactedMetric object
#
total_urls_affected integer required
previous_total_urls_affected integer | null required
active_urls_affected integer required
previous_active_urls_affected integer | null required
page_rank_impact number required
previous_page_rank_impact number | null required

Endpoints

POST http://agents.botify.com/{organization}/{project}/action_board/process
POST http://agents.botify.com/{organization}/{project}/action_board/batch_process
POST http://agents.botify.com/{organization}/{project}/action_board/async_process
POST http://agents.botify.com/{organization}/{project}/action_board/async_batch_process

See running a long job in the background for the polling flow.

cURL

curl -X POST "http://agents.botify.com/{organization}/{project}/action_board/process" \
  -H "Authorization: Bearer $BOTIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "item": {}
}'

Over MCP

This tool is exposed as the MCP tool action_board. An MCP client passes organization, project and item as tool arguments. Set up MCP →

Raw metadata