Commerce Intelligence: developer docs

Behavioral-science tools for online stores, for AI agents and their builders. From nothing to your first call in about a minute: 5 free calls, then €0.20 a call.

1. Get a key

Free, with 5 calls, one trial per email. The key is shown once; keep it.

Or from code:

curl -X POST https://phoslabs.io/api/trial \
  -H "Content-Type: application/json" \
  -d '{"email": "you@company.com"}'

The reply holds api_key, the free calls you have, and purchase_url, a credits link tied to that key.

2. Make a call

curl -X POST https://phoslabs.io/api/v1/diagnose \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"funnel_description": "Online shoe store: 1,000 visitors a day, 120 add to cart, 30 start checkout, 9 pay. Shipping cost shows only at the last step."}'

A real response to that call, on a key with credits (during your free calls charged_credits is 0; long text shortened):

{
  "success": true,
  "result": "# Conversion Funnel Diagnosis: Online Shoe Store\n\n**EVIDENCE GRADE: C (Hypothesis)** — This analysis is based on text-only, aggregate funnel counts with no s...",
  "charged_credits": 20,
  "credits_remaining": 20
}

Every REST tool takes a JSON body and the same header. The full spec is at /openapi.json and the list at /api/v1/tools.

POST https://phoslabs.ioRequired fields
/api/v1/auditproduct_description
/api/v1/diagnosefunnel_description
/api/v1/fix-checkoutcheckout_flow
/api/v1/copydraft, goal
/api/v1/pricingproduct
/api/v1/detect-biasestext

3. Use it from an MCP client

Server https://mcp.phoslabs.io/mcp (streamable HTTP). Send your key as a header:

{
  "mcpServers": {
    "commerce-intelligence": {
      "url": "https://mcp.phoslabs.io/mcp",
      "headers": {"Authorization": "Bearer YOUR_KEY"}
    }
  }
}

In Claude you can also add the URL as a connector and sign in with OAuth instead of a key; signing in starts its own 5 free calls. The server is in the official MCP Registry as io.phoslabs/commerce-intelligence.

4. Call it as an A2A agent

The agent card lists the skills. Send a task with the same key; the reply holds the result.

curl -X POST https://mcp.phoslabs.io/a2a/task \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"skill_id": "diagnose-dropoff", "input": {"funnel_description": "1,000 visitors a day, 9 pay; shipping shows at the last step"}}'

The input fields are the MCP tool's (see tools/list); the reply's output.result holds the answer. A2A calls are charged like MCP and REST calls.

skill_idRequired input fields
write-product-copydraft, goal
diagnose-dropofffunnel_description
find-hidden-barriersbehavior, population
fix-checkoutcurrent_flow
optimize-onboardingcurrent_flow
predict-churnuser_behavior
detect-biasestext
optimize-pricingproduct

5. Pay for more calls

After the free calls each call costs €0.20 (20 credits), the same for every tool, on REST, MCP and A2A. Packs: Starter €5 for 500 credits, Standard €20 for 2,000 credits, Pro €100 for 10,000 credits. Paste your key on the credits page and the pack you buy is added to that key; the key itself never leaves your browser. A call refused for lack of credits answers 402 with the same link in purchase_url.

Errors

Tools and pricing · llms.txt · Phos Labs · Privacy · Terms