MINARA

MCP

MCP (Model Context Protocol) integrations

MINARA_MICROSOFT_PUBLIC_CLIENT_ID

Microsoft Entra public-client app id.

  • What it controls: enables local Outlook Mail, Outlook Calendar, and OneDrive Authorization Code + PKCE flows.
  • Consumed by: src/connectors/microsoft-oauth.ts. This identifier is public and is never paired with a client secret.
  • When to set: in packaged builds until the registered Minara public-client id is injected by the release pipeline.
  • When unset: Microsoft Connect buttons are disabled; broker-backed Connectors are unaffected.
  • Format: Microsoft Entra application UUID registered for the loopback redirect http://127.0.0.1:14583/connector/microsoft/callback.
  • Setting home: Not a user-facing setting

MCP_SERVERS

JSON array of extra MCP servers to spin up at boot.

  • What it controls: overrides the default MCP server list with a user-supplied set. Useful for wiring proprietary in-house MCP servers without patching src/app.ts.
  • Consumed by: src/app.ts.
  • When to set: you have an MCP server (stdio or streamable-HTTP) you want exposed to the agent.
  • When unset: only the built-in MCP wiring below is used.
  • Format: JSON array, e.g. [{"name":"defillama","command":"npx","args":["-y","@defillama/mcp"]}] Must parse as Array<{name:string, command:string, args?:string[]}>.
  • Setting home: Not a user-facing setting

DEFILLAMA_API_KEY

DefiLlama Pro REST API key.

  • What it controls: authenticates typed defillama_* category tools that hit DefiLlama's REST API via src/defillama/client.ts. Used for Pro-host path prefixing; free hosts work without it (or via Minara forward). Discover tools with tool_search namespace: "cap/defillama" — there is no DefiLlama skill package.
  • Consumed by: src/defillama/client.ts and the defillama_* passthrough tools registered from src/generated/defillama/catalog.ts.
  • When to set: you have a DefiLlama Pro account and want local Pro rate limits / endpoints without relying on Minara forward.
  • When unset: Pro-host calls forward through Minara when logged in, otherwise free endpoints / web fallback.
  • Format: raw API key from https://defillama.com (Pro signup).
  • Setting home: Settings → API Keys

DEFILLAMA_MCP_TOKEN

DefiLlama managed MCP token (legacy).

  • What it controls: authenticates the DefiLlama managed MCP service (paid tier with higher rate limits than the free endpoints). Superseded by DEFILLAMA_API_KEY + the typed defillama_* tools above; kept only for back-compat with the legacy MCP wiring.
  • Consumed by: src/app.ts when DefiLlama MCP is wired.
  • When to set: you've paid for DefiLlama MCP access and want the agent to use it instead of the public REST API.
  • When unset: DefiLlama calls fall back to the typed defillama_* tools (when DEFILLAMA_API_KEY is set) or to free endpoints.
  • Format: opaque token from https://defillama.com.
  • Setting home: Not a user-facing setting

v1 Minara backend MCP sub-agents (tier-3 fallback)

Each URL points at a streamable-HTTP MCP endpoint. When set and no mcp.json file is present, the matching server is registered as a tier-3 fallback. Prefer minara mcp add to register the same servers in mcp/servers.json so tool_search can index them. All are optional and independently gated — missing envs don't break anything else. In v1 these were served via SSE from <name>-mcp-cloud.xxx/sse; v2 uses streamable-HTTP so the server must advertise that transport.

MCP_EVM_RPC_URL

raw EVM JSON-RPC sub-agent endpoint.

  • What it controls: registers the evm_rpc MCP server in the tier-3 fallback inventory (eth_call, simulate, raw logs, 15 steps / 240s timeout per query). Prefer minara mcp add to register in mcp/servers.json for tool_search discovery.
  • Consumed by: src/app/mcp.ts tier-3 fallback only.
  • Format: absolute URL, no trailing slash.
  • Setting home: Not a user-facing setting

MCP_ETHERSCAN_URL

Etherscan-style explorer sub-agent endpoint.

  • What it controls: registers the etherscan MCP server in the tier-3 fallback inventory (indexed tx / log / contract queries across 60+ EVM chains). Prefer minara mcp add to register in mcp/servers.json for tool_search discovery.
  • Consumed by: src/app/mcp.ts tier-3 fallback only.
  • Format: absolute URL.
  • Setting home: Not a user-facing setting

FMP_API_KEY

Financial Modeling Prep public-equity data.

  • What it controls: the typed FMP tool family discovered with tool_search under namespace cap/fmp. Callers inspect selected tools with tool_describe; there is no dedicated FMP Skill package. ⚠ Public equities ONLY — crypto is out of scope. BTC/ETH/SOL spot queries defer to market.spot. Crypto-treasury stocks (MSTR, SBET, COIN) ARE in scope as equities. ⚠ FMP does NOT provide options chain or Greeks. ⚠ A handful of endpoints are tier-gated (Starter+) — e.g. batch quote, full DCF flavors, intraday bars, full 13F dumps. The client surfaces tier-gates as FmpTierGateError (HTTP 402) so the LLM can fall back to single-symbol / basic-flavor calls.
  • Consumed by: src/tools/fmp/*.ts and src/fmp/client.ts (reads the var fresh on every call so operators can rotate keys without a restart).
  • When to set: you have an FMP account and want public-equity data through cap/fmp.
  • When unset: FMP tools remain unavailable to capability discovery and callers must degrade without FMP data.
  • Format: raw key string (no URL wrapping) from the developer dashboard at https://site.financialmodelingprep.com/developer/docs. Pricing: https://site.financialmodelingprep.com/developer/docs/pricing (Free 250/day with ~100 sample symbols; Starter 10K/day full symbol coverage is the recommended minimum for real scenario use).
  • Migration: if you previously set MCP_FMP_URL=https://financial... ?apikey=KEY, extract the KEY portion and set FMP_API_KEY=KEY instead. MCP_FMP_URL and MCP_FMP_INCLUDE are no longer read.
  • Setting home: Settings → API Keys

COIN_METRICS_API_KEY / FRED_API_KEY / EIA_API_KEY / NASDAQ_DATA_LINK_API_KEY / ALPHA_VANTAGE_API_KEY / TWELVE_DATA_API_KEY / MASSIVE_API_KEY

Factor Research data-provider credentials.

  • What it controls: enables authenticated access to Coin Metrics, FRED / ALFRED, EIA, Nasdaq Data Link, Alpha Vantage, Twelve Data, and Massive when Factor Research resolves point-in-time market and economic data.
  • Consumed by: src/strategy-studio/factor-research/default-data-sources.ts through the stored-credential resolver.
  • When to set: set only the keys for providers available to your research workspace.
  • When unset: the matching authenticated provider is skipped. Coin Metrics community data remains available without a key when it can satisfy the request.
  • Format: raw API key issued by the corresponding provider dashboard.
  • Setting home: Settings → API Keys

SEC_USER_AGENT

declared identity for native SEC EDGAR data access.

  • What it controls: enables the provider-neutral point-in-time financial snapshot service to call data.sec.gov submissions + companyfacts and www.sec.gov ticker/CIK mappings. SEC requires automated clients to identify the product and a reachable contact under its Fair Access policy.
  • Consumed by: src/capability/sec-edgar-client.ts and the Institution PIT fundamentals preflight. This is not an API key or secret.
  • When to set: required when PIT_FINANCIAL_SNAPSHOT_MODE is shadow or enforce.
  • When unset: the PIT service stays unwired and Institution keeps its legacy fundamentals path even though the mode preference defaults to shadow.
  • Format: "ProductName [email protected]". Do not use a fake contact.
  • Setting home: Not a user-facing setting

PIT_FINANCIAL_SNAPSHOT_MODE

Institution point-in-time financial rollout.

  • What it controls: off keeps the legacy path; shadow builds and persists SEC- backed snapshots without changing analyst input; enforce supplies the snapshot to a tool-free Fundamentals analyst and enables analysis caching.
  • Consumed by: data.pitFinancialSnapshots.mode in the runtime Preferences schema and src/app/institution.ts. Changes require an agent restart.
  • Default: shadow. Accepted values: off | shadow | enforce.
  • Setting home: Settings → Preferences (schema key)

MCP_SOLSCAN_URL

Solscan-compatible Solana explorer sub-agent.

  • What it controls: registers the solscan MCP server in the tier-3 fallback inventory (indexed Solana queries: SPL transfers, program calls, account history). Prefer minara mcp add to register in mcp/servers.json for tool_search discovery.
  • Consumed by: src/app/mcp.ts tier-3 fallback only.
  • Format: absolute URL.
  • Setting home: Not a user-facing setting

MCP_GOPLUS_URL

GoPlus multi-chain Web3 security analytics.

  • What it controls: registers the goplus MCP server in the tier-3 fallback inventory (token honeypot checks, approval risk, address reputation). Prefer minara mcp add to register in mcp/servers.json for tool_search discovery. GoPlus security coverage for common chains is already provided by the builtin security.token skill without this env var.
  • Consumed by: src/app/mcp.ts tier-3 fallback only.
  • Format: absolute URL.
  • Setting home: Not a user-facing setting

On this page

MINARA_MICROSOFT_PUBLIC_CLIENT_IDMCP_SERVERSDEFILLAMA_API_KEYDEFILLAMA_MCP_TOKENv1 Minara backend MCP sub-agents (tier-3 fallback)MCP_EVM_RPC_URLMCP_ETHERSCAN_URLFMP_API_KEYCOIN_METRICS_API_KEY / FRED_API_KEY / EIA_API_KEY / NASDAQ_DATA_LINK_API_KEY / ALPHA_VANTAGE_API_KEY / TWELVE_DATA_API_KEY / MASSIVE_API_KEYSEC_USER_AGENTPIT_FINANCIAL_SNAPSHOT_MODEMCP_SOLSCAN_URLMCP_GOPLUS_URL