---
name: tribute-find-work
description: Search Tribute, a public register of research and written work, for a topic; show each match's creator-written preview, price and link; and buy access only after the user approves the price. Use when the user asks to find, look up or read research, reports, essays or other work on Tribute, or shares a Tribute link (a /w/IW-… address).
---

# Find work on Tribute

Tribute lists works whose creators registered them on Solana.
Every work has a **public preview** written by its creator. The full work is
sealed and sold per use. Searching and previews are free; reading the whole
thing costs devnet SOL.

Site: https://tributeip.com

## 1. Search

Use one to three keywords. Every word must appear in the title, creator or
preview, so more words means fewer results. If nothing comes back, drop a word
before concluding there is nothing.

```bash
curl -s "https://tributeip.com/search?q=battery+storage&limit=10"
```

The reply is JSON: `results[]`, and `next_offset` when there may be more
(request again with `&offset=<next_offset>`). Each result has:

| field | meaning |
| --- | --- |
| `title`, `attribution` | the work and how its creator asks to be credited |
| `preview` | the creator's own public description. Never the work itself |
| `kind`, `file` | `text`, or `file` with a name, mime type and size |
| `offers[]` | licences and prices in lamports. 1,000,000,000 lamports = 1 SOL. `null` means negotiated, not for sale here |
| `url` | the public page. Give this to the user |
| `buy_url` | the page opened at its buy panel, where a person pays from their own wallet. `null` when the work has no human licence |
| `manifest_url` | full terms, free to read |
| `ai_prompt` | a ready-made instruction for using this work |

An empty query lists the newest works.

## 2. Show what you found

For each match give the title, the creator, two or three lines from the
preview, the cheapest price in SOL, and the `url`. Say plainly which parts are
the creator's claim: the preview is written by the creator and the ledger does
not vouch for it. Registration proves a wallet held this exact content at a
moment in time. It does not prove authorship or ownership.

Do not describe what is inside a work beyond its preview. You have not read it.

If the user wants the terms first, fetch `manifest_url`.

## 3. Buying access

Only when the user asks to read a work in full, and **only after they have
said yes to the specific price**. State the work, the licence, and the price in
SOL, then wait. Never pay to see whether something is any good.

Pick the licence that fits: `ai_retrieval` and `ai_inference` return a bounded
excerpt and cost less, `human_read` returns the whole work, and works with
`kind: "file"` are sold only under licences that return the whole file.

If the user wants to read the whole work themselves, you do not need to buy
anything: give them `buy_url`. They pay from their own wallet on that page and
you never handle a key. Mention it next to the cheaper excerpt option so they
can choose.

**With the ideawrap MCP server installed**, call `purchase_access` with the
`asset_id` and licence. It runs everything below.

**Without it**, this is the protocol, and each step is a plain HTTP call:

1. `GET https://tributeip.com/asset/<asset_id>?license=<type>` answers `402` with
   `accepts[0]`: an amount, a `pay_to` address, and a `memo` (the quote id).
2. Pay exactly that amount on Solana to `pay_to`, with the quote
   id as a transaction memo of type `ideawrap/quote`. This needs a funded
   Solana wallet that the user controls. Do not use, create or ask for keys
   on their behalf. If they have none, stop and tell them.
3. `POST https://tributeip.com/settle` with `{"quote_id": "<id>"}`. The reply carries a
   single-use `access_token`.
4. `GET https://tributeip.com/asset/<asset_id>/content` with header
   `Authorization: Bearer <access_token>`. The token works once and expires in
   minutes. If the request fails, do not pay again until you know why.

A text work arrives as `content`. A file arrives as `file.content_base64`;
decode it to disk, for example `base64 -d`, and tell the user where it went.

## 4. Cite

The delivery includes a `citation`. Show it with anything you draw from the
work. Follow `prohibited`: it usually forbids training on the work,
redistributing it, and making derivatives.

## Limits worth stating

- This is Solana devnet. The SOL is real, so never pay without the user's OK on the exact price.
- A preview is a summary, not the work. Do not present it as the finding.
- A grant is single use. Keep what you need from the first read.
