Skip to main content
Glama
io.github.kultar/librarian

io.github.kultar/librarian

by kultar

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LIBRARIAN_HOSTNoAddress the listener for agents (A2A and MCP) binds to. Default: 127.0.0.1.
LIBRARIAN_PORTNoPort for the agent listener (A2A and MCP). Default: 8080.
LIBRARIAN_MODELNoThe model for plain-language requests (fetch) and for learning an API that has no spec, e.g. anthropic:claude-sonnet-5-5. Unset: those two are unavailable.
LIBRARIAN_A2A_URLNoThe A2A address advertised in the agent card when agents and people reach librarian at different addresses. Default: public_url.
LIBRARIAN_CALLERSNoJSON list of caller objects with agent, key_ref, apis, can_onboard, write_apis, owner, approval_wait_seconds and limits. With no callers configured the server is open.
LIBRARIAN_REPLICASNoHow many replicas run. Above 1, librarian refuses to start without Postgres and the AWS secret store. Default: 1.
LIBRARIAN_MODEL_APINoThe format spoken to the gateway: openai or anthropic. Default: openai.
LIBRARIAN_AUDIT_FILENoThe audit log, one JSON object per line. Unset: standard output.
LIBRARIAN_PAGES_HOSTNoAddress of the separate listener for the pages and console. Default: 127.0.0.1.
LIBRARIAN_PAGES_PORTNoServe the pages and console on their own listener. Needed with approvers.mode: trusted_header.
LIBRARIAN_PUBLIC_URLNoWhere approvers' browsers reach the pages; every link librarian sends starts with it. Default: http://127.0.0.1:8080.
LIBRARIAN_MCP_ENABLEDNoServe the skills as MCP tools at /mcp. Default: true.
LIBRARIAN_SECRETS_DIRNoWith file: the folder holding one 0600 file per secret. Default: .librarian/secrets.
LIBRARIAN_DATABASE_URLNoWhere everything is kept. Default: sqlite+aiosqlite:///.librarian/librarian.db. Use postgresql+asyncpg://... for several replicas; null keeps it in memory.
LIBRARIAN_OTEL_ENABLEDNoSend traces and metrics with OpenTelemetry; endpoint comes from the standard OTEL_EXPORTER_OTLP_* variables. Default: false.
LIBRARIAN_REGISTRY_DIRNoRegistry entries written by hand as YAML. With a database they are imported into it. Default: registry.
LIBRARIAN_MODEL_API_KEYNoThe key for the model gateway. It is the only key ever sent there.
LIBRARIAN_PUBLISH__REPONoThe record repository, owner/name.
LIBRARIAN_PUBLISH__TYPENonone or github; github writes every approved entry and decision to a repository as a commit. Default: none.
LIBRARIAN_FALLBACK_MODELNoTried once when the model fails or declines a request.
LIBRARIAN_INTERNAL_HOSTSNoJSON list of host name patterns agents may learn APIs on although they resolve to private addresses, e.g. ["*.internal.example.com"].
LIBRARIAN_MODEL_BASE_URLNoAn OpenAI-compatible gateway such as LiteLLM, instead of the provider.
LIBRARIAN_NOTIFIER__TYPENoWhere requests for a person go: log, slack or webhook. Default: log.
LIBRARIAN_PLANNER_OUTPUTNoHow the planner gets structured answers: tool, native, prompted, or auto. Default: auto.
LIBRARIAN_PUBLISH__TOKENNoA token for the record repository with contents and pull requests write permission. Prefer publish.github_app.
LIBRARIAN_WRITES__GRANTSNoJSON list of config grants for unattended agents, with agent, api, operation, principal, pinned_args, max_uses_per_day and notify_owner.
LIBRARIAN_APPROVERS__MODENoHow the pages know who is deciding: token (whoever holds the link) or trusted_header (a sign-in proxy in front). Default: token.
LIBRARIAN_LEARNING__MODELNoA different model for learning than for fetch.
LIBRARIAN_RECIPES_ENABLEDNoSave a successful plain-language request as a recipe and replay it without the model. Default: true.
LIBRARIAN_SECRETS_BACKENDNoSecret backend: file or aws. Default: file.
LIBRARIAN_SIGNING_KEY_REFNoThe secret holding the key that signs links for people. Default: librarian/signing-key.
LIBRARIAN_APPROVERS__GROUPNoThe group whose members may approve.
LIBRARIAN_PRINCIPALS__MODENoWhether the person an agent names must be proven: off, optional or required. Default: off.
LIBRARIAN_PUBLISH__API_URLNoThe GitHub API address, for GitHub Enterprise Server. Default: https://api.github.com.
LIBRARIAN_SUBSTRATE__RULESNoJSON list of substrate rule objects with match fields, agent, apis, can_onboard, write_apis, owner, approval_wait_seconds and limits.
LIBRARIAN_ALLOW_PROVISIONALNoWhether a learned API can be read before a person approves it. Default: true.
LIBRARIAN_MCP_ALLOWED_HOSTSNoHost headers accepted on /mcp. Empty means any; every MCP request still needs a caller's key.
LIBRARIAN_OTEL_SERVICE_NAMENoThe service name carried by telemetry. Default: librarian.
LIBRARIAN_SUBSTRATE__ISSUERNoIssuer of actor tokens, e.g. https://idp.ate-system.svc. Setting it turns Agent Substrate/kagent authentication on.
LIBRARIAN_WRITES__APPROVERSNoWho may approve a write: requester, group, or requester_or_group. Default: requester_or_group.
OTEL_EXPORTER_OTLP_ENDPOINTNoStandard OpenTelemetry OTLP endpoint used when otel_enabled is true.
LIBRARIAN_APPROVERS__CONSOLENoThe console: signed_in, open (no sign-in: a laptop) or off. Default: signed_in.
LIBRARIAN_MAX_RESPONSE_BYTESNoAn API answer longer than this is cut off and marked truncated. Default: 2000000.
LIBRARIAN_ONBOARDING_ENABLEDNoWhether agents may teach librarian new APIs at all. Default: true.
LIBRARIAN_PRINCIPALS__HEADERNoThe header carrying the person's token. Default: X-Principal-Token.
LIBRARIAN_PUBLISH__DIRECTORYNoThe folder in the record repository. Default: registry.
LIBRARIAN_SUBSTRATE__CA_FILENoCA bundle for reaching the issuer, such as the trust bundle of its signer in a cluster.
LIBRARIAN_AWS_SECRETS__PREFIXNoPrefix placed in front of every AWS secret reference.
LIBRARIAN_AWS_SECRETS__REGIONNoAWS region for Secrets Manager. Default: the usual AWS configuration.
LIBRARIAN_LEARNING__FIND_DOCSNoGiven only a base URL, look for documentation in the usual places. Default: true.
LIBRARIAN_MAX_CALLS_PER_FETCHNoThe most API calls one plain-language request may make. Default: 8.
LIBRARIAN_PRINCIPALS__ISSUERSNoJSON list of identity provider issuer objects with issuer, audience, jwks_url, claim, algorithms and leeway_seconds.
LIBRARIAN_SUBSTRATE__AUDIENCENoWhat a substrate token must be made for. Default: librarian.
LIBRARIAN_SUBSTRATE__JWKS_URLNoWhere the issuer's keys are. Default: from its discovery document.
LIBRARIAN_AUDIT_RETENTION_DAYSNoHow long audit events are also kept in the database for the console's Activity page. Default: 30.
LIBRARIAN_DRIFT__RECHECK_HOURSNoHow often each API's spec or documentation is read again for changes; 0 never. Default: 24.
LIBRARIAN_MCP_MAX_RESULT_BYTESNoLargest MCP tool result execute sends, in bytes as sent. A larger one comes back as its outline; 0 means no limit. Default: 1000000.
LIBRARIAN_MCP_MAX_WAIT_SECONDSNoLongest write_status waits for a write to end when an agent asks with wait_seconds; 0 never waits. Default: 50.
LIBRARIAN_PUBLISH__BASE_BRANCHNoThe branch written to. Default: main.
LIBRARIAN_REGISTRY_OVERLAY_DIRNoWithout a database: where librarian writes its own entries when registry_dir is managed elsewhere.
LIBRARIAN_FETCH_TIMEOUT_SECONDSNoThe time one plain-language request may take; past it, what it has is returned marked partial. Default: 100.
LIBRARIAN_LEARNING__SEARCH__URLNoThe SearXNG instance used for documentation search.
LIBRARIAN_NOTIFIER__WEBHOOK_URLNoWith notifier.type webhook: where each event is posted as JSON.
LIBRARIAN_RATE_LIMIT_PER_MINUTENoReads one agent may make on one API in a minute. Default: 60.
LIBRARIAN_SUBSTRATE__ALGORITHMSNoJSON list of signature algorithms accepted for substrate tokens. Default: ["ES256", "RS256"].
LIBRARIAN_SUBSTRATE__KAGENT_URLNokagent's controller. When set, the caller is the kagent Agent behind a session rather than the session.
LIBRARIAN_WRITES__ANNOUNCE_AUTONoPost every automatically approved write to the channel. Default: false.
LIBRARIAN_ALLOW_PRIVATE_NETWORKSNoLet learned APIs reach private addresses. For a laptop; otherwise use internal_hosts. Default: false.
LIBRARIAN_APPROVERS__USER_HEADERNoThe header in which the proxy names the person. Default: X-Auth-Request-Email.
LIBRARIAN_WRITES__MAX_GRANT_DAYSNoThe longest a grant may last. Unset means any length, including until revoked.
LIBRARIAN_CREDENTIAL_WAIT_SECONDSNoHow long an A2A task waits for a person to add a missing credential. Default: 900.
LIBRARIAN_REQUEST_TIMEOUT_SECONDSNoHow long connecting to an API, or waiting for the next part of its answer, may take; one request as a whole may take twice this. Default: 30.
LIBRARIAN_WRITES__ANNOUNCE_GRANTSNoPost every use of a grant to the channel. Default: true.
LIBRARIAN_APPROVERS__GROUPS_HEADERNoThe header in which the proxy lists the person's groups. Default: X-Auth-Request-Groups.
LIBRARIAN_LEARNING__DOCS_MAX_PAGESNoThe most documentation pages read for one API. Default: 8.
LIBRARIAN_NOTIFIER__SLACK__CHANNELNoThe Slack channel; an API's entry can name its own. Default: #api-access-requests.
LIBRARIAN_LEARNING__MODEL_KNOWLEDGENoGiven only a base URL and no documentation, describe the API from what the model knows. Default: true.
LIBRARIAN_LEARNING__SEARCH__API_KEYNoThe Brave Search key.
LIBRARIAN_SUBSTRATE__LEEWAY_SECONDSNoClock difference tolerated when checking a substrate token's times. Default: 30.
LIBRARIAN_AWS_SECRETS__CACHE_SECONDSNoHow long an AWS secret value is kept in memory. Default: 60.
LIBRARIAN_LEARNING__SEARCH__PROVIDERNoSearch the web for an API's documentation: off, model, searxng or brave. Default: off.
LIBRARIAN_NOTIFIER__SLACK__BOT_TOKENNoThe Slack bot's token.
LIBRARIAN_PUBLISH__GITHUB_APP__APP_IDNoGitHub App id for the record repository.
LIBRARIAN_NOTIFIER__EXPIRE_AFTER_HOURSNoClose a credential request nobody answered after this long. Default: 24.
LIBRARIAN_NOTIFIER__REMIND_AFTER_HOURSNoRemind about a credential request still open after this long. Default: 4.
LIBRARIAN_LEARNING__SEARCH__MAX_RESULTSNoHow many search results are looked at. Default: 8.
LIBRARIAN_WRITES__APPROVAL_EXPIRE_HOURSNoHow long a write waits for a decision before it expires. Default: 24.
LIBRARIAN_WRITES__RATE_LIMIT_PER_MINUTENoWrites one agent may ask for on one API in a minute; a plan counts as its number of steps. Default: 10.
LIBRARIAN_SUBSTRATE__CLAIMED_USER_HEADERNoRequest header in which the agents' platform names the person at the agent, e.g. X-User-Id. It is only shown to approvers and recorded as what the agent's side says.
LIBRARIAN_NOTIFIER__SLACK__APPROVER_GROUPNoA Slack user group to mention.
LIBRARIAN_SUBSTRATE__KAGENT_CACHE_SECONDSNoHow long the answer to which Agent a session is gets reused. Default: 60.
LIBRARIAN_PUBLISH__GITHUB_APP__PRIVATE_KEYNoThe GitHub App private key, inline.
LIBRARIAN_LEARNING__SEARCH__ALLOW_THIRD_PARTYNoAlso use pages outside the API's own domain and the well-known documentation hosts. Default: false.
LIBRARIAN_PUBLISH__GITHUB_APP__INSTALLATION_IDNoThe GitHub App installation id. Found automatically when unset.
LIBRARIAN_PUBLISH__GITHUB_APP__PRIVATE_KEY_FILENoA file holding the GitHub App private key.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Server capabilities have not been inspected yet.

Tools

Functions exposed to the LLM to take actions

NameDescription

No tools

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources