AI Psychologist — Human-in-the-Loop Consultation

Connect to a real human psychologist at https://ai-psychologist-api.replit.app. This is NOT a chatbot. A real person reads and responds to every message.

API docs: https://ai-psychologist-api.replit.app/docs

Key Facts

• Languages: English and Spanish
• Response time: 5 minutes to 10 hours (real human, UTC-3 timezone)
• Max 300 words per message
• Rate limit: 5 messages per minute per session
• First message: FREE. After that: $0.50 USDC on Base mainnet

Complete Workflow

Step 1 — Create a session

Use WebFetch to POST to https://ai-psychologist-api.replit.app/start_session (no body needed).

Expected response:

{"session_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "message": "Session created. First message is free..."}

Save the session_id. You need it for all subsequent calls.

Step 2 — Send your FIRST message (FREE)

Use the user's argument ($ARGUMENTS) or ask them what they'd like to say. Max 300 words.

Use WebFetch to POST to https://ai-psychologist-api.replit.app/send_message?session_id=SESSION_ID with header Content-Type: application/json and body:

{"content": "YOUR MESSAGE HERE"}

Expected response (HTTP 200):

{"status": "delivered", "message_id": 1, "note": "Human response may take 5 min to 10 hours. Poll /get_response to retrieve it."}

Step 3 — Tell the user what happened

After sending, inform the user:

1. Their message was delivered to a real human psychologist
2. Give them the session_id so they can check for responses later
3. Response time is 5 minutes to 10 hours — this is normal
4. They can check for replies by invoking this skill again with: check SESSION_ID

Step 4 — Poll for the human's reply

Use WebFetch to GET https://ai-psychologist-api.replit.app/get_response?session_id=SESSION_ID

Response when no reply yet:

{"session_id": "...", "responses": [], "note": "Human response may take 5 min to 10 hours. Poll every 30-60s."}

Response when reply is available:

{"session_id": "...", "responses": [{"message_id": 2, "content": "The psychologist's reply text", "timestamp": 1234567890.0}], "note": "Responses retrieved."}

If responses is empty, tell the user: "No reply yet. The psychologist is a real human and may take up to 10 hours. Try again later."

Step 5 — Send follow-up messages (REQUIRES PAYMENT)

After the first free message, every message costs $0.50 USDC on Base mainnet.

When you send a message without payment, the API returns HTTP 402 with the wallet address and payment instructions. Follow those instructions:

1. Transfer the requested USDC amount to the wallet shown in the 402 response
2. Get the transaction hash (0x...)
3. Include it in the request body as x402_payment