[{"data":1,"prerenderedAt":637},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fmcp\u002Ftools":3},{"id":4,"title":5,"body":6,"description":628,"extension":629,"meta":630,"navigation":631,"path":632,"redirect":633,"seo":634,"stem":635,"__hash__":636},"docs\u002Fdocs\u002Fmcp\u002Ftools.md","MCP tools reference",{"type":7,"value":8,"toc":615},"minimark",[9,13,22,34,39,168,172,224,228,276,280,317,321,393,397,429,433,571,575,583,587],[10,11,5],"h1",{"id":12},"mcp-tools-reference",[14,15,16,17,21],"p",{},"The MCP server exposes ",[18,19,20],"strong",{},"26 tools"," to your AI assistant. You never call these directly — you describe a goal in plain language and the AI picks and chains the tools itself. This page is the plain-language map of what it can reach.",[14,23,24,27,28,33],{},[18,25,26],{},"Every tool is read-only."," Nothing here can change your data, connections, stream configs, or stream runtime state. See ",[29,30,32],"a",{"href":31},"\u002Fdocs\u002Fmcp\u002Fsafety-and-privacy","Safety & privacy"," for the full boundary.",[35,36,38],"h2",{"id":37},"database-inspection","Database inspection",[40,41,42,55],"table",{},[43,44,45],"thead",{},[46,47,48,52],"tr",{},[49,50,51],"th",{},"Tool",[49,53,54],{},"What it does",[56,57,58,70,84,94,104,114,128,138,148,158],"tbody",{},[46,59,60,67],{},[61,62,63],"td",{},[64,65,66],"code",{},"list_connections",[61,68,69],{},"Lists your connections (name, type, ID) — never DSNs or passwords.",[46,71,72,77],{},[61,73,74],{},[64,75,76],{},"get_connection",[61,78,79,80,83],{},"Detail for one connection: host, port, username, default database, SSL\u002FSSH topology — ",[18,81,82],{},"never"," the password, SSH private key, or cloud keys (S3\u002FGCS\u002FAzure access keys, tokens, service-account JSON).",[46,85,86,91],{},[61,87,88],{},[64,89,90],{},"list_databases",[61,92,93],{},"Databases on a connection (system databases hidden unless asked).",[46,95,96,101],{},[61,97,98],{},[64,99,100],{},"list_schemas",[61,102,103],{},"Schemas inside a database (system schemas hidden unless asked).",[46,105,106,111],{},[61,107,108],{},[64,109,110],{},"list_tables",[61,112,113],{},"Tables in a database, optionally filtered by schema.",[46,115,116,121],{},[61,117,118],{},[64,119,120],{},"describe_table",[61,122,123,124,127],{},"Columns, indexes, primary\u002Fforeign keys, and ",[64,125,126],{},"CREATE TABLE"," DDL for a table.",[46,129,130,135],{},[61,131,132],{},[64,133,134],{},"preview_table",[61,136,137],{},"A bounded sample of rows (default 100, max 1000), with optional ordering and offset.",[46,139,140,145],{},[61,141,142],{},[64,143,144],{},"list_views",[61,146,147],{},"Views in a database (separate from tables), optionally filtered by schema.",[46,149,150,155],{},[61,151,152],{},[64,153,154],{},"describe_view",[61,156,157],{},"A view's columns, defining SQL, materialized flag, and dependencies.",[46,159,160,165],{},[61,161,162],{},[64,163,164],{},"preview_view",[61,166,167],{},"A bounded sample of view rows (default 100, max 1000).",[35,169,171],{"id":170},"files-s3","Files & S3",[40,173,174,182],{},[43,175,176],{},[46,177,178,180],{},[49,179,51],{},[49,181,54],{},[56,183,184,194,204,214],{},[46,185,186,191],{},[61,187,188],{},[64,189,190],{},"list_files",[61,192,193],{},"Lists local files\u002Fdirectories (CSV, JSON, JSONL, Parquet) from a path or a files-type connection.",[46,195,196,201],{},[61,197,198],{},[64,199,200],{},"get_file_schema",[61,202,203],{},"Detected schema, row-count estimate, and optional column statistics for a data file.",[46,205,206,211],{},[61,207,208],{},[64,209,210],{},"list_s3_buckets",[61,212,213],{},"Lists the S3 buckets reachable with a stored S3 connection's credentials.",[46,215,216,221],{},[61,217,218],{},[64,219,220],{},"list_s3_objects",[61,222,223],{},"Lists objects and sub-folder prefixes under an S3 bucket\u002Fprefix, with pagination.",[35,225,227],{"id":226},"query","Query",[40,229,230,238],{},[43,231,232],{},[46,233,234,236],{},[49,235,51],{},[49,237,54],{},[56,239,240,262],{},[46,241,242,247],{},[61,243,244],{},[64,245,246],{},"run_select",[61,248,249,250,253,254,257,258,261],{},"Runs one bounded ",[64,251,252],{},"SELECT"," \u002F ",[64,255,256],{},"WITH ... SELECT"," against a connection. Returns rows plus measured ",[64,259,260],{},"executionMs",". Rejects anything that isn't a single read-only query.",[46,263,264,269],{},[61,265,266],{},[64,267,268],{},"explain_select",[61,270,271,272,275],{},"Runs ",[64,273,274],{},"EXPLAIN"," for a query (Postgres \u002F MySQL \u002F DuckDB), returning the plan plus parsed top-of-plan metrics.",[35,277,279],{"id":278},"federated-query-cross-source","Federated query (cross-source)",[40,281,282,290],{},[43,283,284],{},[46,285,286,288],{},[49,287,51],{},[49,289,54],{},[56,291,292,305],{},[46,293,294,299],{},[61,295,296],{},[64,297,298],{},"run_federated_select",[61,300,301,302,304],{},"One ",[64,303,252],{}," spanning multiple sources — databases, local files, and S3 — joined in a single query.",[46,306,307,312],{},[61,308,309],{},[64,310,311],{},"explain_federated_select",[61,313,314,316],{},[64,315,274],{}," for a federated query, to sanity-check the cross-source join plan before running it.",[35,318,320],{"id":319},"streams","Streams",[40,322,323,331],{},[43,324,325],{},[46,326,327,329],{},[49,328,51],{},[49,330,54],{},[56,332,333,343,353,363,373,383],{},[46,334,335,340],{},[61,336,337],{},[64,338,339],{},"list_streams",[61,341,342],{},"Lists your stream configs (name, mode, source\u002Ftarget connection IDs).",[46,344,345,350],{},[61,346,347],{},[64,348,349],{},"get_stream",[61,351,352],{},"Full config for one stream: source tables, target shape, write mode, schema policy, per-table filters.",[46,354,355,360],{},[61,356,357],{},[64,358,359],{},"get_stream_status",[61,361,362],{},"Latest known status from runtime snapshots or run history.",[46,364,365,370],{},[61,366,367],{},[64,368,369],{},"get_stream_stats",[61,371,372],{},"Latest throughput\u002Frow statistics snapshot.",[46,374,375,380],{},[61,376,377],{},[64,378,379],{},"get_stream_recent_errors",[61,381,382],{},"Recent error-level log entries for a stream (secrets redacted).",[46,384,385,390],{},[61,386,387],{},[64,388,389],{},"get_stream_recent_logs",[61,391,392],{},"Recent log entries with an optional level filter (secrets redacted).",[35,394,396],{"id":395},"comparison","Comparison",[40,398,399,407],{},[43,400,401],{},[46,402,403,405],{},[49,404,51],{},[49,406,54],{},[56,408,409,419],{},[46,410,411,416],{},[61,412,413],{},[64,414,415],{},"compare_schemas",[61,417,418],{},"Compares two table schemas across connections; flags blockers and warnings for migration\u002FCDC.",[46,420,421,426],{},[61,422,423],{},[64,424,425],{},"compare_data_sample",[61,427,428],{},"Compares bounded sample rows across two tables, matched by key columns or row order.",[35,430,432],{"id":431},"at-a-glance","At a glance",[40,434,435,448],{},[43,436,437],{},[46,438,439,442,445],{},[49,440,441],{},"Category",[49,443,444],{},"Count",[49,446,447],{},"Tools",[56,449,450,480,497,510,523,544,556],{},[46,451,452,454,457],{},[61,453,38],{},[61,455,456],{},"10",[61,458,459,461,462,461,464,461,466,461,468,461,470,461,472,461,474,461,476,461,478],{},[64,460,66],{},", ",[64,463,76],{},[64,465,90],{},[64,467,100],{},[64,469,110],{},[64,471,120],{},[64,473,134],{},[64,475,144],{},[64,477,154],{},[64,479,164],{},[46,481,482,484,487],{},[61,483,171],{},[61,485,486],{},"4",[61,488,489,461,491,461,493,461,495],{},[64,490,190],{},[64,492,200],{},[64,494,210],{},[64,496,220],{},[46,498,499,501,504],{},[61,500,227],{},[61,502,503],{},"2",[61,505,506,461,508],{},[64,507,246],{},[64,509,268],{},[46,511,512,515,517],{},[61,513,514],{},"Federated query",[61,516,503],{},[61,518,519,461,521],{},[64,520,298],{},[64,522,311],{},[46,524,525,527,530],{},[61,526,320],{},[61,528,529],{},"6",[61,531,532,461,534,461,536,461,538,461,540,461,542],{},[64,533,339],{},[64,535,349],{},[64,537,359],{},[64,539,369],{},[64,541,379],{},[64,543,389],{},[46,545,546,548,550],{},[61,547,396],{},[61,549,503],{},[61,551,552,461,554],{},[64,553,415],{},[64,555,425],{},[46,557,558,563,568],{},[61,559,560],{},[18,561,562],{},"Total",[61,564,565],{},[18,566,567],{},"26",[61,569,570],{},"all read-only",[35,572,574],{"id":573},"whats-deliberately-not-here","What's deliberately not here",[14,576,577,578,582],{},"No tool — by any path — writes data, changes configuration, runs arbitrary SQL, or controls streams. The AI advises; you execute. The full list of guarantees is in ",[29,579,581],{"href":580},"\u002Fdocs\u002Fmcp\u002Fsafety-and-privacy#what-cannot-happen","Safety & privacy → What cannot happen",".",[35,584,586],{"id":585},"next-steps","Next steps",[588,589,590,597,608],"ul",{},[591,592,593,594],"li",{},"Limit which of these the AI may use → ",[29,595,32],{"href":596},"\u002Fdocs\u002Fmcp\u002Fsafety-and-privacy#keeping-data-from-the-ai-provider",[591,598,599,600,461,604],{},"See them chained in real sessions → ",[29,601,603],{"href":602},"\u002Fdocs\u002Fmcp\u002Fexamples\u002Fsql-exploration","SQL exploration",[29,605,607],{"href":606},"\u002Fdocs\u002Fmcp\u002Fexamples\u002Ffederated-validation","federated validation",[591,609,610,611],{},"Wire up your AI client → ",[29,612,614],{"href":613},"\u002Fdocs\u002Fmcp\u002Fsetup","Setup",{"title":616,"searchDepth":617,"depth":617,"links":618},"",2,[619,620,621,622,623,624,625,626,627],{"id":37,"depth":617,"text":38},{"id":170,"depth":617,"text":171},{"id":226,"depth":617,"text":227},{"id":278,"depth":617,"text":279},{"id":319,"depth":617,"text":320},{"id":395,"depth":617,"text":396},{"id":431,"depth":617,"text":432},{"id":573,"depth":617,"text":574},{"id":585,"depth":617,"text":586},"The 26 read-only tools the DBConvert Streams MCP server exposes to your AI assistant, grouped by what they do. All read-only — none can change your data, config, or streams.","md",{},false,"\u002Fdocs\u002Fmcp\u002Ftools",null,{"title":5,"description":628},"docs\u002Fmcp\u002Ftools","8wIVBNbk7XqJ7OfYNdNW8oe8fMSrbd3VrL-5oR4bhG0",1781271516558]