acton_get_tablesLABSCO SUMMARY
Campaign data as rows, not as a dashboard.
The CData JDBC Driver exposes Act-On as relational models, so message performance and contact lists can be queried and joined instead of read off a report screen. The server offers three read tools and nothing that writes, which is what you want when a model is generating the SQL.
What it is
A Java MCP server that puts CData's JDBC Driver for Act-On behind three read-only tools: list the tables, list a table's columns, and run a SQL SELECT. The driver is what does the work — it exposes Act-On as relational SQL models — and the server hands those models to your client so you can ask questions in plain language instead of writing SQL yourself.
What you get
get_tablesreturns the tables available in the data source, as CSV with a header rowget_columnsreturns the columns of one table, in the same CSV shaperun_queryexecutes a SQL SELECT and returns the rows- Every tool name is prefixed with the server name from your
.prpfile, so several CData servers can run side by side without colliding - Ask in plain language and the client picks the tools and writes the SQL itself
Requirements
Build the server with mvn clean install, which produces CDataMCP-jar-with-dependencies.jar. Separately download the CData JDBC Driver for Act-On and license it: run java -jar cdata.jdbc.acton.jar --license and enter your name, email and either TRIAL or a licence key. Then write a .prp file naming DriverClass=cdata.jdbc.acton.ActOnDriver plus the JdbcUrl you build in the driver's connection-string utility, and point your client at java -jar with the jar and that file. Transport is stdio, so the server has to run on the same machine as the client.
Setup effort
Build from source — clone the repository, then point your client at the binary
USE CASES
Comparing two campaigns
Query both from the same table and let the numbers sit side by side.
Pulling a segment for review
Describe the criteria; the client writes the SELECT and returns CSV.
Finding out what Act-On exposes
List tables and columns before deciding what is worth reporting.
3 tools
Listed in project docs. Your client may show a different list.
acton_get_columnsacton_run_queryBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation. Tool names take the Prefix from your .prp file, such as acton_get_tables. Read-only: run_query executes SELECT only, even though the README's usage notes say the client can write, update and delete; writes come with CData's separate MCP Server for Act-On.
Where it runs
Both documented setups run the server on your machine.
INSTALLATION
Connect your client
Clone the repository, then point your client at the binary. This one is built from source rather than installed with a single command.
Server setup
Clone the repository: git clone https://github.com/cdatasoftware/act-on-mcp-server-by-cdata.git then cd act-on-mcp-server-by-cdata
Build the server: mvn clean install — this creates the JAR file CDataMCP-jar-with-dependencies.jar that the config block points at
Download and install the CData JDBC Driver for Act-On from https://www.cdata.com/drivers/acton/download/jdbc/
License the driver: from the driver install's lib folder run java -jar cdata.jdbc.acton.jar --license and enter your name, email, and "TRIAL" (or your license key)
Build the connection string: run java -jar cdata.jdbc.acton.jar to open the Connection String utility, click "Test Connection", and copy the working connection string (browser OAuth may be required here)
Create a .prp file (e.g. act-on.prp) containing Prefix / ServerName / ServerVersion / DriverPath / DriverClass / JdbcUrl / Tables — set JdbcUrl to the connection string you copied in the previous step
Add the mcpServers entry to claude_desktop_config.json pointing at your java binary, the built JAR, and the .prp file; copy the file to %APPDATA%\Claude\ (Windows) or ~/Library/Application Support/Claude/ (Mac)
Fully quit and re-open Claude Desktop for the MCP server to appear
MCP Clients
Claude Desktop — Linux, macOS, Windows
{
"mcpServers": {
"act-on": {
"command": "<YOUR_PATH_TO_JAVA>",
"args": [
"-jar",
"<YOUR_PATH_TO_CDATA_MCP_JAR_WITH>",
"<YOUR_PATH_TO_ACT_ON>"
]
}
}
}