Agent Capability Setup Guide

This document helps agents (especially Mark) become fully capable with WiderWings tools and services.

1. Second Brain Access

Your API key is in /home/henryk/clawd/.brain-keys:

source /home/henryk/clawd/.brain-keys
export BRAIN_API_KEY=$MARK_BRAIN_KEY

Search memories:

curl "https://brain.widerwings.com/api/memories?search=<query>" -H "Authorization: Bearer $BRAIN_API_KEY"

2. Supabase Access (via mcporter)

export SUPABASE_URL="https://bmwbwyptqiiqolgvbhsw.supabase.co"
export SUPABASE_ANON_KEY="sb_publishable_UowE7d6LP1kXgeKTez1bLA_hkF7AmVd"

Query YOUR tasks:

mcporter call supabase.postgrestRequest method=GET \
  path="/brain_tasks?agent_id=eq.mark&status=in.(todo,in_progress)&select=*&order=priority.asc" \
  --output json

Update task status:

mcporter call supabase.postgrestRequest method=PATCH \
  path="/brain_tasks?id=eq.<UUID>" \
  body='{"status":"done"}'

Save memory:

mcporter call supabase.postgrestRequest method=POST \
  path="/brain_memories" \
  body='{"title":"...","content":"...","project_id":"...","created_by":"mark"}'

3. mcporter (MCP Servers)

Path: /home/henryk/.nvm/versions/node/v24.13.0/bin/mcporter
Config: /home/henryk/clawd/config/mcporter.json

Available servers: supabase, github, notion

mcporter list                     # See all servers
mcporter describe github          # See GitHub tools
mcporter call github.list_issues owner=widerwings-inc repo=medschools_ai

4. gog CLI (Google Services)

Path: /usr/local/bin/gog
Account: widerwingsinc@gmail.com

gog gmail list --max 10           # Recent emails
gog gmail send --to x@y.com --subject "..." --body "..."
gog calendar list --days 7        # Upcoming events
gog drive list                    # Drive files
gog docs get <docId>              # Read Google Doc
gog sheets get <sheetId>          # Read Sheet

5. GitHub CLI (gh)

Path: /usr/bin/gh
Account: widerwingsinc

gh issue list -R widerwings-inc/medschools_ai
gh pr list -R widerwings-inc/medschools_ai
gh pr create -R widerwings-inc/medschools_ai --title "..." --body "..."
gh api repos/widerwings-inc/medschools_ai

6. Skills Directory

Path: /home/henryk/clawd/skills/

Key skills:

deep-research-pro - Multi-source web research with citations
seo-optimizer - SEO audits and fixes
seo-competitor-analysis - Competitive SEO analysis
frontend-design-ultimate - React/Tailwind UI builds
backend-patterns - API/DB best practices
postgres / postgres-pro - Database queries and optimization
gsc - Google Search Console data
reddit-insights - Reddit semantic search

Usage: Read the skill's SKILL.md file first, then follow its instructions.

7. Web Tools (OpenClaw native)

web_search - Brave Search API for web queries
web_fetch - Extract readable markdown from any URL

8. Project IDs (for tasks/memories)

Project	UUID
MedSchools.ai	`799d218b-8193-4124-93ea-1407ebe53cb4`
WiderWings	`ba876fd3-bc76-4670-a656-614a4853bd54`
Second Brain	`a6759fb1-708e-41ac-996a-d97b9f1246b1`
Operations	`699f56de-7ee7-4710-9029-47b592220cb9`

9. Heartbeat Protocol

On each heartbeat:

Poll brain_tasks for agent_id=mark with status in (todo, in_progress)
If P0/P1 task exists, work on it immediately
When done, update task status to done
Save deliverables to brain_memories with created_by=mark
Notify Henry on Telegram if the work is notable

10. Key Rules

ALWAYS save work to Second Brain - local files can be lost, brain persists
ALWAYS update task status - Bob checks your completed tasks
ALWAYS use project_id - tag memories/tasks with the right project
ALWAYS set created_by - use your agent name ("mark") for tracking

Questions? Create a task for Bob or ping Henry directly.

Agent Capability Setup Guide (For Mark)