# Agent skills

Reusable workflows you can run against the Coinset **[MCP server](/docs/mcp)**. Each "skill" is just
a repeatable task an AI agent performs with the MCP tools — some work in any MCP client today,
others add notifications by leaning on Coinset **[webhooks](/docs/webhooks)** or a scheduling
runtime.

You don't need anything beyond a connected MCP client to use the read-only skills below — paste the
prompt into your agent.

## Built-in prompts

The MCP server already ships these as **prompts** your client can invoke directly (no setup):
`network_status`, `address_summary`, `transaction_summary`, `offer_summary`, `block_summary`. Use
them for the common one-shot questions; the skills below go further.

## Read-only skills (any MCP client)

These run entirely through MCP tool calls and need no scheduling.

### offer-safety-check

Decode an `offer1…` and decide whether it's a fair trade before you take it.

* **Tools:** `decode_offer`, `get_price`, `get_asset_info`
* **Prompt:** *"Decode this offer and tell me what I give vs. get, then value both sides at the current XCH price and flag if it looks unfair: `offer1…`"*

### coin-lineage

Trace a coin's ancestry or descendants across multiple hops.

* **Tools:** `find_coins` (by `parent_ids`), `get_transaction`, `inspect`
* **Prompt:** *"Walk the children of coin `0x…` for 3 hops and classify each one."*

### nft-provenance

Reconstruct an NFT's full on-chain history.

* **Tools:** `get_asset_info` (kind `nft`), `get_asset_coins`, `list_transactions` (by `nft`)
* **Prompt:** *"Show the ownership history of NFT `nft1…` from mint to now."*

### spend-explainer

Explain in plain language what a transaction or coin spend actually did.

* **Tools:** `get_transaction`, `inspect`
* **Prompt:** *"Explain transaction `0x…`: the transfers, swaps, royalties, and fee."*

### portfolio-snapshot

Summarize everything held at an address, valued in USD.

* **Tools:** `get_address_balance`, `list_address_assets`, `list_transactions`, `get_price`
* **Prompt:** *"Summarize the holdings and recent activity of `xch1…`, with USD values."*

## Watch & notify skills (need webhooks or a scheduler)

These repeat on a schedule or react to events, so they need either Coinset
**[webhooks](/docs/webhooks)** (for push notifications) or an agent runtime that can run on a timer
and persist state (e.g. scheduled skills).

### watch-address

Notify when XCH, a CAT, or an NFT lands at (or leaves) an address. Best implemented with a
**transaction**/**offer** webhook filtered to the address; an agent can summarize each delivery
using `get_transaction`.

### watch-tx-confirmation

Ping when a specific transaction moves from mempool to confirmed.

* **Tools:** `wait_for_confirmation` (short waits) or a confirmation webhook.

### watch-price

Alert when XCH crosses a price threshold.

* **Tools:** `get_price` on a schedule.

### watch-fee-market

Catch cheap fee windows for broadcasting.

* **Tools:** `estimate_fee` on a schedule.

### address-daily-digest

A scheduled daily summary of one or more addresses with USD values (the `portfolio-snapshot` skill
on a timer).

## Notes

* All skills are **read-only**: the MCP server never signs or broadcasts.
* For exact request/response shapes behind any tool, see the **[API reference](/docs/api)**.
* Multi-network: pass `network: "testnet11"` (or use a `txch1…` address) on any tool to run a skill
  against testnet instead of mainnet.