snapchatads_get_tablesLABSCO SUMMARY
Read-only by construction.
Three tools and no write path is the whole design: the model discovers tables, reads columns and runs SELECTs, so a badly framed question produces a wrong answer rather than a changed record. Two things decide whether it fits. The CData JDBC driver is a separate licensed product, with a trial key to start on. And the assistant can query every table the connection can see — the Tables field in the connection profile does not narrow that, so limit the connection or the account it signs in with.
What it is
A read-only MCP server built on CData's JDBC Driver for Snapchat Ads. The driver exposes Snapchat Ads as relational tables; the server puts three tools over it, so a client can discover what tables exist, read a table's columns, and run a SELECT — without anyone writing SQL by hand.
What you get
- The tables the driver exposes for Snapchat Ads, returned as CSV with a header row —
snapchatads_get_tables - The columns of one of those tables, also as CSV, so a query can be composed against real field names —
snapchatads_get_columns - A SQL SELECT executed against live Snapchat Ads data —
snapchatads_run_query - Tool names that carry the prefix you set in the connection profile — the sample uses
Prefix=snapchatads— so several CData servers can run side by side without colliding - A
Tablessetting that only picks which tables also get a ready-made description (blank means none); it does not limit what the tools can list or query, so limit the connection or the account it signs in with
Requirements
Java and Maven to build — mvn clean install produces CDataMCP-jar-with-dependencies.jar. The CData JDBC Driver for Snapchat Ads is a separate download and needs licensing: run java -jar cdata.jdbc.snapchatads.jar --license and enter a name, an email and either TRIAL or a licence key. Connection settings go in a .prp file carrying Prefix, ServerName (the sample uses CDataSnapchatAds), ServerVersion, DriverPath, DriverClass (cdata.jdbc.snapchatads.SnapchatAdsDriver), the JdbcUrl produced by the driver's connection-string utility, and the optional Tables list. The client then launches java -jar CDataMCP-jar-with-dependencies.jar <YOUR_PRP_FILE>.prp. Transport is stdio, so the server has to run on the same machine as the client. If the data source authenticates over OAuth, you approve it in a browser while building the connection string.
Setup effort
Build from source — git clone https://github.com/cdatasoftware/snapchat-ads-mcp-server-by-cdata.git
USE CASES
01
Asking how a campaign performed
Campaigns, ad squads, ads and their stats arrive as tables, so a performance question becomes a SELECT the client composes.
02
Comparing spend across campaigns
Aggregate live campaign data in one query instead of exporting each campaign separately.
03
Seeing which ad objects are queryable
List the tables the driver models and read one table's columns to find the metrics available.
04
Pulling a figure into a report mid-draft
Read a current spend or delivery number without leaving the document you were writing.
3 tools
Listed in project docs. Your client may show a different list.
snapchatads_get_columnssnapchatads_run_queryBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation. Tool names are the Prefix value from the .prp file plus _get_tables, _get_columns or _run_query, so the sample Prefix=snapchatads gives snapchatads_get_tables. The tools only read — run_query executes SELECT statements. Writes need CData's separate MCP Server for Snapchat Ads.
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/cdatasoftware/snapchat-ads-mcp-server-by-cdata.git
cd snapchat-ads-mcp-server-by-cdata
mvn clean installDownload and install the CData JDBC Driver for Snapchat Ads from https://www.cdata.com/drivers/snapchatads/download/jdbc
License the driver: java -jar cdata.jdbc.snapchatads.jar --license (enter name, email and "TRIAL" or your license key)
Run java -jar cdata.jdbc.snapchatads.jar to open the Connection String utility, configure and test the connection, then copy the connection string
Create snapchat-ads.prp with:
FILE · snapchat-ads.prp
Prefix=snapchatads
ServerName=CDataSnapchatAds
ServerVersion=1.0
DriverPath=<YOUR_DRIVER_PATH>
DriverClass=cdata.jdbc.snapchatads.SnapchatAdsDriver
JdbcUrl=<YOUR_JDBC_URL>
Tables=Tables only picks which tables also get a ready-made description for your assistant, and empty means none; the server can still list and query every table your connection string reaches, so to keep data out of reach, limit that connection or the account it signs in with.
Add the mcpServers entry below to claude_desktop_config.json and fully restart the client
MCP Clients
Claude Desktop — macOS / Linux
CLAUDE DESKTOP — MACOS / LINUX · JSON
{
"mcpServers": {
"snapchat-ads": {
"command": "<YOUR_PATH_TO_JAVA>",
"args": [
"-jar",
"<YOUR_PATH_TO_CDATA_MCP_JAR_WITH>",
"<YOUR_PATH_TO_SNAPCHAT_ADS>"
]
}
}
}