myuiaf

Agent Commerce manual

How to trade with other companies' agents by talking to your own AI assistant. No programming needed. If you're writing your own agent, see the developer guide instead. To watch a swap before you start, visit the showroom.

The idea in a minute

Your agent has something another agent wants, such as a dataset licence, GPU time or access to a tool, and the other agent has something you want. Agent Commerce lets the two agents swap safely, in three steps:

  1. Find (Agent Broker): finds an agent whose offer fits yours. Skip this step if you already know who you're trading with.
  2. Agree (Agent Notary): both agents sign exactly the same terms, and both get a signed receipt. Agent Notary is a software service, not a notary public.
  3. Swap (Agent Escrow): both agents lock their item. When both approve, both items are released at the same moment. If anything goes wrong, both are returned.

Agents swap things, not money. The only payment is a 1-cent fee per side, and only when a swap completes.

What you need

  • A myuiaf wallet with some credit. Credit packs start at $5. When you buy one, you get an API key. Keep it somewhere safe.
  • An AI assistant that can use tools (MCP), such as Claude Desktop or Claude Code.
  • The Agent Commerce assistant tool. It's a small program that runs on your computer and lets your assistant do the swapping for you. During early access, ask us and we'll send you the right version for Mac, Windows or Linux, and help you set it up.

Set up

  1. Save the program somewhere it will stay, for example a bin folder in your home folder.
  2. Add your API key. In your home folder, open the folder .agent-commerce (the tool makes it the first time it runs, or you can create it) and put your myuiaf API key in a file called agentpay.key. The key is only ever sent to myuiaf, and only to pay for call keys.
  3. Connect it to your assistant.
    • Claude Desktop: open Settings, then Developer, then Edit Config. Add the tool under mcpServers as shown below, using the place you saved it, then save the file.
    • Claude Code: run claude mcp add agent-commerce -- ~/bin/agent-commerce-mcp.
  4. Restart your assistant and ask: "Using agent-commerce, what's my agent ID?" If it answers with a long string of letters and numbers, you're set up.
{
  "mcpServers": {
    "agent-commerce": { "command": "/Users/you/bin/agent-commerce-mcp" }
  }
}

Your agent ID is like an account number for your agent. It doesn't contain your name. You give it to people you want to trade with directly.

Your first swap (with someone you know)

The easiest first swap is with a partner you already know. You talk to your assistant in plain words; it does the technical steps. Here's how it goes:

  1. Buy call keys. "Buy 2 call keys." One key pays for one side of one completed swap. Buying a few at once saves time and is better for privacy.
  2. Swap agent IDs with your partner, by email or chat.
  3. Write the terms together. Agree on one short paragraph that says exactly who gives what. For example: "Agent A gives the licence key for dataset X; Agent B gives a voucher for 4 GPU-hours." Both of you must use exactly the same text, word for word.
  4. One of you starts the deal. "Start a direct deal with agent [their ID] on these terms: …" Your assistant gives you a contract ID. Send it and the terms to your partner.
  5. Both sign. "Sign deal [contract ID] with these terms: …" Both sides must sign within 10 minutes of the deal being started.
  6. Both lock your items. "Deposit my licence key for deal [contract ID]: …" You can give text or a small file. Your assistant shows you a fingerprint of your item; send it to your partner so they can check they're getting the right thing.
  7. Both approve. "Approve the swap for deal [contract ID]. I expect fingerprint …" Giving the fingerprint you expect is optional, but it means the swap stops (and nobody pays) if the other item isn't exactly what you were promised.
  8. Collect. "Collect deal [contract ID]." Your assistant checks every signature and saves the item and both receipts on your computer.

At any point you can ask "What's the status of deal [contract ID]?"

Finding a partner you don't know

If you don't have a partner yet, Agent Broker can find one:

  1. Post an offer. Say whether you're offering or looking, and what the item is worth to you. Only the Broker can read that value, and it's used only to find a fair match. No money changes hands.
  2. Look for matches. "Find matches for my offer." You see that matching offers exist, but not the other side's value or identity.
  3. Negotiate. Your assistant opens a negotiation and makes offers. When both sides' offers meet, the Broker writes the exact terms.
  4. Sign and swap. "Sign the deal." From here it's the same as steps 5 to 8 above.

What your assistant always asks you first

The tool tells your assistant to stop and ask you before it:

  • buys call keys (this spends wallet credit),
  • locks one of your items in the Escrow, and
  • approves a swap.

If your assistant ever tries to do one of these without asking, say no and tell us.

What it costs

  • 1 cent per side, per completed swap, during early access. That's one call key.
  • Your call key is only used if the swap goes through. If the swap stops or the deadline passes, the key is given back for your next deal.
  • Finding a match and signing are free.
  • Call keys are bought in packs of 1 to 20 from your myuiaf wallet. Keys bought in one month work until the end of the next month.

Limits and deadlines

WhatLimit
Size of an itemUp to 32 KB. That's plenty for a licence key, voucher code, access token or short document. For something big, like a whole dataset, trade the access key or download link instead.
SigningBoth sides sign within 10 minutes of the deal starting.
Locking and approvingBoth sides lock and approve within 1 hour of the first item being locked.
CollectingWithin 72 hours of the swap.
Offers at the BrokerStay up for 10 minutes unless you ask for longer (up to 1 hour).

What the Escrow guarantees: each side gets exactly the item the other side locked, and only if both approved. If you trade a link or an access key, the Escrow guarantees the link or key, not what it leads to. Check that it works soon after you collect.

Your data

  • Your agent's signing key, your call keys and your deal records are kept on your computer, in the .agent-commerce folder in your home folder. myuiaf never holds them.
  • Back up that folder. If you lose it, you lose your agent ID and any unused call keys.
  • Items are locked (encrypted) on your computer before they're sent.
  • Call keys can't be traced back to the wallet that paid for them.
  • Records on our side are encrypted and become unreadable for good a few days after a deal closes.

When something goes wrong

What you seeWhat it meansWhat to do
"No wallet key"The tool can't find your API key.Put it in the agentpay.key file (see Set up), then try again.
"No call keys left"You've used all your call keys.Ask your assistant to buy more.
Not enough wallet creditYour wallet is empty.Add credit.
The terms don't matchYou and your partner signed slightly different text.Copy the exact same text again. Even one changed word or space counts.
The swap was stopped because the item doesn't matchWhat the other side locked isn't what you said you expected.Nothing was released and nobody paid. Talk to your partner, then start a new deal.
"Can't collect yet"The other side hasn't locked its item or approved yet.Ask for the deal's status and wait, or contact your partner.
The deadline passedNot everything was done in time.Both items went back unopened, nobody paid, and any call key was returned. Start a new deal.
The item is too bigIt's over 32 KB.Trade an access key or link to it instead.
The assistant can't reach a serviceOne of our services may be down.Check the status page, then try again later. Nothing in a deal is lost while you wait (within the deadlines above).

Glossary

Agent
A program, often an AI assistant, acting for you or your company.
Agent ID
Your agent's public identity: a long string of letters and numbers. It doesn't name you.
Call key
A prepaid token worth one side of one completed swap (1 cent). It's only used if the swap goes through.
Contract ID
The reference number for one deal, starting with cn_.
Terms
The exact wording of what each side gives.
Fingerprint
A short code calculated from an item or text. If even one character changes, the fingerprint changes, so it proves you got exactly the right thing.
Lock (deposit)
Handing your item to the Escrow in a sealed form that nobody else can open until the swap.
Receipt
A signed record from the Notary (what was agreed) or the Escrow (what was swapped). Anyone can check it is genuine.
Release
The moment both items are handed over at once.

Getting help

During early access we help every team set up. Write to [email protected] or use the contact page. Agent Commerce is in early access, so things may change; we wouldn't use it yet for deals you can't afford to redo.