Tools & resources

Every tool the agent can call, every resource it can read, and the guided prompts it can run.

This page lists everything the agent can use: the tools it calls to take action, the resources it reads to ground itself, and the prompts that guide it through common tasks.

In the tool tables, the Access column marks each tool Read or Write. Write tools change files or control generators, and are gated: over HTTP they require server.mcp.allow_write, and over stdio they are available unless you pass --read-only.

Discovery tools

Read-only, and available on both transports. They let the agent learn what Eventum offers before it writes a config.

Tool	Description
`list_plugins`	List the available input, event, and output plugins.
`get_plugin_schema`	Return the configuration schema for one plugin.
`list_formatters`	List the available output formatters.
`get_formatter_schema`	Return the configuration schema for one formatter.
`describe_sample`	Describe a CSV or JSON sample file used by a generator.
`list_secret_names`	List the secret names in the keyring, so a config can reference them. The agent cannot read or change their values — that is done with `eventum-keyring`.

Workspace & authoring tools

Available on both transports. They operate on the generators in your generators directory.

Tool	Access	Description
`list_generators`	Read	List the saved generators.
`list_generator_files`	Read	List the files in one generator.
`read_generator_file`	Read	Read a file in a generator.
`write_generator_file`	Write	Create or overwrite a file in a generator.
`delete_generator_file`	Write	Delete a file from a generator.
`delete_generator`	Write	Delete a whole generator and its files.
`validate_generator`	Read	Validate a generator and return any errors.
`preview_timestamps`	Read	Preview the timestamps a generator would produce.
`preview_events`	Read	Preview the events a generator would produce.
`run_generator`	Write	Run a saved generator once to its configured outputs, stopping when it finishes or reaches a time or event limit.

validate_generator and the preview_* tools load the generator into the same pipeline a real run uses, so the agent sees exactly what a run would produce. See how it works.

Live-management tools

Available only over HTTP. They control the generators the server manages.

Tool	Access	Description
`list_generators_live`	Read	List the generators the server manages, with their status.
`get_generator_status`	Read	Return the current status of one managed generator.
`get_generator_stats`	Read	Return runtime statistics for one running generator.
`start_generator`	Write	Start a managed generator.
`stop_generator`	Write	Stop a managed generator.
`register_generator`	Write	Register an authored generator with the running server, so it can be started and is restored after a server restart.
`unregister_generator`	Write	Remove a generator from the running server, and stop restoring it on restart.
`get_generator_logs`	Read	Return the recent log lines for a managed generator, to diagnose a run.
`list_startup_generators`	Read	List the generators configured to start with the server.

Resources

Documents the agent reads to ground itself. Read-only, on both transports.

Resource	Description
`eventum://templating/reference`	The in-template API the `template` plugin exposes, always current with the installed version.
`eventum://schema/generator`	The JSON Schema of the top-level generator.yml document.
`eventum://examples/generators`	Bundled, validated worked examples to start from, plus links to the public content-packs repository and the generator hub.
`eventum://workspace/configs`	The generators currently saved in your generators directory.

Prompts

Ready-made task guides the agent can invoke.

Prompt	Description
`create_generator`	Guide the agent through the full authoring loop.
`live_ops`	Operate the generators on a running server. HTTP only.