Recipe

mastra

A server built by Mastra, for local development via Docker Compose. Synthesized-mode Workload: the image the Release supplies and its environment are translated from the Workload kind by the compose provider. The server receives infra.port as PORT beside MASTRA_HOST set to 0.0.0.0, and provides is the service's name on the compose network with that port, and, where values.agent_id is set, the address of that agent's Agent2Agent card. The model wired into the `model` socket reaches the server as on helm/mastra: its endpoint as OPENAI_BASE_URL, and the connection's credential as OPENAI_API_KEY. Each tool wired into the `tools` socket reaches it under the variables helm/mastra names: its address as AGGREGA_TOOL_<ALIAS>_URL, or the whole address the connection holds as a secret in its place, and the connection's credential as AGGREGA_TOOL_<ALIAS>_CREDENTIAL beside the header the tool publishes, AGGREGA_TOOL_<ALIAS>_CREDENTIAL_HEADER. A connection writing an `inject:` block, or the component's own, delivers the names it dictates, as on helm/mastra, a file as a compose config mounted at the path it names. A set values.agent_id reaches the server as MASTRA_AGENT_ID unless an entry of the component's own block reads it alone. Compose has no secret reference, so a secret held on a connection is written into the file as it was delivered; a Compose variable reference such as ${MODEL_API_KEY} is written as that reference, and Docker Compose substitutes it when the stack starts. Two secrets the Release alone attaches, a model credential beside a tool credential, both arrive under the key value and halt the build naming both; an Aggregate naming values.key on one of them avoids it.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:ac29eb39be71c6b328dca36312fb21ed5c118896b20ab6c018f09d7216d03bf5
Published
2026-11-10T10:19:40Z
Signing identity
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officialapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:8cf2c405e9f02ef9d424a38e44d788548c165a836fef23e1316779d328d0bb7a

Reference at this version

oci://hub.aggrega.ai/recipe/compose/mastra:1.0.0
Target
—
Implements
core/ai-agent/mastra:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .context.instance_id }}
port{{ .infra.port }}
endpointhttp://{{ .context.instance_id }}:{{ .infra.port }}
protocolhttp
agent_card_url{{ with optional .values "agent_id" "" }}http://{{ $.context.instance_id }}:{{ $.infra.port }}/api/.well-known/{{ . }}/agent-card.json{{ end }}

Workload

Workload · form: stateless · containers: main

Locals

No locals declared.

Values mapping

No values mapping declared.

Relationships

Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.

Uses

  • implementsimplementscontract compatible

    core/ai-agent/mastra:1.0.0

    All required outputs are satisfied and every provided output is named in the contract.

Used by

Nothing in the catalog depends on this entity.

Recipe concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy