
## Docs-over-MCP tools

URL: https://docs.atlan.com/agents/references/docs-over-mcp-tools

> Reference for all five tools exposed by Atlan docs over MCP: what each tool does, its inputs, and when to use it.

Atlan docs over MCP exposes five tools. Each tool is scoped to a specific type of documentation retrieval. Agents load only what they need, not the entire documentation set.

## `search_docs`

Search Atlan documentation by keyword or concept. Returns ranked results with titles, paths, URLs, and excerpts. Call this first to find relevant pages, then use `get_page` to retrieve full content.

**Examples**

- `search_docs("lineage configuration dbt")`: finds pages about configuring lineage for the dbt connector, returns paths and excerpts to narrow down which page to fetch next
- `search_docs("Persona access control data product")`: surfaces governance pages about Personas, Policies, and how they interact with Data Products
- `search_docs("crawler fails authentication error")`: finds troubleshooting pages for crawler authentication issues across connectors
- `search_docs("what metadata does Atlan crawl from Tableau")`: returns the Tableau reference pages that list what Atlan extracts

---

## `get_page`

Fetch the full Markdown content of a documentation page by its path. Large pages are split into 8,000-character chunks. If the response indicates more chunks are available, call again with `chunk` incremented.

**Examples**

- `get_page("/apps/connectors/data-warehouses/snowflake/how-tos/set-up-snowflake")`: full Snowflake setup guide with user creation SQL, required grants, and TCPS configuration
- `get_page("/apps/connectors/data-warehouses/snowflake/how-tos/crawl-snowflake")`: Snowflake crawler configuration with extraction methods, connection fields, and schedule options
- `get_page("/product/capabilities/governance/access-control/how-tos/create-a-persona")`: step-by-step guide to creating a Persona, setting scope, and attaching Policies
- `get_page("/product/capabilities/lineage/how-tos/configure-query-lineage")`: query lineage setup guide with SQL activity mining and miner configuration
- `get_page("/apps/connectors/data-warehouses/snowflake/how-tos/set-up-snowflake", chunk=1)`: second chunk when the first response says more parts are available

---

## `get_feature_guide`

Fetch the full index for a connector or feature area. Returns the table of contents for that area with sections and links to specific pages, so the agent can navigate to exactly what it needs.

**Examples**

- `get_feature_guide("connectors/snowflake")`: Snowflake index with Required permissions, Setup options, Crawl and mine, Reference, and Troubleshooting sections, each linking to specific pages
- `get_feature_guide("connectors/dbt")`: dbt connector index with authentication setup, project configuration, lineage generation, and job run crawling
- `get_feature_guide("connectors/tableau")`: Tableau index with site configuration, workbook crawling, and embedded datasource extraction
- `get_feature_guide("connectors/google-bigquery")`: BigQuery index with service account setup, dataset permissions, and column-level lineage
- `get_feature_guide("governance/access-control")`: Personas and Policies feature guide with sections on creating Personas, attaching Policies, and masking rules
- `get_feature_guide("governance/data-quality")`: Data Quality Studio guide with Snowflake DQ setup, rules, scheduling, and monitoring
- `get_feature_guide("catalog/lineage")`: Lineage feature guide with query lineage, ETL lineage, manual lineage, and lineage propagation

---

## `get_preflight_requirements`

Fetch the required permissions, roles, and network access needed before setting up a specific connector. Returns the preflight checks page directly, with no need to navigate the full connector guide first.

**Examples**

- `get_preflight_requirements("snowflake")`: Snowflake user creation SQL (`CREATE USER`, `GRANT CREATE SESSION`), required grants (`SELECT_CATALOG_ROLE`, `DBA_TABLES`), optional TCPS wallet setup
- `get_preflight_requirements("google-bigquery")`: BigQuery service account creation, required IAM roles (`bigquery.dataViewer`, `bigquery.jobUser`), project-level permissions
- `get_preflight_requirements("dbt")`: dbt Cloud API token requirements, account ID location, job permissions needed
- `get_preflight_requirements("tableau")`: Tableau site role requirements, personal access token setup, REST API access
- `get_preflight_requirements("oracle")`: Oracle dedicated user creation, `SELECT_CATALOG_ROLE`, DBA view grants, TCPS wallet for encrypted connections
- `get_preflight_requirements("microsoft-sql-server")`: SQL Server login creation, `VIEW DEFINITION`, `VIEW DATABASE STATE` grants, firewall rules

---

## `get_concept`

Fetch the precise Atlan definition and usage context for an Atlan-specific term. Uses Atlan's own vocabulary, not generic equivalents.

**Examples**

- `get_concept("Persona")`: a named access profile that controls what data a group of users can see and interact with; not a "role" or "permission group"
- `get_concept("Policy")`: a rule attached to a Persona that grants specific permissions on specific assets or domains; not a "permission" or "access rule"
- `get_concept("Lineage")`: Atlan distinguishes query lineage (SQL activity mining via the miner) from ETL lineage (ingested by a pipeline connector); not a generic data flow diagram
- `get_concept("Domain")`: a business-owned grouping of data assets like "Marketing" or "Finance"; not a folder, tag, or schema
- `get_concept("Classification")`: a tag applied to sensitive data for governance enforcement (for example, PII, Confidential) that propagates downstream through lineage by default
- `get_concept("Glossary Term")`: a business definition linked to one or more assets; not a generic tag or label
- `get_concept("Asset")`: any data object in Atlan (table, column, dashboard, pipeline, model, or file); don't substitute "resource" or "object"

---

## See also

- [Set up docs over MCP](https://docs.atlan.com/llms/platform/agents/set-up-docs-over-mcp/llms.txt): Add Atlan docs over MCP to your AI tool

---
