Agentic Platform
Documentation API reference Tools Skills

Tools

Agentic Catalog Sources

agentic_catalog_sources MCP

List the AgenticCatalog sources of a project

List every source configured on a project's AgenticCatalog (Products Feeds), with its name, description, config, and destinations.

Playground

POST
item

No fields.

Credits

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
sources array required

Every source configured on the project, pulled or not. `id` is what to filter `source_id` on in the AgenticCatalog BigQuery tables; `destinations[].type` is what to filter `destination` on. Empty means the project has no AgenticCatalog.

Items: AgenticCatalogSource

Example
{
  "sources": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "config": {},
      "destinations": [
        {
          "type": "string",
          "name": "string",
          "config": {}
        }
      ]
    }
  ]
}

Type Definitions

2 types

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

AgenticCatalogDestination object
#

One destination configured on an AgenticCatalog source.

type string required

Destination type. Filter `destination` on this value in `agentic_catalog_destinations_push`. `dummy` is a no-op and never appears in that table.

name string required

Human-readable destination name.

config object required

Destination settings (credentials are masked).

AgenticCatalogSource object
#

One AgenticCatalog source configured on the project.

id string required

Source identifier. Filter `source_id` on this value in the AgenticCatalog BigQuery tables.

name string required

Human-readable source name.

description string required

Optional source description.

config object required

Source-level settings (datasource, enrichment, language, ...). Secrets are masked.

destinations array required

Destinations this source is configured to push to.

Items: AgenticCatalogDestination

Endpoints

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

Over MCP

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

Raw metadata