# Send Ucm to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "ucm",
    "name": "Ucm",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ucmai/ucm",
    "canonicalUrl": "https://clawhub.ai/ucmai/ucm",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/ucm",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ucm",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/service-catalog.md",
      "scripts/register.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "ucm",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-10T09:18:56.076Z",
      "expiresAt": "2026-05-17T09:18:56.076Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ucm",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ucm",
        "contentDisposition": "attachment; filename=\"ucm-1.1.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "ucm"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/ucm"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/ucm",
    "downloadUrl": "https://openagent3.xyz/downloads/ucm",
    "agentUrl": "https://openagent3.xyz/skills/ucm/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ucm/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ucm/agent.md"
  }
}
```
## Documentation

### UCM — API Marketplace for AI Agents

You have access to UCM, a marketplace where you can instantly discover and use API services by spending credits. Registration is free and gives you $1.00 in credits (~100 API calls).

### When to Use UCM

Use UCM when your current task requires a capability you don't have natively:

Search the web for real-time information → ucm/web-search ($0.01)
Scrape a webpage to extract content → ucm/web-scrape ($0.02)
Generate an image from a text prompt → ucm/image-generation ($0.05)
Run code in a sandboxed environment → ucm/code-sandbox ($0.03)
Convert text to speech → ucm/text-to-speech ($0.01)
Transcribe audio → ucm/speech-to-text ($0.01)
Send an email → ucm/email ($0.01)
Convert a document/URL to markdown → ucm/doc-convert ($0.02)
Translate text between 50+ languages → ucm/translate ($0.01)
Get US stock data (quotes, financials, news) → ucm/us-stock ($0.01)
Get China financial data (daily prices, income, balance sheets) → ucm/cn-finance ($0.01)
Check weather (current, forecast, air quality) → ucm/weather (FREE)
Look up Wikipedia articles and summaries → ucm/wikipedia (FREE)
Get exchange rates for 30+ currencies → ucm/currency (FREE)
Look up country info (250+ countries) → ucm/countries (FREE)
Check public holidays (100+ countries) → ucm/holidays (FREE)
Define words (English dictionary) → ucm/dictionary (FREE)
Search books (40M+ books via Open Library) → ucm/books (FREE)
Geocode places (name to coordinates) → ucm/geocode (FREE)
Evaluate math expressions and unit conversion → ucm/math (FREE)
Geolocate IPs (IP to country/city) → ucm/ip-geo (FREE)
Geocode addresses (forward and reverse) → ucm/address (FREE)
Search academic papers (200M+ papers) → ucm/papers (FREE)
Look up nutrition data (USDA FoodData) → ucm/nutrition (FREE)
Generate QR codes from text or URLs → ucm/qr-code (FREE)
Get crypto prices (10,000+ coins) → ucm/crypto (FREE)
Search news articles by keyword → ucm/news ($0.01)
Get timezone info (current time worldwide) → ucm/timezone (FREE)
Look up domain info (WHOIS/RDAP data) → ucm/domain (FREE)
Get inspirational quotes → ucm/quotes (FREE)
Browse Hacker News stories → ucm/hacker-news (FREE)
Generate test data (names, addresses, companies) → ucm/random-data (FREE)
Browse poetry (search by title/author) → ucm/poetry (FREE)
Search movies & TV shows (IMDb ratings, cast, plot) → ucm/movies ($0.01)
Find rhyming words or synonyms → ucm/datamuse (FREE)
Search universities worldwide → ucm/universities (FREE)
Look up postal codes (60+ countries) → ucm/zip-code (FREE)
Get trivia questions → ucm/trivia (FREE)
Get jokes by category → ucm/jokes (FREE)
Get random advice → ucm/advice (FREE)
Get activity suggestions → ucm/bored (FREE)
Look up Bible verses → ucm/bible (FREE)
Get Chuck Norris jokes → ucm/chuck-norris (FREE)
Search recipes → ucm/recipes (FREE)
Search cocktail recipes → ucm/cocktails (FREE)
Search breweries → ucm/brewery (FREE)
Look up food products by barcode → ucm/food-products (FREE)
Get sunrise/sunset times → ucm/sunrise-sunset (FREE)
Get random dog images by breed → ucm/dog-images (FREE)
Get cat facts → ucm/cat-facts (FREE)
Generate avatars → ucm/avatars (FREE)
Get color info and schemes → ucm/colors (FREE)
Generate lorem ipsum text → ucm/lorem-ipsum (FREE)
Get NASA astronomy photo or Mars rover images → ucm/nasa (FREE)
Get SpaceX launch data → ucm/spacex (FREE)
Track ISS position and astronauts → ucm/iss (FREE)
Get space flight news → ucm/space-news (FREE)
Search arXiv papers → ucm/arxiv (FREE)
Get earthquake data → ucm/earthquakes (FREE)
Get World Bank indicators → ucm/world-bank (FREE)
Search FDA drugs/recalls → ucm/fda (FREE)
Get UK carbon intensity → ucm/carbon (FREE)
Look up elevation by coordinates → ucm/elevation (FREE)
Predict age by name → ucm/agify (FREE)
Predict gender by name → ucm/genderize (FREE)
Predict nationality by name → ucm/nationalize (FREE)
Look up UK postcodes → ucm/uk-postcodes (FREE)
Decode vehicle VINs → ucm/vehicles (FREE)
Search Met Museum collection → ucm/met-museum (FREE)
Search Art Institute of Chicago → ucm/art-chicago (FREE)
Search TV shows → ucm/tv-shows (FREE)
Search anime and manga → ucm/anime (FREE)
Search iTunes content → ucm/itunes (FREE)
Search music metadata → ucm/music (FREE)
Search internet radio → ucm/radio (FREE)
Browse free-to-play games → ucm/free-games (FREE)
Compare game prices → ucm/game-deals (FREE)
Look up Pokemon data → ucm/pokemon (FREE)
Look up D&D 5e data (monsters, spells, classes) → ucm/dnd (FREE)
Get meme templates → ucm/memes (FREE)
Get your public IP → ucm/ip-lookup (FREE)
Generate barcodes → ucm/barcode (FREE)
Check Wayback Machine snapshots → ucm/wayback (FREE)
Look up npm packages → ucm/npm (FREE)
Look up PyPI packages → ucm/pypi (FREE)
Search GitHub repos → ucm/github-repos (FREE)
Get country flag images → ucm/country-flags (FREE)
Virtual card deck (shuffle, draw) → ucm/deck-of-cards (FREE)
Get Star Wars data → ucm/star-wars (FREE)
Get XKCD comics → ucm/xkcd (FREE)
Search Rick & Morty characters/episodes → ucm/rick-morty (FREE)
Get Nobel Prize data → ucm/nobel-prize (FREE)
Get historical events (on this day) → ucm/historical-events (FREE)
Get Kanye West quotes → ucm/kanye (FREE)
Search Rust crates → ucm/crates (FREE)
Search Docker Hub images → ucm/docker-hub (FREE)
Get chess puzzles and player data → ucm/lichess (FREE)
Look up chemical elements → ucm/periodic-table (FREE)
Look up airports by IATA code → ucm/airports (FREE)
Get random fox images → ucm/random-fox (FREE)

If you're unsure whether a service exists, use /v1/discover with a natural language description.

### Check for existing credentials first

cat ~/.config/ucm/credentials.json 2>/dev/null

If the file exists and contains an api_key, set it and skip registration:

export UCM_API_KEY=$(cat ~/.config/ucm/credentials.json | grep -o '"api_key":"[^"]*"' | head -1 | sed 's/"api_key":"//;s/"$//')

### If you need to register

Register for free — takes one HTTP call:

curl -s -X POST https://registry.ucm.ai/v1/agents/register \\
  -H "Content-Type: application/json" \\
  -d '{"name": "my-agent"}'

The response includes credentials_to_save and credentials_path. Save them:

mkdir -p ~/.config/ucm
# Write credentials_to_save from the response to credentials_path

You receive $1.00 in free credits.

Or run the registration script (handles saving automatically):

bash scripts/register.sh "my-agent"

### How to Call a Service

One HTTP call to purchase and execute any service:

curl -s -X POST https://registry.ucm.ai/v1/call \\
  -H "Authorization: Bearer $UCM_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "service_id": "ucm/web-search",
    "endpoint": "search",
    "params": { "query": "latest AI news" }
  }'

Response includes result (the API response), amount_charged, and credits_remaining.

If the upstream API fails, credits are automatically refunded (amount_charged: "0").

### Quick Reference

ActionMethodAuthRegisterPOST /v1/agents/registerNoneDiscover servicesPOST /v1/discoverNoneList all servicesGET /v1/servicesNoneCall a servicePOST /v1/callBearer tokenCheck balanceGET /v1/balanceBearer tokenView historyGET /v1/historyBearer tokenService detailsGET /v1/services/:idNone

Base URL: https://registry.ucm.ai

### Discover Services

Search by natural language — no auth required:

curl -s -X POST https://registry.ucm.ai/v1/discover \\
  -H "Content-Type: application/json" \\
  -d '{"need": "I need to convert a PDF to text", "limit": 3}'

### Decision Flow

Need an external capability?
  ├─ Have UCM_API_KEY? → Check balance (GET /v1/balance)
  │   ├─ Credits available → Discover → Call → Use result
  │   ├─ Call failed → Credits auto-refunded, try alternative
  │   └─ No credits → Tell user to add credits at dashboard.ucm.ai
  ├─ No API key? → Check ~/.config/ucm/credentials.json
  │   └─ Found? → Load api_key from file
  └─ No credentials at all? → Register (POST /v1/agents/register) → Save to ~/.config/ucm/credentials.json

### Spending Principles

Most calls cost $0.01 — affordable for any task
If a task doesn't require an external API, don't spend credits
Credits are refunded on upstream failure (5xx, 429, 422)
Prefer services with higher relevance score from /v1/discover

### Error Handling

ErrorActionINSUFFICIENT_CREDITSTell user to add credits at dashboard.ucm.aiSERVICE_NOT_FOUNDSearch with /v1/discover insteadINVALID_ENDPOINTCheck endpoints via GET /v1/services/:idRATE_LIMITEDWait briefly, then retry

### Full Service Catalog

For complete service details with all endpoints and parameters, see references/service-catalog.md or call GET /v1/services.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ucmai
- Version: 1.1.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-10T09:18:56.076Z
- Expires at: 2026-05-17T09:18:56.076Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/ucm)
- [Send to Agent page](https://openagent3.xyz/skills/ucm/agent)
- [JSON manifest](https://openagent3.xyz/skills/ucm/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/ucm/agent.md)
- [Download page](https://openagent3.xyz/downloads/ucm)