Skip to content

PalenaMCPServer ​

A PalenaMCPServer stands up a Model Context Protocol server for augmenting LLMs with tool calls. v1alpha1 only supports type: websearch.

It is standalone — it does not reference a PalenaGateway. PalenaUI CRs register it via spec.mcpServerRefs.

Short name: pmcpAPI group: operator.palena.ai/v1alpha1Scope: Namespaced

spec ​

FieldTypeRequiredDefaultEnumDescription
typestringYes—websearchMCP server flavor.
replicasint32Yes1—MCP server Deployment replicas.
imageImageSpecNo——Override the MCP server image.
websearchWebsearchSpecWhen type: websearch——Websearch-specific config.

WebsearchSpec ​

FieldTypeRequiredDefaultDescription
searxngSearXNGSpecYes—SearXNG configuration.
scraperScraperSpecNo—Optional scraper sidecars.
presidioPresidioSpecNo—Optional PII analysis.
rerankerRerankerSpecNo—Optional result reranker.

SearXNGSpec ​

FieldTypeDefaultDescription
replicasint321SearXNG replica count.
engines[]stringduckduckgo, bing, wikipediaEnabled engines.
imageImageSpec—Image override.

ScraperSpec ​

FieldTypeDefaultDescription
chromiumEnabledboolfalseEnable Chromium scraper sidecar.
chromiumReplicasint321Chromium replica count when enabled.
maxConcurrencyint5MAX_CONCURRENT_SESSIONS env var.

PresidioSpec ​

FieldTypeDefaultEnumDescription
enabledboolfalse—Deploy analyzer + anonymizer.
modestringauditaudit, redact, blockHow detected PII is handled.
analyzerReplicasint321—Analyzer replicas.
anonymizerReplicasint321—Anonymizer replicas.

RerankerSpec ​

FieldTypeDefaultEnumDescription
providerstringnoneflashrank, kserve, noneReranker backend.
flashrank.imageImageSpec——FlashRank image override.
kserve.endpointstring——KServe inference endpoint URL (required when provider: kserve).
kserve.modelstring——KServe model name.

status ​

FieldTypeDescription
readyboolTrue once server + all enabled sidecars report ready.
replicasint32Observed MCP server replicas.
endpoints.ssestringSSE endpoint URL.
endpoints.streamableHttpstringHTTP streamable endpoint URL.
sidecarsmap[string]stringPer-sidecar readiness messages.
conditions[]metav1.ConditionStandard conditions (SidecarsReady, ServerReady, Ready).

Type, Ready, Age.

Example ​

yaml
apiVersion: operator.palena.ai/v1alpha1
kind: PalenaMCPServer
metadata:
  name: websearch
  namespace: palena
spec:
  type: websearch
  replicas: 2
  websearch:
    searxng:
      replicas: 2
      engines:
        - duckduckgo
        - wikipedia
        - arxiv
    scraper:
      chromiumEnabled: true
      chromiumReplicas: 2
      maxConcurrency: 10
    presidio:
      enabled: true
      mode: redact
    reranker:
      provider: flashrank

Released under the Apache 2.0 License. "Palena" is a trademark of bitkaio LLC.