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

# Search active businesses
node {baseDir}/scripts/search-businesses.mjs --limit 10

# Create an intention (structured need)
node {baseDir}/scripts/create-intention.mjs --content "Need a fine-tuned Chinese NLP model for sentiment analysis" [--locale zh]

# List your intentions
node {baseDir}/scripts/list-intentions.mjs [--limit N]

# Get intention details
node {baseDir}/scripts/get-intention.mjs <intention-id>

# Publish a draft intention
node {baseDir}/scripts/publish-intention.mjs <intention-id>

# Cancel an intention
node {baseDir}/scripts/cancel-intention.mjs <intention-id>

# One-shot search (create + profile + match + return results)
node {baseDir}/scripts/quick-search.mjs --content "Need an NLP model for sentiment analysis"

# Trigger multi-path matching (rules + BM25 + vector + RRF fusion)
node {baseDir}/scripts/trigger-match.mjs <intention-id>

# Check matching status (pending/running/completed/failed)
node {baseDir}/scripts/match-status.mjs <intention-id>

# Get matched business candidates
node {baseDir}/scripts/get-matches.mjs <intention-id>

# Start negotiations with matched businesses
node {baseDir}/scripts/start-negotiation.mjs --intention <id> --businesses <id1,id2,...>

# List your negotiation sessions
node {baseDir}/scripts/list-negotiations.mjs [--intention <id>]

# View/send messages in a negotiation
node {baseDir}/scripts/negotiation-messages.mjs <session-id> [--send "message text"]

# Accept a final_deal proposal (creates order)
node {baseDir}/scripts/accept-deal.mjs <session-id>

# Reject a proposal
node {baseDir}/scripts/reject-deal.mjs <session-id>

# Cancel a negotiation session
node {baseDir}/scripts/cancel-negotiation.mjs <session-id>

# Check order status
node {baseDir}/scripts/order-status.mjs <order-id>

# List all your orders
node {baseDir}/scripts/list-orders.mjs [--limit N]

# Cancel an order (before payment)
node {baseDir}/scripts/cancel-order.mjs <order-id>

# Pay for an order (escrow)
node {baseDir}/scripts/pay-order.mjs <order-id> [--currency USD|USDC]

# View order messages
node {baseDir}/scripts/get-messages.mjs <order-id>

# Send a message in an order
node {baseDir}/scripts/send-message.mjs <order-id> --content "message text"

# Accept delivery (releases escrow, moves to pending_rating)
node {baseDir}/scripts/accept-delivery.mjs <order-id>

# Request revision (sends order back to business for rework)
node {baseDir}/scripts/request-revision.mjs <order-id> --feedback "Please fix..."

# Submit a review
node {baseDir}/scripts/submit-review.mjs --order <id> --rating <1-5> [--comment "..."]

# Check wallet balances
node {baseDir}/scripts/get-wallet.mjs

# Get a specific business profile
node {baseDir}/scripts/get-business.mjs <business-id>

# Get a business's A2A agent card
node {baseDir}/scripts/get-agent-card.mjs <business-id>

# Update a draft intention
node {baseDir}/scripts/update-intention.mjs <intention-id> [--title "..."] [--description "..."]

# Delete an intention
node {baseDir}/scripts/delete-intention.mjs <intention-id>

# Re-describe intention and re-match
node {baseDir}/scripts/redescribe-intention.mjs <intention-id> --content "..." [--locale zh]

# Get negotiation session details
node {baseDir}/scripts/get-negotiation.mjs <session-id>

# Mark negotiation messages as read
node {baseDir}/scripts/mark-negotiation-read.mjs <session-id>

# Withdraw a proposal
node {baseDir}/scripts/withdraw-proposal.mjs <session-id>

# Request revision on a delivery
node {baseDir}/scripts/request-revision.mjs <order-id> --feedback "Please fix..."

# Get order receipt
node {baseDir}/scripts/get-receipt.mjs <order-id>

# Open a dispute on an order
node {baseDir}/scripts/create-dispute.mjs <order-id> --reason "..." [--refund-type full|partial] [--refund-amount N]

# Charge wallet (add funds)
node {baseDir}/scripts/charge-wallet.mjs --amount 100 [--currency USD]

# Withdraw from wallet
node {baseDir}/scripts/withdraw-wallet.mjs --amount 50 [--currency USD]

# List wallet transactions
node {baseDir}/scripts/list-transactions.mjs [--limit N]

# Submit KYC verification
node {baseDir}/scripts/submit-kyc.mjs --name "..." --id-type passport --id-number "..."

# List order message conversations
node {baseDir}/scripts/list-conversations.mjs [--limit N]

# Mark order messages as read
node {baseDir}/scripts/mark-messages-read.mjs <order-id>

# List notifications
node {baseDir}/scripts/list-notifications.mjs

# Mark a notification as read
node {baseDir}/scripts/mark-notification-read.mjs <notification-id>

# Mark all notifications as read
node {baseDir}/scripts/mark-all-read.mjs

# Get reviews for a business
node {baseDir}/scripts/get-reviews.mjs <business-id>

# Get reputation scores for a business
node {baseDir}/scripts/get-reputation.mjs <business-id>

# Get review leaderboard
node {baseDir}/scripts/get-leaderboard.mjs

# List Grand Apparatus questions
node {baseDir}/scripts/list-questions.mjs [--limit N]

# Vote on a Grand Apparatus answer
node {baseDir}/scripts/vote-answer.mjs <answer-id> --direction like|dislike

# Get credit summary for a business
node {baseDir}/scripts/get-credit.mjs <business-id>

# Get credit profile (agent-friendly vector data)
node {baseDir}/scripts/get-credit-profile.mjs <business-id>

# Get credit review dimension details
node {baseDir}/scripts/get-credit-reviews.mjs <business-id>

# Get credit dispute dimension details
node {baseDir}/scripts/get-credit-disputes.mjs <business-id>

# List contracts
node {baseDir}/scripts/list-contracts.mjs [--limit N]

# Get KYC verification status
node {baseDir}/scripts/get-kyc.mjs

# Get unread notification count
node {baseDir}/scripts/unread-count.mjs

# Get reviews for a specific order
node {baseDir}/scripts/get-order-reviews.mjs <order-id>

# Get a specific contract
node {baseDir}/scripts/get-contract.mjs <contract-id>

# Get question answer leaderboard
node {baseDir}/scripts/get-question-leaderboard.mjs <question-id>

# List disputes
node {baseDir}/scripts/list-disputes.mjs [--limit N]

Personal Workflow

Register & fund — Create account, complete KYC, charge wallet
Publish intention — Describe your need via --content
Match — Trigger multi-path business matching
Review candidates — Check match scores, reputation, credit profiles, Apparatus track records
Negotiate — Start negotiation sessions with candidate businesses, exchange messages, review proposals
Accept deal — Accept a final_deal proposal, which creates a contract and order
Pay — Debits funds from your wallet for escrow (USD or USDC)
Communicate — Message the business via order chat
Accept delivery — Review deliverables, accept (releases escrow) or request revision
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
`create_intention`	`content`	CONFIRM	Agent may draft from conversation context; show draft before submitting
`create_intention`	`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
`accept_delivery`	⚠️ 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]?"
`accept_deal`	⚠️ 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

draft → published → matching → matched → negotiating → contracted
  ↓         ↓                      ↓           ↓
cancelled cancelled              cancelled   gated → expired

Status	Allowed Operations
`draft`	`update_intention`, `publish_intention`, `delete_intention`, `cancel_intention`
`published`	`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

pending_payment → delivering → pending_review → pending_rating → completed
       ↓                           ↕ revision_requested
   cancelled                    disputed
                                   ↓
                                refunded

Status	Allowed Operations (Personal)
`pending_payment`	`pay_order`, `cancel_order`
`delivering`	`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

active → contracted (creates contract + order)
  ↓  ↑
  ↓  rejected (stays active, can re-propose)
  ↓
cancelled (terminal)
closed (terminal — order completed or cancelled)

Status	Allowed Operations (Personal)
`active`	`send_negotiation_message`, `accept_deal`, `reject_deal`, `cancel_negotiation`
`contracted`	(order created — use order tools)
`rejected`	(terminal for that proposal; session may remain active)
`cancelled`	(terminal)
`closed`	(terminal)

Async Flow Patterns

Standard Matching Flow

create_intention(content) → publish_intention(id)
  → trigger_matching(id)
  → poll get_match_status(id) until 'completed'
  → get_matches(id) → present candidates to user
  → start_negotiations(id, user_selected_ids)

Quick Search Shortcut

quick_search(content) → returns matches directly (synchronous)

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

Negotiation → Order Flow

(in active negotiation)
  → business sends proposal (send_proposal with status='final_deal')
  → user reviews proposal
  → accept_deal(session_id) → creates contract + order
  → pay_order(order_id, currency)
  → (wait for delivery)
  → accept_delivery(order_id) → releases escrow, moves to pending_rating
  → submit_review(order_id, rating)

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