Tool Reference

CIN MCP provides 90 tools, grouped by product below. New tools are added as Content Intelligence grows; your AI client shows the current list when it connects.

How to read this page

• Read tools only look things up. Clients may run them without asking.
• Change tools create or change something (an agent, a job, an upload, a conversation). Most clients ask the user before running them.
• Change (destructive) tools delete or overwrite something. Treat them with care in demos.
• Tools whose names contain _ui_ are helpers for interactive views (MCP Apps) in clients that can display them. Users don't call them directly.
• Every tool runs as the signed-in user, with that user's Hyland permissions and tenant. Nothing is shared between users.

Summary

Area	Tools	Read	Change	What it's for
Agent Builder	32	17	15	Build, configure, run and monitor AI agents (RAG, Graph RAG, tool, task and multi-agent), including guardrails, async runs and registered MCP servers.
Content Lake	34	30	4	Find, browse, read and query documents, metadata and knowledge graphs stored in Content Lake.
Enterprise Search	1	1	0	One hybrid search across Content Lake passages, full text and metadata.
Knowledge Discovery	5	3	2	Ask questions of Discovery agents in multi-turn conversations, with citations.
Trace Observability	18	18	0	Inspect agent traces, sessions, latency, evaluations and run metrics.

---

Agent Builder

Build, configure, run and monitor AI agents (RAG, Graph RAG, tool, task and multi-agent), including guardrails, async runs and registered MCP servers.

Tool	Type	What it does
agent_builder_cancel_run Cancel Agent Builder run	Change	Request cancellation of an async run.
agent_builder_create_agent Create Agent Builder agent	Change	Create a new agent in Agent Builder.
agent_builder_create_run Start Agent Builder agent run (async)	Change	Start an agent asynchronously and return at once with a run id.
agent_builder_create_version Create Agent Builder agent version	Change	Create an agent version from a complete configuration object.
agent_builder_delete_agent Delete Agent Builder agent	Change (destructive)	Delete an agent permanently.
agent_builder_delete_mcp_server Delete Agent Builder MCP server	Change (destructive)	Delete an Agent Builder MCP server registration. Stored credentials are not exposed.
agent_builder_get_agent Get Agent Builder agent	Read	Get an agent and a complete version configuration; omitting version_id uses latest.
agent_builder_get_agent_settings Get Agent Builder agent settings	Read	Get runtime tracing, evaluation, and solution-key settings for an agent.
agent_builder_get_mcp_server Get Agent Builder MCP server	Read	Get one Agent Builder MCP server registration without credential material.
agent_builder_get_run Get Agent Builder run	Read	Get an async run's status, and its output or error once finished.
agent_builder_get_version Get Agent Builder agent version	Read	Get one agent version and its complete configuration.
agent_builder_invoke_agent Invoke Agent Builder agent	Change	Invoke an agent with a message and get its response (non-streaming).
agent_builder_invoke_agent_stream Invoke Agent Builder agent (streaming)	Change	Invoke an agent and collect its output deltas and tool calls as they stream.
agent_builder_invoke_task_agent Invoke Agent Builder task agent	Change	Invoke a Task agent with structured inputs.
agent_builder_list_agent_types List Agent Builder agent types	Read	List Agent Builder agent types and their supported configuration.
agent_builder_list_agents List Agent Builder agents	Read	List Agent Builder agents with IDs, types, status, and pagination metadata.
agent_builder_list_guardrails List Agent Builder guardrails	Read	List the guardrails that can be applied to agents and invocations.
agent_builder_list_mcp_server_tools List Agent Builder MCP server tools	Read	List tools discovered from a registered Agent Builder MCP server.
agent_builder_list_mcp_servers List Agent Builder MCP servers	Read	List MCP servers registered with Agent Builder. Credentials are never returned.
agent_builder_list_models List Agent Builder models	Read	List supported LLM models, optionally filtered by agent type.
agent_builder_list_runs List Agent Builder runs	Read	List an agent's async runs, optionally only those with one status.
agent_builder_list_versions List Agent Builder agent versions	Read	List versions of an agent.
agent_builder_patch_agent Rename or redescribe Agent Builder agent	Change (destructive)	Change an agent's name or description without creating a version.
agent_builder_register_mcp_server Register Agent Builder MCP server	Change	Register a remote MCP server.
agent_builder_ui_get_agent Agent card for the agents view	Read	UI helper for the agent catalogue view: one agent's card details.
agent_builder_ui_get_mcp_tools An MCP server's tools for the agent view	Read	UI helper for the agent view: the tools a registered MCP server offers.
agent_builder_ui_get_topology Sub-agents, tools and MCP servers for the agent view	Read	UI helper for the agent view: the agent, its sub-agents, tools and MCP servers.
agent_builder_update_agent Update Agent Builder agent (new version)	Change	Update an agent by creating a new version with changes.
agent_builder_update_agent_settings Update Agent Builder agent settings	Change (destructive)	Partially update an agent's runtime settings.
agent_builder_update_mcp_server Update Agent Builder MCP server	Change (destructive)	Update non-secret fields of an Agent Builder MCP server registration.
agent_builder_validate_mcp_server Validate Agent Builder MCP server	Change	Validate connectivity and tool discovery for a registered MCP server.
agent_builder_wait_for_run Wait for Agent Builder run	Read	Poll a run until it is completed, failed or cancelled, bounded by MCP_MAX_POLL_SECONDS.

---

Content Lake

Find, browse, read and query documents, metadata and knowledge graphs stored in Content Lake.

Tool	Type	What it does
content_lake_create_graph_database Create Content Lake graph database	Change	Create a persistent v2 graph database; this is a non-idempotent product write.
content_lake_create_ontology Create Content Lake ontology	Change	Create a persistent ontology from typed YAML text.
content_lake_download_document Download Content Lake document	Read	Download document binary content.
content_lake_get_document Get Content Lake document metadata	Read	Get metadata for a specific document by ID, without downloading its binary.
content_lake_get_embeddings Get Content Lake document chunks	Read	Get the stored text chunks (embedding chunks) of a document, in document order.
content_lake_get_graph_config Get Content Lake graph configuration	Read	Get graph configuration including ontology routes.
content_lake_get_graph_database Get Content Lake graph database	Read	Get one Content Lake v2 graph database by identifier.
content_lake_get_graph_rebuild Get Content Lake graph rebuild	Read	Get a graph rebuild job by its opaque ID, such as kgRebuild:<uuid>.
content_lake_get_ontology Get Content Lake ontology	Read	Get ontology metadata by UUID; presigned download URLs are redacted.
content_lake_glob Find Content Lake paths by pattern	Read	Find files and folders whose names contain a safely escaped literal substring.
content_lake_graph_audit Audit Content Lake graph	Read	Audit graph readiness, provenance, joins, hubs, and caller-defined count gates.
content_lake_graph_context Get Content Lake graph context	Read	Return compact graph context suitable for Graph RAG planning.
content_lake_graph_query Query Content Lake graph	Read	Execute a bounded read-only GraphQL+- query against a graph database.
content_lake_graph_schema Get Content Lake graph schema	Read	Inspect graph schema predicates and types.
content_lake_list_entries List Content Lake folder entries	Read	List files and folders below a parent ID, optionally including all descendants.
content_lake_list_folders List Content Lake folders	Read	Browse folder hierarchy in Content Lake, one page at a time.
content_lake_list_graph_databases List Content Lake graph databases	Read	List Content Lake v2 graph databases and identifiers.
content_lake_list_graph_rebuilds List Content Lake graph rebuilds	Read	List graph rebuild jobs, optionally filtered by state.
content_lake_list_ontologies List Content Lake ontologies	Read	List graph ontologies available for graph-database routes.
content_lake_metadata_fields List Content Lake metadata fields	Read	Discover indexed ingest-metadata field names and their document counts.
content_lake_metadata_search Search Content Lake metadata	Read	Find files by safely escaped schemaless metadata predicates.
content_lake_metadata_values List Content Lake metadata values	Read	List common indexed values and counts for one validated ingest-metadata field.
content_lake_query_documents Query Content Lake documents (HXQL)	Read	Search Content Lake using HXQL query language.
content_lake_read_document Read Content Lake document text	Read	Read a service-generated markdown rendition with bounded, numbered lines.
content_lake_search_fulltext Full-text search Content Lake	Read	Full-text search across all documents in Content Lake, best matches first.
content_lake_set_graph_routes Replace Content Lake graph routes	Change (destructive)	Replace every ontology route for a graph database.
content_lake_start_graph_rebuild Start Content Lake graph rebuild	Change	Start a non-idempotent graph rebuild job and return its job identifier.
content_lake_ui_browse Folder or document for the browser view	Read	UI helper for the Content Lake browser: open a folder or a document.
content_lake_ui_get_ontology Ontology structure for the ontology view	Read	UI helper for the ontology view: the deployed ontology's structure.
content_lake_ui_graph_neighborhood Document connections for the graph views	Read	UI helper for document connections: documents and objects linked by one value.
content_lake_ui_graph_overview Graph overview for the graph views	Read	UI helper for the knowledge-graph overview: statistics, health and routes.
content_lake_ui_read_document Document page for the reader view	Read	UI helper for the document reader: one page of a document's markdown.
content_lake_validate_ontology Validate Content Lake ontology	Read	Validate ontology YAML locally without creating a product resource.
content_lake_wait_for_graph_rebuild Wait for Content Lake graph rebuild	Read	Poll a graph rebuild to a terminal state within the configured maximum wait.

---

Enterprise Search

One hybrid search across Content Lake passages, full text and metadata.

Tool	Type	What it does
enterprise_search Enterprise search	Read	Hybrid enterprise search over Content Lake files: passages, full text and metadata.

---

Knowledge Discovery

Ask questions of Discovery agents in multi-turn conversations, with citations.

Tool	Type	What it does
knowledge_discovery_continue_conversation Continue Knowledge Discovery conversation	Change	Continue an existing conversation with a follow-up question.
knowledge_discovery_get_citations Get Knowledge Discovery citations	Read	Get a conversation message with its source document references.
knowledge_discovery_list_agents List Knowledge Discovery agents	Read	List agents that can be used with Knowledge Discovery conversations.
knowledge_discovery_list_messages List Knowledge Discovery messages	Read	List the messages in a conversation.
knowledge_discovery_start_conversation Start Knowledge Discovery conversation	Change	Start a new multi-turn conversation with an opening question.

---

Trace Observability

Inspect agent traces, sessions, latency, evaluations and run metrics.

Tool	Type	What it does
trace_evaluation_baseline Get trace evaluation baseline	Read	Get evaluation baseline scores for a product, optionally narrowed to one agent.
trace_evaluation_dashboard Get trace evaluation dashboard	Read	Get aggregated evaluation metrics by time bucket and evaluation name.
trace_evaluations List trace evaluations	Read	List evaluation names, scores, labels, and explanations attached to one trace.
trace_get Get trace	Read	Get one complete trace; system prompts are excluded by default.
trace_get_product Get trace product	Read	Get metadata for one Trace Observability product.
trace_get_span Get trace span	Read	Get one span and its recorded attributes; system prompts are excluded by default.
trace_latency Get trace latency	Read	Get wall-clock latency allocation by span kind plus the slowest span.
trace_list_products List trace products	Read	List Trace products visible to the caller and use their product_id in other tools.
trace_list_session_traces List traces in session	Read	List traces belonging to one session; reuse next_cursor for the next page.
trace_list_sessions List trace sessions	Read	List trace sessions with validated time, agent, cursor, and pagination filters.
trace_replay Replay trace steps	Read	Get ordered execution steps and timing; system prompts are excluded by default.
trace_run_metrics Get trace run metrics	Read	Get aggregated Agent Builder run KPIs and per-agent error metrics.
trace_scorecard Get trace scorecard	Read	Build a bounded scorecard summary from a page of traces.
trace_search Search traces	Read	Search compact trace records using OpenAPI-defined filters and cursor pagination.
trace_spans List trace spans	Read	List typed spans for one trace; system-role LLM inputs are excluded by default.
trace_summary Summarize trace	Read	Get compact status, error, timing, agent, and evaluation data for one trace.
trace_ui_find_trace Trace behind an answer for the answer view	Read	UI helper for "How was this answered?": the trace behind an answer.
trace_ui_get_trace Trace detail for the traces view	Read	UI helper for the trace explorer: one trace's spans, latency and evaluations.