Tools

Tools give agents access to external systems (APIs, shell, git, messaging).

List available tools


GET /api/tools
Authorization: Bearer nxr_...

List builtin tools


GET /api/tools/builtin
Authorization: Bearer nxr_...

Create custom tool


POST /api/tools
Authorization: Bearer nxr_...
Content-Type: application/json
 
{
  "key": "internal-api",
  "name": "Internal API",
  "description": "Access internal company APIs",
  "category": "integration",
  "env_vars": ["INTERNAL_API_KEY"],
  "always_allowed": false
}

Update tool


PATCH /api/tools/{tool_id}
Authorization: Bearer nxr_...
Content-Type: application/json
 
{ "description": "Updated description" }

Delete tool


DELETE /api/tools/{tool_id}
Authorization: Bearer nxr_...

Tool files

Tools are file-based. Manage their definition files directly:


GET  /api/tools/{tool_id}/files
GET  /api/tools/{tool_id}/files/{file_path}
PUT  /api/tools/{tool_id}/files/{file_path}
DELETE /api/tools/{tool_id}/files/{file_path}

Export / import


GET /api/tools/{tool_id}/export          # download as ZIP
GET /api/tools/builtin/{key}/export      # export a builtin tool

Built-in tools

Key	Description
`github`	Read/write repos, issues, PRs via GitHub App
`gitlab`	GitLab read/write
`bash`	Execute shell commands in a sandbox
`git`	Run git commands (clone, commit, push, diff)
`telegram`	Send messages via Telegram bot
`email`	Send emails via SMTP
`mcp`	Connect to MCP servers
`scheduler`	Schedule recurring tasks

Model Profiles

Model profiles define reusable model configurations (model + temperature + max_tokens) that agents reference by tag.

List profiles


GET /api/model-profiles
Authorization: Bearer nxr_...

Create profile


POST /api/model-profiles
Authorization: Bearer nxr_...
Content-Type: application/json
 
{
  "name": "Fast and cheap",
  "provider_type": "openai",
  "model": "gpt-4o-mini",
  "temperature": 0.2,
  "max_tokens": 2048,
  "tags": ["fast", "cheap"]
}

Update / delete


PATCH /api/model-profiles/{profile_id}
DELETE /api/model-profiles/{profile_id}
Authorization: Bearer nxr_...

Resolve by tag


GET /api/model-profiles/resolve?tags=fast,cheap
Authorization: Bearer nxr_...

Marketplace

Install community-contributed agents, tools, and skills.

List items


GET /api/marketplace
Authorization: Bearer nxr_...

Get item details


GET /api/marketplace/{slug}
Authorization: Bearer nxr_...

Install item


POST /api/marketplace/{slug}/install
Authorization: Bearer nxr_...

Custom tools override builtin tools with the same key. Skills in seeds/skills/custom/ reload on next request — no restart needed.