# elova

## Documentation

- [Introduction](https://docs.elova.dev/docs/introduction.md): Elova MCP gives an approved AI client read-only access to retained workspace and n8n metadata.
- [Quickstart](https://docs.elova.dev/docs/quickstart.md): Connect Codex CLI or Claude Code to the Elova MCP server and approve read access.
- [Authentication](https://docs.elova.dev/docs/authentication.md): How Elova MCP sign-in, scopes, approval expiry, and revocation work.
- [Concepts](https://docs.elova.dev/docs/concepts.md): Workspaces, n8n instances, workflows, executions, and sync jobs as the Elova MCP tools expose them.
- [Using tools](https://docs.elova.dev/docs/using-tools.md): Which Elova MCP tool answers which question, with arguments, returns, and example prompts.
- [Limits](https://docs.elova.dev/docs/limits.md): Page size, truncation, rate limits, token lifetime, and the read-only boundary for Elova MCP.
- [Troubleshooting](https://docs.elova.dev/docs/troubleshooting.md): How to recover from Elova MCP sign-in, permission, cursor, and read failures.

## MCP Reference

- [elova](https://docs.elova.dev/mcp.md): Read-only access to retained Elova workspace and n8n metadata. Nine tools. No writes, no live n8n calls, and no resources or prompts.
- [get_many_workspaces](https://docs.elova.dev/mcp/operations/operation-get-many-workspaces-tool.md): List the workspaces explicitly granted to this client, with their names, IANA time zones and the caller's role. Names are customer-controlled data. Follow nextCursor to continue.
- [get_workspace](https://docs.elova.dev/mcp/operations/operation-get-workspace-tool.md): Read a granted workspace's ID, name, IANA time zone and current caller role. Names are customer-controlled data.
- [get_many_instances](https://docs.elova.dev/mcp/operations/operation-get-many-instances-tool.md): Read n8n instance names, collection status and scheduling in a granted workspace. Names are customer-controlled data. URLs, source credentials and workflow content are omitted.
- [get_execution_stats](https://docs.elova.dev/mcp/operations/operation-get-execution-stats-tool.md): Read numeric retained-execution totals for a selected period and IANA time zone, with an optional retained OpenRouter model-token reference valuation and its pricing coverage. Reference costs are estimated standard token valuations, not provider invoices or complete workflow charges. History coverage is partial and…
- [get_many_sync_jobs](https://docs.elova.dev/mcp/operations/operation-get-many-sync-jobs-tool.md): List at most 50 recent collection jobs for an instance in a granted workspace. Results are a recent window; truncated indicates more retained rows. No job payloads are returned.
- [get_many_executions](https://docs.elova.dev/mcp/operations/operation-get-many-executions-tool.md): List a cursor-paginated page of retained n8n execution metadata with instance names, observed workflow labels, nullable local workflow IDs and optional OpenRouter model-token reference costs with pricing coverage. These estimated token valuations are not provider invoices or complete workflow charges. Filter by…
- [get_execution](https://docs.elova.dev/mcp/operations/operation-get-execution-tool.md): Get one retained n8n execution by its local ID with metadata, optional OpenRouter model-token reference costs and pricing coverage, and a bounded history report of nodes, runs, error messages and model/token observations when retained. Reference costs are estimated token valuations, not provider invoices or complete…
- [get_many_workflows](https://docs.elova.dev/mcp/operations/operation-get-many-workflows-tool.md): List a cursor-paginated page of retained n8n workflow metadata with workflow and instance names, optionally filtered by instance and lifecycle. Defaults to current workflows; historical includes archived, absent, or definition-removed workflows that remain authorized. Names are customer-controlled data; workflow names…
- [get_workflow](https://docs.elova.dev/mcp/operations/operation-get-workflow-tool.md): Get retained metadata and a bounded node inventory for one n8n workflow by its local ID. Includes workflow and instance names and node IDs, names, types, type versions and disabled flags. Names are customer-controlled data; workflow names are limited to 200 Unicode characters with nameTruncated. Nodes preserve stored…