REST

API Documentation

REST reference — search tools, call tools, handle errors.

Quick Start

Uno has two endpoints. That's it.

1. Search Tools

GET/v1/tools

GET /v1/tools?q=weather&limit=5
Authorization: Bearer <API_KEY>

Returns tools with input_schema (JSON Schema) so you know exactly what arguments to pass.

2. Call a Tool

POST/v1/call

POST /v1/call
Authorization: Bearer <API_KEY>
Content-Type: application/json

{"tool": "amap-maps.weather", "arguments": {"city": "北京"}}

JSON

Response Format

{
  "data": {"temperature": "22C", "weather": "晴"},
  "error": null,
  "meta": {"latency_ms": 234, "credits_used": 1.0}
}

MCP & SDK

Connect Claude Desktop, Cursor, or any MCP client to use all Uno tools — no code needed. Or integrate with Python SDK for programmatic access.

Claude Desktop / Cursor

{
  "mcpServers": {
    "uno": {
      "url": "https://clawdtools.uno/mcp"
    }
  }
}

OAuth login opens automatically in your browser. After authorization, tools are available instantly.

Python SDK

from uno import Uno
from uno.adapters import OpenAIAdapter

uno = Uno(api_key="uk-xxx")
tools = uno.search("weather", adapter=OpenAIAdapter())
result = uno.call("weather-free.get_current_weather", {"location": "Beijing"})

pip install uno-sdk

Authentication

All requests need a Bearer token (API Key). Get one from the API Keys page.

For CLI Agents (Device Code Flow)

# 1. Request device code
curl -s -X POST https://clawdtools.uno/oauth/device/code \
  -d '{"client_id":"my-agent"}'

# 2. User authorizes, then poll for token
curl -s -X POST https://clawdtools.uno/oauth/token \
  -d '{"device_code":"DEVICE_CODE","client_id":"my-agent"}'

Agent Integration (skill.md)

Any agent can integrate Uno with a single command:

curl -s https://clawdtools.uno/v1/skill.md

This returns a Markdown guide that agents can follow to search and call tools.

Error Handling

error	Meaning
`tool_not_found`	Tool slug doesn't exist
`auth_required`	Tool needs OAuth — check auth_url in response
`insufficient_credits`	Out of credits — check recharge_url

Pricing

Free: 500 credits daily, auto-reset
Most tools: 1 credit per call
AI generation tools: 5-10 credits per call