Frequently Asked Questions

What is ProxAI Logistics?

ProxAI Logistics is a physical task execution service based in Terrebonne, Quebec. We provide the physical layer for AI agents through a human-in-the-loop process — handling things like site inspections, IT equipment status checks, marketplace pickups, and auction representation.

How is this different from a courier or handyman service?

We are purpose-built for AI integration. Our service is designed to be called by autonomous agents through structured task submissions, with machine-readable specs (llms.txt), standardized reporting, and a human-in-the-loop review process. We speak both “AI protocol” and “real world.”

Can regular businesses (not AI agents) use your services?

Yes. While our platform is optimized for AI agent integration, any business or individual can submit tasks through our task submission form. The same professional service and reporting standards apply.

How much does a task cost?

Our standard rate is: $50 base fee + $100/hour (on-site time) + $100/hour (transport time) + $0.90/km (round-trip from Terrebonne) + TPS/TVQ. For example, a 30-minute visual audit in Laval (50 km round-trip) costs approximately $195 CAD before tax. Use GET /api/estimate for a precise quote with full tax breakdown before submitting.

How do I pay?

Payment is in USDC stablecoin (pegged 1:1 to USD) on either the Solana or Base (Ethereum L2) network. After your task is approved, you receive exact USDC payment instructions by email and via the API. Each task gets a unique USDC amount (down to the cent) to enable automatic blockchain matching.

For AI agents: the API response includes a _payment block with per-network memo instructions. It is strongly recommended to include the task_id as a memo in your transaction (Solana MemoProgram or Base data field). A transaction with a mismatched memo is ignored; one with no memo is accepted on amount alone.

Why USDC instead of credit card?

USDC enables fully autonomous payment by AI agents — no human intervention needed. Transactions are confirmed on-chain within minutes, settlement is instant, and there are no chargebacks or currency conversion fees. The CAD-to-USDC conversion uses real-time exchange rates at the time of approval.

How long do I have to pay?

You have 48 hours from the time of approval to send payment. If the payment window expires, the task status moves to payment_expired and you’ll need to resubmit. Payment is detected automatically on the blockchain within approximately 2 minutes.

What is the counter-offer protocol?

After reviewing your task, our operator may issue a revised estimate if the scope is more complex than described, requires specialized equipment, or if conditions (traffic, weather) affect the timeline. You’ll receive the revised quote by email with updated USDC payment instructions. Send the USDC to accept, or reply to negotiate.

Is the base fee charged per task or per day?

The $50 base fee is charged per task dispatch. If you submit three separate tasks, each will have its own base fee. Multi-site tasks submitted as a single dispatch may be consolidated — contact us to discuss.

Can I get a refund?

If a task is cancelled after payment has been received, a full USDC refund is issued to your original wallet address. You’ll receive a confirmation email with the refund transaction hash. Refunds are processed within 24 hours.

Are taxes included in the price?

Yes. All task costs include Quebec taxes: TPS (5%) and TVQ (9.975%), for a combined rate of 14.975%. The estimate endpoint (/api/estimate) returns a full breakdown showing the subtotal before tax (HT), TPS, TVQ, and total including tax (TTC). Confirmation emails and invoices itemize the tax amounts separately.

Can I open a prepaid client account?

Yes! We encourage all regular clients — whether human or AI agent — to create a client account. Registration is free and takes less than a minute. After signing up, you’ll receive a verification email to activate your account. Our team will then contact you to arrange your initial deposit and get you started.

How does the prepaid balance work?

A minimum deposit of $500 CAD is required to activate your account. This deposit becomes your opening balance. When you submit tasks, the cost (including TPS/TVQ) is automatically deducted from your balance at the time of approval — no need to pay in USDC for each task individually. You’ll receive an invoice for every transaction, and you can track your balance, tasks, and invoices directly from your account dashboard.

What happens after I register?

Here’s the process: 1. Create your account at /account. 2. Verify your email via the link we send you. 3. Our admin team contacts you with payment instructions for the $500 CAD minimum deposit. 4. Once the deposit is received, your account is activated and you can start submitting tasks immediately. Top-ups can be arranged at any time by contacting us.

Can AI agents use a client account?

Absolutely. AI agents can register via the API (POST /api/client-account with an API key) or through the web form. Once the account is funded, the agent can submit tasks and have costs deducted from the prepaid balance automatically — fully autonomous, no per-task USDC payment needed.

How do I submit a task?

AI agents: Register a free API key via POST /api/api-keys, then send a POST /api/submit-task with a JSON body including service_type, location_address, task_description, and requester_contact. See the OpenAPI spec for the full schema.
Humans: Use our online form. Fill in the service type, location (auto-completed via Google Maps), task description, and your email. No API key needed for the form — Cloudflare Turnstile protects it instead.

What is the task lifecycle?

Every task follows this flow:
1. received → Task submitted, awaiting human review.
2. accepted_pending_payment → Approved, USDC payment instructions sent.
3. paid_ready → Payment confirmed on blockchain, execution scheduled.
4. in_progress → Operator dispatched, en route or on site.
5. completed → Proof photos and report delivered via email, API, and webhook.
A task may also be rejected, receive a counter-offer, or reach payment_expired (48h window).

How fast will my task be completed?

Standard tasks: Reviewed within 24 hours, executed within 72 hours after payment.
Urgent tasks: Reviewed within 12 hours, executed within 24 hours (+25% surcharge, subject to availability).

How do I track my task?

Two options:
Polling: Call GET /api/submit-task?task_id=X periodically. The response includes a _polling object that tells you exactly when to check back and what action is needed.
Webhook (recommended): Provide a callback_url when submitting your task. ProxAI will POST a notification to your URL the instant the task is completed — no polling needed.

What deliverables do I receive?

Every completed task includes timestamped proof photos (JPEG), operator notes, and a cost breakdown. Deliverables are delivered through three channels simultaneously:
1. Email — Photos attached to the email sent to your requester_contact.
2. API — proof_files_data (base64) in the GET response when status = completed.
3. Webhook — Full payload POSTed to your callback_url if provided at submission.

Can I request a specific output format?

Yes. Set the preferred_output field to photos, PDF, JSON, CSV, or video when submitting. The operator will deliver in your preferred format when possible.

Can I cancel a task?

Contact to request cancellation. If payment has already been received, a full USDC refund will be issued to your original wallet. Tasks already in progress may be partially completed before cancellation takes effect.

Where do you operate?

We cover Greater Montreal, Laval, the Laurentides (Blainville up to Mont-Tremblant), and Lanaudière (Mascouche, Repentigny, Joliette). Our hub is in Terrebonne, QC. See full coverage details →

What can you NOT do?

We do not perform licensed trades (plumbing, electrical, legal advice), medical tasks, emergency services, or anything illegal. Tasks outside Quebec will be declined.

What are your operating hours?

We are operational Monday through Saturday. Contact us to discuss scheduling.

What happens if weather delays my task?

Extreme weather may delay field execution. You will be notified promptly, and the task will be rescheduled at the earliest safe opportunity at no additional charge.

How can my AI agent use ProxAI?

The full autonomous protocol is: 1. Register an API key (POST /api/api-keys). 2. Discover services (GET /api/services). 3. Get a cost estimate (GET /api/estimate). 4. Submit a task (POST /api/submit-task). 5. Pay in USDC on-chain. 6. Receive proof photos via webhook or API. 7. Rate the task (POST /api/task-score). No human interaction needed on the client side. Compatible with LangChain, OpenAI Function Calling, AutoGPT, CrewAI, and MCP frameworks.

Do I need an API key?

Yes, for write operations (submitting tasks, scoring). Registration is free and instant — POST /api/api-keys with your agent name and contact email. You get a prox_... key immediately. Read operations (checking status, listing services, getting estimates) are public and don’t require a key.

What endpoints are available?

POST /api/api-keys — Register API key (no auth)
GET /api/services — Service catalog (no auth)
GET /api/estimate — Cost calculator (no auth)
POST /api/submit-task — Submit a task (API key required)
GET /api/submit-task?task_id=X — Check status + get deliverables (no auth)
POST /api/task-score — Rate a completed task (API key required)
GET /api/task-score — Aggregate reputation stats (no auth)
Full OpenAPI 3.1 specification available for auto-generating tool definitions.

Should my agent poll or use a webhook?

Webhook is recommended. Provide a callback_url at task submission and ProxAI will POST a notification the moment the task is completed. If polling, the API returns a _polling object with next_poll_seconds and is_terminal fields, plus a standard Retry-After HTTP header. Always stop polling when is_terminal is true.

Can my agent rate completed tasks?

Yes. Send POST /api/task-score with a 1–5 rating, outcome (completed, partial, failed, cancelled), and optional feedback. One score per task. Aggregate reputation stats are publicly available at GET /api/task-score.

What are the agent discovery files?

llms.txt — Compact spec for LLM consumption.
llms-full.txt — Complete documentation with all endpoints and examples.
openapi.json — OpenAPI 3.1 spec for auto-generating tools.
ai-plugin.json — ChatGPT-compatible plugin manifest.
agent.json — Agent capabilities and interfaces.