Skip to main content
Glama

List data specs or jobs

list_data
Read-onlyIdempotent

List either the data specs (parsing + mapping rule sets, resource: "specs") or the data processing jobs (executions of a spec, resource: "jobs") defined in a workspace. Each spec includes its specId and current status — poll a specific one with get_status. Both resources are paginated (default 25/page, max 100, newest first); pass the returned nextCursor to fetch more.

A spec row also carries its stored input set — sourceType, sampleFileName, formatFileName, targetOption/targetTables/targetSchemaFileName, sourceTables, merge and additionalPrompt — which is exactly what AI code generation re-reads on every re-analysis. Read that set here BEFORE calling update_data_spec: an update regenerates the parser and mapping from all of it, not just from the fields you change, so it is the only way to tell which components are about to be reused as-is.

This is NOT a table listing — specs describe configured pipelines (parsing/mapping rules), not the live set of Iceberg tables in the workspace. Multiple specs can target the same table (e.g. one spec creates it, another merges more data into it), and specs can be deleted or fail without the underlying table being dropped. For "what tables exist in my workspace" or any question about actual current data, use submit_query with SHOW TABLES instead of inferring an answer from specs.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
cursorNoOpaque `nextCursor` from a prior page (omit for the first page).
pageSizeNoRecords per page (default 25).
resourceYesWhich kind of resource to list
workspaceIdNoWorkspace to act on. Defaults to your only workspace if you have exactly one.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
jobsNoPresent when resource is "jobs"
countYesNumber of items in this page, not the workspace total
specsNoPresent when resource is "specs"
pageSizeNo
nextCursorNoOpaque cursor for the next page; null when exhausted

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed6 schema fields changed
    • addedOutput schema / properties / specs / items / properties / additionalPrompt
      Added value: +{
      +  "description": "Stored AI guidance, reused verbatim on every re-analysis",
      +  "type": "string"
      +}
    • addedOutput schema / properties / specs / items / properties / formatFileName
      Added value: +{
      +  "description": "sourceType \"file\" only: the stored format spec, if one was provided",
      +  "type": "string"
      +}
    • addedOutput schema / properties / specs / items / properties / lastRunTs
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / specs / items / properties / sampleFileName
      Added value: +{
      +  "description": "sourceType \"file\" only: the stored sample the generated parser was built from",
      +  "type": "string"
      +}
    • addedOutput schema / properties / specs / items / properties / sourceTables
      Added value: +{
      +  "description": "sourceType \"tables\"/\"compaction\" only",
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / specs / items / properties / sourceType
      Added value: +{
      +  "description": "\"file\" | \"tables\" | \"compaction\"",
      +  "type": "string"
      +}
  2. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources