uno

# Uno MCP Tools Call MCPMarket's REST API directly via `curl` to search and invoke 2000+ tools. No packages to install. ## Prerequisites - `curl` (pre-installed on most systems) ## Authentication ```bash # 1. Request a device code curl -s -X POST https://mcpmarket.cn/oauth/device/code \ -d "client_id=skill-agent&scope=mcp:*" ``` **You MUST display the exact `verification_uri` and `user_code` from the response to the user. Never construct or modify the URL yourself.** ```bash # 2. Poll for token after user authorizes (retry every 5s until access_token is returned) curl -s -X POST https://mcpmarket.cn/oauth/token \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "grant_type=urn:ietf:params:oauth:grant-type:device_code&device_code=DEVICE_CODE&client_id=skill-agent" # 3. Store the token mkdir -p ~/.uno && chmod 700 ~/.uno echo "ACCESS_TOKEN_VALUE" > ~/.uno/token && chmod 600 ~/.uno/token ``` Verify login: ```bash curl -s https://mcpmarket.cn/api/uno/verify-token \ -H "Authorization: Bearer $(cat ~/.uno/token)" ``` ## Two-Step Invocation (Core Flow) ```bash # Step 1: Search tools, get tool_name and inputSchema curl -s "https://mcpmarket.cn/api/uno/search-tools?q=weather&mode=hybrid&limit=5" \ -H "Authorization: Bearer $(cat ~/.uno/token)" # Step 2: Call the tool curl -s -X POST https://mcpmarket.cn/api/uno/call-tool \ -H "Authorization: Bearer $(cat ~/.uno/token)" \ -H "Content-Type: application/json" \ -d '{"tool_name":"tonghu-weather.weatherArea","arguments":{"area":"Beijing"}}' ``` ## API Endpoints | Endpoint | Method | Description | |----------|--------|-------------| | `/api/uno/search-tools` | GET | Search tools (main entry) — returns tools + inputSchema + stats | | `/api/uno/search-servers` | GET | Search servers | | `/api/uno/call-tool` | POST | Invoke a tool (server.tool_name format) | | `/api/uno/rate-server` | POST | Rate a tool/skill (tool_name or skill_id), affects search ranking | | `/api/uno/categories` | GET | List all categories with counts | | `/api/uno/credits` | GET | Query credit balance + recharge URL | | `/api/uno/skills-search` | POST | Search Agent Skills — returns meta + quality signals | | `/api/uno/skills-fetch` | POST | Fetch full Skill content (SKILL.md + file list) | All endpoints use Base URL `https://mcpmarket.cn` and require `Authorization: Bearer <token>`. ## search-tools Parameters | Parameter | Type | Description | |-----------|------|-------------| | `q` | string | Search keyword | | `category` | string | Browse by category, e.g. `search`, `dev`, `finance`, `social` | | `mode` | string | `keyword` (exact) / `semantic` / `hybrid` (recommended) | | `limit` | int | Number of results, default 5, max 15 | Returns: `tools[]` (with `tool`, `desc`, `inputSchema` + stats fields), `servers[]` **tools[] stats fields (for selection guidance):** | Field | Description | |-------|-------------| | `rating` | Score (0–5) | | `rating_count` | Number of ratings | | `avg_ms` | Average response latency (ms) | | `calls_7d` | Calls in the last 7 days | | `success_rate` | Success rate (0–1) | **Search keyword tips:** The backend vector index is built from tool *function descriptions*, so keywords should match **what the tool does**, not your query intent. - ✅ `weather` — matches weather tool descriptions - ❌ `weather in Shanghai tomorrow` — reads like a query, less likely to match tools ## call-tool Parameters | Parameter | Type | Description | |-----------|------|-------------| | `tool_name` | string | **Required** Format: `server_name.tool_name` (from `tool` field in search-tools result) | | `arguments` | object | **Required** Constructed from inputSchema | **Response structure:** ```json {"content": [{"type": "text", "text": "<JSON string>"}], "isError": false} ``` > `content[0].text` is itself a JSON string and needs to be parsed again. On error, `isError` is `true` and `error` contains the message. **Downstream OAuth:** Some services (e.g. GitHub, Notion) require authorization on first call: ```json {"auth_required": true, "auth_url": "https://...", "state_id": "..."} ``` Open `auth_url`, complete authorization, then **call again directly** — the platform links the token server-side automatically. ## categories (Browse by Category) ```bash curl -s https://mcpmarket.cn/api/uno/categories \ -H "Authorization: Bearer $(cat ~/.uno/token)" ``` Returns category names, counts, and representative server names. Useful when you're not sure which tool to use. ## rate-server (Rate After Use) After calling a tool or fetching a skill, submit a rating (0–5) to help improve search ranking: ```bash # Rate a tool (recommended — tool-level granularity) curl -s -X POST https://mcpmarket.cn/api/uno/rate-server \ -H "Authorization: Bearer $(cat ~/.uno/token)" \ -H "Content-Type: application/json" \ -d '{"tool_name":"amap-maps.maps_weather","rating":4.5,"user_id":"YOUR_USER_ID"}' # Rate a skill curl -s -X POST https://mcpmarket.cn/api/uno/rate-server \ -H "Authorization: Bearer $(cat ~/.uno/token)" \ -H "Content-Type: application/json" \ -d '{"skill_id":"abc123","rating":4.0,"user_id":"YOUR_USER_ID"}' ``` | Parameter | Description | |-----------|-------------| | `tool_name` | Rate a tool (server.tool format) | | `skill_id` | Rate a skill | | `server_name` | Legacy compatibility | | `rating` | 0.0–5.0 (required) | | `user_id` | User ID (required) | > When `call-tool` or `skills-fetch` succeeds, a `rating_hint` is included in the response. Please rate proactively when you receive it. ## credits (Balance + Recharge) ```bash curl -s https://mcpmarket.cn/api/uno/credits \ -H "Authorization: Bearer $(cat ~/.uno/token)" ``` Returns: ```json { "credits": 86, "daily_free_credits": 100, "daily_free_max": 100, "total_consumed": 14, "recharge_url": "https://mcpmarket.cn/billing" } ``` When credits run low, show `recharge_url` to the user. ## skills-search (Search Agent Skills) ```bash curl -s -X POST https://mcpmarket.cn/api/uno/skills-search \ -H "Authorization: Bearer $(cat ~/.uno/token)" \ -H "Content-Type: application/json" \ -d '{"q":"wechat article","mode":"hybrid","limit":5}' ``` Returns `skills[]`, each containing: | Field | Description | |-------|-------------| | `skill_id` | Unique ID, used for skills-fetch | | `skill_name` | Name | | `description` | Description (may include en/zh) | | `categories` | Category tags | | `stars` | GitHub stars | | `forks` | Fork count (popularity indicator) | | `token_count` | Token count of SKILL.md (loading cost reference) | ## skills-fetch (Fetch Full Skill Content) ```bash curl -s -X POST https://mcpmarket.cn/api/uno/skills-fetch \ -H "Authorization: Bearer $(cat ~/.uno/token)" \ -H "Content-Type: application/json" \ -d '{"skill_ids":["abc123","def456"]}' ``` Returns for each skill: - `skill_md`: Full SKILL.md content - `files`: File list - `download_url`: ZIP download link - `repo_url`: GitHub repository link > Maximum 10 skills per request. ## ⚠️ Parameter Construction Rules (Must Read) **Always read inputSchema before calling — never guess parameters.** | Check | Description | Common Mistake | |-------|-------------|----------------| | `required` fields | All must be provided | Missing required fields causes errors | | `minLength: 1` | No empty strings `""` | Empty query returns empty results | | Copy field names from schema | Don't rely on memory | `filter` vs `filters` — one character breaks everything | | `enum` constraints | Only valid enum values | Wrong value causes silent failure | | `description` | Read when field meaning is unclear | Avoid wrong format inputs | **Standard two-step flow (step 1 is mandatory):** ```bash # Step 1: search-tools, read inputSchema (always do this first) curl -s "https://mcpmarket.cn/api/uno/search-tools?q=<keyword>&mode=hybrid&limit=5" \ -H "Authorization: Bearer $(cat ~/.uno/token)" # → Check required / minLength / field names / enum carefully # Step 2: construct correct arguments from schema and call curl -s -X POST https://mcpmarket.cn/api/uno/call-tool \ -H "Authorization: Bearer $(cat ~/.uno/token)" \ -H "Content-Type: application/json" \ -d '{"tool_name":"<tool>","arguments":{<fill from schema>}}' ``` ## Workflow Tips 1. **Search tools first, read inputSchema before calling** — the most important step, never skip 2. **Keywords match tool function, not query intent** — `weather` ✅, `tomorrow's weather in Shanghai` ❌ 3. **Copy field names from schema** — don't rely on memory; `filters` ≠ `filter` 4. **Rate after successful calls** — when `rating_hint` is returned, call `rate-server` to help improve rankings 5. **Need a capability or guide** — use `skills-search` to find, `skills-fetch` to load full content 6. **No results** — try English keywords, or switch to `mode=semantic` 7. **Low credits** — use `credits` to check balance, direct user to `recharge_url` ## Credential Reference | Item | Value | |------|-------| | Token file | `~/.uno/token` (permissions 0600) | | API Base URL | `https://mcpmarket.cn` | | Logout | `rm ~/.uno/token` | ____