Tool catalogue

The DataMaker MCP server ships 25+ tools. They fall into six groups: discovery, templates, generation, connections, scenarios, and SAP-specific. This page is the reference; for setup see MCP server.

Discovery

Tool	What it does
`list_templates`	All templates in the active project.
`list_connections`	All connections in the active project.
`list_scenarios`	All scenarios in the active project.
`list_types`	The 50+ built-in field types with their option schemas.
`get_template`	Full definition of one template by ID or name.
`get_connection`	Connection details (URL, auth method — never secrets).
`get_scenario`	Scenario source code and metadata.

Templates

Tool	What it does
`create_template`	Create from a list of fields.
`create_template_from_json`	Infer fields from a sample JSON object/array.
`create_template_from_csv`	Infer fields from a sample CSV.
`create_template_from_openapi`	Infer from an OpenAPI schema.
`update_template`	Modify fields, add/remove, change types.
`delete_template`	Soft-delete (recoverable for 30 days).
`mark_field_sensitive`	Toggle the sensitive flag on one field.

Generation

Tool	What it does
`generate_from_id`	Generate `count` rows from a template by ID.
`generate_from_name`	Same, but resolves by template name.
`preview_template`	Generate 3 sample rows. Faster than full generation; useful for sanity-checking.
`export_to_endpoint`	Generate, then push to a connection in one call.

Connections

Tool	What it does
`create_connection`	Create a new connection (DB / REST / SAP OData).
`verify_connection`	Run the verification check (reachability + auth).
`fetch_endpoint_fields`	For SAP / OpenAPI connections: list entity sets + properties.
`fetch_records`	Pull rows out via a filter expression.

Scenarios

Tool	What it does
`save_scenario`	Create or replace a scenario by name.
`execute_scenario`	Trigger a run, with optional params.
`get_scenario_run_logs`	Stream live logs (or fetch historical).
`cancel_scenario_run`	Stop a running scenario.

Saved sets

Tool	What it does
`save_set`	Save a list of rows under a name. Useful for regression sets.
`load_set`	Reload a saved set.
`list_sets`	All saved sets in the project.
`delete_set`	Remove a set.

SAP-specific

Tool	What it does
`fetch_sap_metadata`	Fetch and parse `$metadata` for an SAP OData connection.
`csrf_token_check`	Verify the CSRF token flow on an SAP connection.
`post_to_sap_entity`	Generate-and-POST in one tool call.
`fetch_sap_records_filtered`	`$filter`-based fetch with pagination.

Tool example: `generate_from_id`

{
  "name": "generate_from_id",
  "arguments": {
    "template_id": "tmpl_business_partner_de",
    "count":       25,
    "overrides":   { "Country": "DE" }
  }
}

Returns:

{
  "rows": [ { "BusinessPartner": "...", "Name": "...", ... }, ... ],
  "template_version": 7,
  "elapsed_ms": 412
}

Tools are versioned. The MCP server announces a protocolVersion and a serverVersion on connect. We follow MCP semver — breaking changes bump the major version.

Permissions

Tools that modify state (create_*, update_*, delete_*, execute_*, post_to_*, save_*) require an API key with at least member role.

Read-only tools (list_*, get_*, fetch_*, preview_*) work with any role.

Rate limits

Per workspace:

Plan	Tool calls / hour
Free	1,000
Pro	20,000
Enterprise	per contract

Tools that internally trigger generation count their generated rows toward the regular generation quota.