Productos AI

Tool reference

The 67 tools of the management MCP, grouped by area.

You don't need to call them by name: the chatbot picks the tool from what you ask. This reference shows what's possible.

Read tools are on every plan. Write tools only appear with full access (see Permissions and plans).

Agents#

ToolTypeWhat it does
list_agentsReadLists the agents with their published version and latest saved one
get_agentReadShows an agent: draft, versions, published version, and quality gate
create_agentWriteCreates an agent with a default draft
update_agentWriteChanges the name or description
archive_agentWriteArchives an agent: it stops serving customers
restore_agentWriteRestores an archived agent
get_agent_draftReadShows the draft
update_agent_draftWriteChanges only the given settings of the draft
validate_agent_draftReadChecks the draft against the workspace and the plan
save_agent_versionWriteSaves the draft as a new version
publish_agent_versionWritePublishes a version to your customers
list_agent_versionsReadLists the saved versions
get_agent_versionReadShows a version
get_system_promptReadShows the final prompt of the draft or a version
get_context_usageReadEstimates how much context each part takes
list_modelsReadLists the models with their context window and price in credits
get_model_supportReadShows which efforts, caching, and credentials a model supports
get_planReadShows your plan's limits, features, and credits

Instructions#

ToolTypeWhat it does
list_instruction_setsReadLists the instruction sets
get_instruction_setReadShows one with its latest version in full
create_instruction_setWriteCreates new instructions (version 1)
add_instruction_versionWriteAdds a version with the new text
validate_instruction_setReadChecks for errors and warnings
archive_instruction_setWriteArchives a set

Quality tests#

ToolTypeWhat it does
list_eval_datasetsReadLists the test datasets
get_eval_datasetReadShows a dataset
create_eval_datasetWriteCreates 1 to 200 test cases
add_eval_dataset_versionWriteAdds a version with the new list of cases
archive_eval_datasetWriteArchives a set
list_eval_suitesReadLists the suites
get_eval_suiteReadShows a suite
create_eval_suiteWriteCreates a suite: cases, evaluators, and pass threshold
add_eval_suite_versionWriteAdds a version of the suite
archive_eval_suiteWriteArchives a suite
run_evaluationWriteEvaluates a saved version with a suite (spends credits)
get_evaluationReadShows the result, case by case
list_evaluationsReadLists an agent's evaluations
cancel_evaluationWriteCancels a running evaluation
set_quality_gateWriteRequires a passed suite before publishing
remove_quality_gateWriteRemoves that requirement

HTTP tools#

ToolTypeWhat it does
list_http_toolsReadLists the HTTP tools
get_http_toolReadShows a tool
create_http_toolWriteCreates a tool that calls an endpoint
add_http_tool_versionWriteAdds a version
test_http_toolReadShows the request it would send, without sending it
archive_http_toolWriteArchives a tool

MCP connections#

ToolTypeWhat it does
list_mcp_connectionsReadLists the connections
get_mcp_connectionReadShows a connection and its last test
create_mcp_connectionWriteConnects a server without authentication. If it needs a token or OAuth, returns the console link
test_mcp_connectionWriteTests the connection and discovers its tools
list_mcp_connection_toolsReadLists the server's tools
archive_mcp_connectionWriteArchives a connection

Skills#

ToolTypeWhat it does
list_skillsReadLists the workspace's skills
get_skillReadShows a skill
create_skillWriteCreates a skill
add_skill_versionWriteAdds a version
archive_skillWriteArchives a skill
search_skill_catalogReadSearches the Productos AI catalog
get_catalog_skillReadShows a catalog skill
copy_catalog_skillWriteCopies a catalog skill into the workspace

Knowledge#

ToolTypeWhat it does
list_knowledge_basesReadLists the bases and how many documents are indexed
get_knowledge_baseReadShows a base with its documents
create_knowledge_baseWriteCreates a base
add_knowledge_textWriteAdds a Markdown document
start_knowledge_ingestionWriteIndexes the documents
get_knowledge_ingestionReadShows the indexing progress
archive_knowledge_baseWriteArchives a base