Recipe

mastra

A server built by Mastra, on Kubernetes, rendered offline as plain manifests by the helm provider's Workload synthesis. The Workload becomes a Deployment running the image the Release supplies, and a ClusterIP Service fronting infra.port, which the server receives as PORT beside MASTRA_HOST set to 0.0.0.0. A readiness probe reads Mastra's /health route, so the Service sends no traffic until the server answers; provides is that Service's host, port, endpoint and protocol, 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 the variables Mastra reads for an openai/ model: its endpoint as OPENAI_BASE_URL, and the connection's credential as OPENAI_API_KEY through a secretKeyRef, so the key never renders into the manifest. Each tool wired into the `tools` socket reaches the server under variables named for the connection's alias, upper-cased with hyphens as underscores: its address as AGGREGA_TOOL_<ALIAS>_URL, and, where the connection carries a credential, that credential as AGGREGA_TOOL_<ALIAS>_CREDENTIAL through a secretKeyRef, with the header the tool publishes for it as AGGREGA_TOOL_<ALIAS>_CREDENTIAL_HEADER. A connection writing an `inject:` block also receives the names it dictates, as variables or as files mounted at the paths it names: a tools connection in place of its address and header variables, while what its attachments deliver stays, and the model connection beside the variables Mastra reads. So does the component's own block. A set values.agent_id reaches the server as MASTRA_AGENT_ID by default; an entry of the component's own block reading it alone replaces that name.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:450dbf83f544fad351d9dc3bff446b10ccc2b730df4bbd61da404c3ab791d5b8
Published
2026-11-10T10:25:26Z
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:ee06c0394b0469ea1983f7a842002effd11d5c74c60991d081c064243fb6ea42

Reference at this version

oci://hub.aggrega.ai/recipe/helm/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.rendered_name }}-default
port{{ .infra.port }}
endpointhttp://{{ .context.rendered_name }}-default:{{ .infra.port }}
protocolhttp
agent_card_url{{ with optional .values "agent_id" "" }}http://{{ $.context.rendered_name }}-default:{{ $.infra.port }}/api/.well-known/{{ . }}/agent-card.json{{ end }}

Workload

Workload · form: stateless · replicas: 1 · 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