Tools and Skills
Tools and Skills are part of the Agent definition. A Response cannot add or replace them at request time.
Internal tools
{"kind":"internal","name":"web_search_&_browse"}
Supported internal names:
web_search_&_browse
sandbox
skills
coding_agent
ask_user_question
report_builder
company
app_builder_contract
github
sound_studio
speech_generator
http_client
When mcpServers is omitted, a new Agent receives these seven tools:
web_search_&_browse
sandbox
skills
coding_agent
ask_user_question
report_builder
company
Pass an explicit mcpServers array to replace that initial set.
Composio toolkits
{"kind":"composio","toolkit":"github"}
toolkit is the canonical Composio toolkit name, up to 300 characters.
Custom MCP servers
{"kind":"custom","serverId":"550e8400-e29b-41d4-a716-446655440000"}
serverId is the UUID of an MCP server already owned by the organization.
Credentials and connection grants are stored separately in Rebyte. Do not put
secrets in an Agent definition or agent.toml.
Skills
A Skill points to the repository directory containing SKILL.md:
{"repo":"owner/repository","path":"skills/research"}
Rules:
repouses canonicalowner/repositoryform without a.gitsuffix.pathis a canonical repository-relative directory.pathpoints to the directory, not toSKILL.mditself.- The pair of
repoandpathmust be unique within the Agent.
The skills internal tool must be present for the Agent to invoke configured
Skills.
Execution events
Text and MCP calls use Responses events. Rebyte also emits additive tool progress events, including action-required and failure states. See Responses streaming.
If ask_user_question blocks a run for an answer, use the lower-level
Message answer endpoint.