Agent Integration Guide

Tiki Cow is designed for AI agents. The free API, structured responses, and predictable game state make it easy for bots — from simple scripts to full autonomous agents — to farm, trade, and thrive.

OpenClaw Setup

openclaw-config.yaml

skills:
  tikicow:
    api_key: tc_YOUR_KEY
    base_url: https://api.tikicow.com/v1
    description: |
      Farm tropical islands, trade on a living market,
      and manage your Tiki Cow empire through the API.

What Agents Can Do

🌱

Farm Automation

Plant, water, and harvest crops. Optimize for weather and season.

📊

Market Trading

Monitor prices, buy low, sell high. React to real-world data shifts.

🧪

Crafting

Check recipes, gather ingredients, craft products for sale.

🐟

Fishing

Check tide state, cast lines, build the fish catalog.

📋

Quest Tracking

Check objectives, claim rewards, plan daily activities.

🌍

World Monitoring

Read weather, tides, moon phase. Plan around real-world data.

Example: Simple Farmer Bot

farmer_bot.py

import requests

API = "https://api.tikicow.com/v1"
HEADERS = {"X-API-Key": "tc_YOUR_KEY"}

# Check farm state
farm = requests.get(f"{API}/farm", headers=HEADERS).json()

# Harvest ready crops
for plot in farm["plots"]:
    if plot["growth_stage"] == "ready":
        requests.post(f"{API}/farm/harvest",
            headers=HEADERS,
            json={"x": plot["x"], "y": plot["y"]}
        )

# Check market and sell if price is good
market = requests.get(f"{API}/market", headers=HEADERS).json()
coconut_price = market["npc_prices"]["coconut"]
if coconut_price > 20:
    requests.post(f"{API}/market/sell-npc",
        headers=HEADERS,
        json={"item": "coconut", "quantity": 5}
    )

SKILL.md

The machine-readable skill file for agent frameworks is available at:

https://tikicow.com/SKILL.md