Skip to content

AskAmerica Engine engine-v0.89.0

Choose a tag to compare

@github-actions github-actions released this 16 Sep 17:19
ec97e1b

AskAmerica Query Engine

Query all 15 US government datasets from Python, Node, Go, or any JDBC client.


Python (JPype — recommended)

pip install 'askamerica[engine]'
askamerica install-engine        # downloads askamerica-engine.jar
askamerica login                 # get your free API key
import askamerica as aa
df = aa.query("SELECT cik, company_name FROM sec.filing_metadata FETCH FIRST 5 ROWS ONLY")

Claude Desktop (MCP)

pip install 'askamerica[mcp]'
askamerica install-engine
askamerica mcp-config            # prints Claude Desktop config snippet

Raw JAR (JDBC / any language)

Download askamerica-engine.jar below and load it on your classpath.
JDBC URL: jdbc:govdata:source=sec,geo,econ,census,...

Native Installers (bundled JRE — no Java required)

Platform File
macOS AskAmerica-MCP-*.pkg
Linux askamerica-mcp_*.deb
Windows AskAmerica MCP-*.msi

macOS: Double-click the .pkg (installs to /Applications). The installer opens the setup wizard — paste your API key, click Configure Claude Desktop, then quit and reopen Claude Desktop. If the wizard doesn't appear, open AskAmerica MCP from Applications yourself. First launch caches the engine in ~/.askamerica/engine (~450 MB, one time). Signing/notarization is best-effort in CI; if Gatekeeper blocks an unsigned build, right-click → Open.
Linux: sudo dpkg -i askamerica-mcp_*.deb, then run askamerica-mcp to configure.
Windows: Double-click the .msi, then open AskAmerica MCP from the Start Menu to configure.

Trino connectors

Plugin-directory archives — unzip into your Trino server's plugin/ directory.

File Connector JDBC source
trino-calcite-plugin.zip calcite any Calcite model (jdbc:calcite:)
trino-sharepoint-plugin.zip sharepoint SharePoint Lists (jdbc:sharepoint:)
trino-splunk-plugin.zip splunk Splunk (jdbc:splunk:)
trino-file-plugin.zip file files / S3 globs (file adapter)
trino-cloudops-plugin.zip cloudops Azure/AWS/GCP inventory (jdbc:cloudops:)

Browser extension

askamerica-extension.zip — unzip and load unpacked via chrome://extensions (Developer mode). Reads previously published AskAmerica validation claims for the page you're on and hands off "Validate with AskAmerica" to your own Claude Desktop/claude.ai session; makes no model API calls itself. Requires the AskAmerica MCP engine running locally to see live claims.