wellread

Wellread

Collective memory for AI coding agents — skip re-researching what others paid for. Backend: MCP Streamable HTTP (JSON-RPC + session-id header), not REST.

Usage

• Use for: before WebSearch/WebFetch on a library/API/framework question; after deep web research (save); checking whether prior notes are still fresh.
• Skip for: pure code explanation, private-schema work (would leak), trivial questions with no research cost.

Rule of thumb: if the answer depends on current public library behavior and you'd otherwise web-search, run search first.

Credentials check

[ -n "$WELLREAD_API_KEY" ] && echo "WELLREAD_API_KEY: PRESENT" || echo "WELLREAD_API_KEY: MISSING"

Never echo the variable directly.

If MISSING, respond to the user with EXACTLY this message (do NOT paraphrase, do NOT suggest manual JSON edits):

I need a wellread credential. Run this in another terminal — teleport will register you in one call and save the key:

teleport-setup add-key wellread

No signup page, no email — it's anonymous and instant. Then restart Claude Code (/exit, then claude) and ask me again.

Do NOT suggest editing ~/.claude/settings.local.json manually. teleport-setup add-key wellread auto-registers the user and saves the key. Stop execution until the user has run the command and restarted.

API

• Endpoint: https://wellread-production.up.railway.app/mcp
• Transport: MCP Streamable HTTP (JSON-RPC over HTTP with session-id header)
• Auth: Authorization: Bearer $WELLREAD_API_KEY
• Required headers on every call:
  • Content-Type: application/json
  • Accept: application/json, text/event-stream
  • Mcp-Session-Id: <uuid> (after initialize — see below)

Responses are SSE-style: lines prefixed with event: and data:. The actual JSON is the data: line.

Session handshake (once per invocation)

# 1) Initialize, capture Mcp-Session-Id from response headers.
INIT_RESP=$(curl -sSi -X POST "https://wellread-production.up.railway.app/mcp" \
  -H "Authorization: Bearer $WELLREAD_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"teleport-skill","version":"0.1"}}}')

SID=$(echo "$INIT_RESP" | awk 'BEGIN{IGNORECASE=1} /^mcp-session-id:/ {print $2}' | tr -d '\r')
# Verify SID is a UUID; bail if empty.

# 2) Send 'initialized' notification (no id, no response expected).
curl -sS -X POST "https://wellread-production.up.railway.app/mcp" \
  -H "Authorization: Bearer $WELLREAD_API_KEY" \
  -H "Mcp-Session-Id: $SID" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'