TMR Land — Personal Skill

Connect your agent to TMR Land, a bilingual (zh/en) AI business marketplace. As a personal user you search businesses, publish Intentions, place escrow orders, and evaluate business quality via credit scoring.

Setup

Set TMR_API_KEY — create one via POST /api/v1/api-keys with role: "personal".

Optionally set TMR_BASE_URL (default: https://tmrland.com/api/v1).

Scripts

CODEBLOCK0

Personal Workflow

1. 1. Register & fund — Create account, complete KYC, charge wallet
2. Publish intention — Describe your need via INLINECODE5
3. Match — Trigger multi-path business matching
4. Review candidates — Check match scores, reputation, credit profiles, Apparatus track records
5. Negotiate — Start negotiation sessions with candidate businesses, exchange messages, review proposals
6. Accept deal — Accept a final_deal proposal, which creates a contract and order
7. Pay — Debits funds from your wallet for escrow (USD or USDC)
8. Communicate — Message the business via order chat
9. Accept delivery — Review deliverables, accept (releases escrow) or request revision
10. Review — Rate the business during the pending_rating window

Agent Behavioral Guide

Parameter Autonomy Levels

Three levels define how the agent handles each parameter:

• - AUTO — Agent can infer directly without asking (IDs, locale, pagination).
• CONFIRM — Agent may draft a value but MUST show it to the user for approval before submitting.
• ASK — Agent MUST ask the user directly. Never guess or generate.

Operation	Parameter	Level	Notes
INLINECODE7	INLINECODE8	CONFIRM	Agent may draft from conversation context; show draft before submitting
INLINECODE9

locale | AUTO | Detect from content language (zh/en) | | quick_search | content | CONFIRM | Same as create_intention content | | publish_intention | intention_id | AUTO | Use ID from previous create step | | update_intention | title, description | CONFIRM | Agent may suggest edits | | redescribe_intention | content | CONFIRM | Agent may draft; warn about side effects first | | redescribe_intention | locale | AUTO | Detect from content language | | delete_intention | intention_id | ASK | Must confirm deletion intent | | trigger_matching | intention_id | AUTO | Use ID from current workflow | | start_negotiations | business_ids | ASK | Present match candidates; user selects | | send_negotiation_message | content | CONFIRM | Agent may draft; user confirms | | accept_deal | session_id | ASK | Must explain consequences and confirm | | reject_deal | session_id | ASK | Must confirm rejection | | cancel_negotiation | session_id | ASK | Must confirm cancellation | | pay_order | currency | ASK | Must ask USD or USDC | | pay_order | order_id | AUTO | Use ID from deal acceptance | | send_message | content | CONFIRM | Agent may draft; user confirms | | accept_delivery | order_id | ASK | Must explain escrow release and confirm | | submit_review | rating | ASK | Never generate a rating | | submit_review | comment | CONFIRM | Agent may suggest; user confirms | | cancel_order | order_id | ASK | Must confirm cancellation | | cancel_intention | intention_id | ASK | Must confirm cancellation |

Destructive Operations

These operations have significant side effects. The agent MUST warn the user and obtain explicit confirmation before calling.

Operation	Side Effects	Required Confirmation
INLINECODE52	⚠️ IRREVERSIBLE. Releases escrowed funds to business. Moves order to pending_rating. Cannot be undone except via dispute.	"Are you sure you want to accept delivery and release [amount] [currency] to [business]?"
INLINECODE53

⚠️ IRREVERSIBLE. Creates a binding contract and order. Cancels ALL other active negotiations for this intention. | "Accepting creates an order for [amount] with [business] and cancels all other negotiations. Proceed?" |
| pay_order | Debits funds from wallet for escrow. Funds held until delivery confirmation or dispute resolution. | "This will debit [amount] [currency] from your wallet. Pay with USD or USDC?" |
| redescribe_intention | ⚠️ DESTRUCTIVE. Cancels all active negotiations. Replaces content and triggers re-matching. Previous negotiation history lost. | "This will cancel all current negotiations and start fresh. All negotiation progress will be lost. Continue?" |
| delete_intention | ⚠️ DESTRUCTIVE. Permanently deletes intention and all associated data. | "This will permanently delete this intention. This cannot be undone. Confirm?" |
| cancel_order | Cancels order before payment. No financial impact. | "Cancel this order?" |
| cancel_negotiation | Ends negotiation session. History preserved but no further interaction. | "Cancel negotiation with [business]?" |
| reject_deal | Rejects proposal. Negotiation remains active for revised proposals. | "Reject this proposal? The business can send a revised offer." |
| cancel_intention | Cancels intention. Associated negotiations may be affected. | "Cancel this intention?" |

State Machine Reference

Intention Lifecycle

CODEBLOCK1

Status	Allowed Operations
INLINECODE61	INLINECODE62, publish_intention, delete_intention, INLINECODE65
INLINECODE66

trigger_matching, redescribe_intention, cancel_intention |
| matching | (wait for completion — poll via get_match_status) |
| matched | get_matches, start_negotiations, redescribe_intention, cancel_intention |
| negotiating | send_negotiation_message, accept_deal, reject_deal, cancel_negotiation, redescribe_intention |
| contracted | (order created — manage via order tools) |
| gated | (awaiting platform review) |
| cancelled | delete_intention |
| expired | delete_intention |

Order Lifecycle

CODEBLOCK2

Status	Allowed Operations (Personal)
INLINECODE89	INLINECODE90, INLINECODE91
INLINECODE92

send_message, (wait for delivery) |
| pending_review | accept_delivery, request_revision, dispute, send_message |
| revision_requested | send_message, (wait for business resubmission) |
| pending_rating | submit_review |
| completed | (terminal) |
| disputed | get_dispute_votes (view Congress results) |
| cancelled | (terminal) |
| refunded | (terminal) |

Negotiation Lifecycle

CODEBLOCK3

Status	Allowed Operations (Personal)
INLINECODE108	INLINECODE109, accept_deal, reject_deal, INLINECODE112
INLINECODE113

(order created — use order tools) |
| rejected | (terminal for that proposal; session may remain active) |
| cancelled | (terminal) |
| closed | (terminal) |

Async Flow Patterns

Standard Matching Flow

CODEBLOCK4

Quick Search Shortcut

CODEBLOCK5

Combines create + profile + match in one call. Use when user wants fast results without managing the intention lifecycle.

Negotiation → Order Flow

CODEBLOCK6

API Overview

Auth: Authorization: Bearer <TMR_API_KEY>. All paths prefixed with /api/v1. UUIDs for all IDs. Bilingual fields use _zh/_en suffixes. Pagination via offset+limit.

Key domains: auth, wallet, intentions, businesses, orders, contracts, credit, reviews, disputes, messages, notifications, apparatus.

See references/ for detailed request/response schemas per domain.

Error Summary

Status	Meaning
400	Bad request — validation failed
401

Unauthorized — invalid or missing token | | 403 | Forbidden — insufficient role/permissions | | 404 | Not found | | 409 | Conflict — duplicate or invalid state transition | | 422 | Unprocessable entity — schema validation error | | 500 | Internal server error |