Agentic Platform
Documentation API reference Tools Skills

Tools

Project Memory

project_metadata MCP Content

Get or patch information about the project (tone of voice, website description...)

Store and retrieve key project metadata, such as tone of voice, website description, and internationalization strategy, to ensure consistency across content and SEO efforts. This agent helps maintain alignment by using stored data to generate relevant, on-brand outputs.

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
method required Method to execute: 'get' or 'patch'
keys required The metadata keys to retrieve or store brand_name website_description internationalization_strategy tone_of_voice currency revenue_per_visit_desktop revenue_per_visit_tablet revenue_per_visit_mobile
values The values to store for given keys, for patch only.It must be the same length as keys and all values must be strings, including numeric ones.

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
Properties
method string required

Method to execute: 'get' or 'patch'

Values: get patch

keys array required

The metadata keys to retrieve or store

Allowed values: brand_name website_description internationalization_strategy tone_of_voice currency revenue_per_visit_desktop revenue_per_visit_tablet revenue_per_visit_mobile

values array | null

The values to store for given keys, for patch only.It must be the same length as keys and all values must be strings, including numeric ones.

Default: null

Example
{
  "method": "get",
  "keys": [
    "brand_name"
  ],
  "values": null
}

Response

object
Properties
values object required

Retrieved metadata values

not_set_values array | null

Keys that were requested but not set

Default: null

message string | null

Message describing the result

Default: null

Example
{
  "values": {},
  "not_set_values": null,
  "message": null
}

Endpoints

POST http://agents.botify.com/{organization}/{project}/project_metadata/process
POST http://agents.botify.com/{organization}/{project}/project_metadata/batch_process
POST http://agents.botify.com/{organization}/{project}/project_metadata/async_process
POST http://agents.botify.com/{organization}/{project}/project_metadata/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}/project_metadata/process" \
  -H "Authorization: Bearer $BOTIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "item": {
    "method": "<method>",
    "keys": []
  }
}'

Over MCP

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

Raw metadata