Configuration — tools and custom providers

tools.* config keys and custom provider / base-URL setup. For agents, channels, and other top-level config keys, see Configuration reference.

What each page covers

• Configuration — tool policy — tool profiles, tool groups, the sandbox tool gate, tools.codeMode, and the allow/deny, byProvider, toolsBySender, and elevated layers.
• Configuration — GitHub identity for agent tools — tools.github: the shared managed gh identity, token refresh, and the execution boundaries that receive it.
• Configuration — built-in tool settings — tools.exec, tools.loopDetection, tools.web, tools.media, and tools.updatePlan.
• Configuration — cross-agent, session, and subagent tools — tools.agentToAgent, tools.sessions visibility, tools.sessions_spawn attachments, and agents.defaults.subagents.
• Configuration — custom providers and base URLs — models.providers registration, base-URL trust, and the provider field reference.
• Configuration — provider examples — worked configurations for Cerebras, Kimi, llama.cpp, LM Studio, MiniMax, Moonshot, OpenCode, Synthetic, and Z.AI.

Where each section moved

Every heading this page used to publish keeps its anchor here, so an existing link such as /gateway/config-tools#tools-agenttoagent still resolves. Each entry points at the page that now holds the content.

• Tools
• Tool profiles
• Tool groups
• MCP and plugin tools inside sandbox tool policy
• tools.codeMode
• tools.allow / tools.deny
• tools.byProvider
• tools.toolsBySender
• tools.elevated
• tools.github
• tools.exec
• tools.loopDetection
• tools.web
• tools.media
• Media model entry fields
• tools.updatePlan
• tools.agentToAgent
• tools.sessions
• Visibility scopes
• tools.sessions_spawn
• Attachment notes
• agents.defaults.subagents
• Custom providers and base URLs
• Auth and merge precedence
• Provider field details
• Top-level catalog
• Provider connection and auth
• Request transport overrides
• Model catalog entries
• Custom provider capability declarations
• Amazon Bedrock discovery
• Provider examples
• Cerebras (GLM 4.7 / GPT OSS)
• Kimi Coding
• Local models (llama.cpp / llama-server)
• Local models (LM Studio)
• MiniMax M3 (direct)
• Moonshot AI (Kimi)
• OpenCode
• Synthetic (Anthropic-compatible)
• Z.AI (GLM-4.7)

Related

• Configuration — agents
• Configuration — channels
• Configuration reference — other top-level keys
• Tools and plugins