Skip to content

Add Cortex Agents REST API and managed MCP server documentation#194

Open
iamontheinet wants to merge 1 commit intoandrewyng:mainfrom
iamontheinet:add-snowflake-cortex-agents-docs
Open

Add Cortex Agents REST API and managed MCP server documentation#194
iamontheinet wants to merge 1 commit intoandrewyng:mainfrom
iamontheinet:add-snowflake-cortex-agents-docs

Conversation

@iamontheinet
Copy link
Copy Markdown
Contributor

Summary

Adds two new Snowflake documentation entries under content/snowflake/docs/:

  • cortex-agents-rest-api — REST API for creating, managing, and running Cortex Agent objects with built-in tools (Cortex Analyst, Cortex Search, web search, SQL execution) and custom UDF/stored procedure tools
  • cortex-agents-mcp — Snowflake-managed MCP (Model Context Protocol) server for exposing Cortex Analyst, Cortex Search, Cortex Agents, SQL execution, and custom tools over the MCP standard with OAuth auth and RBAC governance

Directory structure

content/snowflake/docs/
├── cortex-agents-rest-api/DOC.md   (269 lines)
└── cortex-agents-mcp/DOC.md        (215 lines)

Validation

$ chub build content/ --validate-only
Valid: 1555 docs, 7 skills, 2 warnings

(2 pre-existing warnings from landingai skills — 0 new warnings from this PR)

Test plan

  • Verify node cli/bin/chub build content/ --validate-only passes with 0 new warnings
  • Confirm YAML frontmatter matches expected schema (name, description, metadata fields)
  • Check each DOC.md is under 500 lines (269 + 215 = 484 total)
  • Verify directory structure follows content/<company>/docs/<product>/DOC.md convention

…notice on Analyst

Two new Snowflake docs under content/snowflake/docs/:
- cortex-agents-rest-api: Create, manage, and run Cortex Agent objects via REST API with built-in tools (Analyst, Search, web search, SQL exec) and custom UDF/SP tools
- cortex-agents-mcp: Snowflake-managed MCP server for exposing Cortex tools over the Model Context Protocol standard with OAuth auth and RBAC governance

Also updates cortex-analyst/DOC.md:
- Adds deprecation banner pointing to Cortex Agents as the successor
- Updates description and tags to reflect deprecated status
- Bumps revision to 2

Validation: 1555 docs, 0 new warnings.
@iamontheinet iamontheinet force-pushed the add-snowflake-cortex-agents-docs branch from 79421e4 to d83b5e5 Compare March 24, 2026 15:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant