# Connect an agent to RealtorTasksAI pay-per-use skills

There are two main steps: find an appropriate skill for free, then purchase its
instructions for one local execution. This connector provides those steps as
tools in an MCP-compatible agent application. It does not perform the task or
return a completed work result. Another execution needs another purchase.

## Install the local connector

This download contains the buyer connector only: no wallet, private key,
spending permission, purchased skill instructions or customer documents.
The inspectable Python source is inside the wheel archive.

Create a dedicated Python 3.11-or-newer environment and install the pinned download:

```sh
python3 -m venv realtor-agent-connection
realtor-agent-connection/bin/python -m pip install "https://tasksai-agent-commerce-live-10437713249.us-central1.run.app/downloads/realtortasksai_connector-0.1.0-py3-none-any.whl#sha256=cb268564c96295642039678c9f7370e520c64b1bac4a8317c2f58a5ae0c8331e"
```

On Windows the environment's Python and executable are in Scripts rather than
bin. Installation downloads the declared MCP, HTTP and signing dependencies
from the Python package index.

## Connect to the agent application

Add this server to the application's local MCP configuration. Replace the
executable path with the absolute path on the buyer's own computer:

```json
{
  "mcpServers": {
    "realtortasksai-pay-per-use": {
      "command": "/absolute/path/realtor-agent-connection/bin/realtortasksai-connector",
      "args": []
    }
  }
}
```

The default connection permits free discovery only. It does not select a wallet,
sign payments, or spend. Applications differ in how they install local MCP
servers; this download is not a remote HTTP MCP server URL.

## Available tools

- search_skills: free general-task search; do not send client details.
- inspect_skill: free local requirements, output format, limitations and license.
- quote_skill: free exact price and quote ID. The current quote controls pricing.
- purchase_skill: buy the quote within the owner's configured spending permission.
  Repeating the same quote retries the original purchase.
- recover_skill_use: recover/resume the original execution without a new payment.
- complete_skill_use: mark the completed execution used. Recovery does not return
  its instructions for a new task.
- purchase_status: inspect local pending/used records and budget reservations.

Full skill instructions remain behind payment. The connector returns purchased
instructions to the buyer's agent; that agent performs the work using authorized
local records. The API does not return a finished work result.

## Enable spending only under the wallet owner's authority

The buyer supplies an isolated Base wallet containing native USDC and a private
owner-controlled policy file. Neither belongs in a prompt, MCP configuration,
public repository or support message. Never use the seller's receiving wallet
as a buyer wallet.

The wallet file contains a private_key field. The separate policy file has this
shape. This example is deliberately disabled and expired:

```json
{
  "enabled": false,
  "origin": "https://tasksai-agent-commerce-live-10437713249.us-central1.run.app",
  "wallet_file": "/absolute/private/path/buyer-wallet.json",
  "max_per_purchase_usdc": "0.05",
  "max_total_usdc": "1.00",
  "expires_at": 0,
  "allowed_skill_ids": ["realtor_compare_seller_offers_and_net_proceeds"]
}
```

The owner chooses limits, permitted skills and a future Unix expiry, then enables
the policy. Restrict both files to their owner (0600 on macOS/Linux). Add
--policy-file and the absolute policy-file path to the server's args. Agent tools
cannot change this policy. The owner remains responsible for controlling the
agent application's broader file access.

Budget reservations persist in the private local purchase ledger. Every signed
proof counts, including uncertain or rejected payments; reservations are never
silently released. The total limit is a lifetime limit for that ledger, not a
daily allowance. Back up the ledger: deleting it discards recovery evidence and
budget history. Choose a private location with --state-dir if needed. On Windows,
restrict access to the owner with the platform's file permissions.

After an uncertain payment, recover the original local use ID. Never authorize
another proof merely because the first response was lost. Recovery does not reset
a completed use. The service cannot observe actual local task completion or make
delivered text impossible to copy; single-use terms and the cooperating buyer's
local execution record govern reuse.

The connector contacts only the published TasksAI service. It never uploads client
documents, work results, wallet keys or its local ledger. Paid calls send the
authorized proof and random use ID. Search receives only a general task description.
Your agent application's handling of received instructions remains subject to its
owner's settings.

## Links

- [Live catalog](https://tasksai-agent-commerce-live-10437713249.us-central1.run.app/)
- [Agent guide](https://tasksai-agent-commerce-live-10437713249.us-central1.run.app/agent-guide)
- [Product overview](https://realtortasksai.com/pay-per-use.md)
- [Agent discovery index](https://tasksai-agent-commerce-live-10437713249.us-central1.run.app/llms.txt)