Use this skill to understand the InboxMate product, its architecture, outreach pipeline, and how to query data across systems.
Architecture
InboxMate is a module (chatwidget) within the AgentHub platform — a full-stack Nuxt 3 + Supabase + Socket.IO SaaS.
Repos & Key Files
| Repo | Purpose | Key Files |
|---|---|---|
| agenthub | Full-stack app (InboxMate + AgentHub) | server/api/mcp.post.ts (demo MCP), app/pages/demo.vue (demo page), server/utils/scraping.ts (Tavily/Firecrawl), server/utils/subscriptionUtils.ts (tiers), app/components/InboxMatePricingModal.vue |
| notification-service | Email drafts, templates, funnel analytics | src/routes/drafts.ts (draft CRUD), src/routes/stats.ts + frontend/pages/funnel.vue (funnel) |
| psquared-websites | Marketing sites | apps/inboxmate/ (inboxmate.psquared.dev), apps/psquared/ (psquared.dev) |
| psquared-skills | Pipeline skills | skills/ directory |
URLs
| Service | URL |
|---|---|
| InboxMate app | app.psquared.dev (chatwidget module) |
| Demo pages | demo.inboxmate.psquared.dev/?id=<demoId> |
| Marketing site | inboxmate.psquared.dev |
| Company site | psquared.dev |
| Notification admin | notifications.psquared.dev/drafts |
| CRM | crm.psquared.dev |
| Analytics | ackee.psquared.dev |
Demo Pipeline
/find-leads [N] → CRM companies + people (German B2B, UWG-compliant)
↓
/inboxmate-batch-demo → Demos created, opportunities at SCREENING/PENDING_REVIEW
↓
/review-demos → demoStatus: OK_TO_SEND or NEEDS_FIX
↓
/fix-demos → Fixes applied, reset to PENDING_REVIEW
↓
/plan-campaign → CRM campaign created, opportunities linked with shared deadline
↓
/setup-email-drafts → Email drafts at notifications.psquared.dev/drafts
↓
Human review + send → demoStatus: SENT, outreachSentAt timestamped
↓
/check-outreach-status → Follow-up drafts created (5+ days after send)
↓
/check-demo-analytics → Pipeline health report (Ackee + CRM)
↓
/refurbish-demos → Upgrade knowledge for campaign demos (clear + re-scrape via MCP)
CRM State Machine (Twenty CRM)
Opportunity.demoStatus
| Status | Meaning |
|---|---|
PENDING_REVIEW |
Demo built, awaiting QA |
OK_TO_SEND |
QA passed, ready for outreach |
NEEDS_FIX |
QA failed, needs corrections |
SENT |
Initial outreach email sent |
FOLLOW_UP_SENT |
Follow-up email sent |
SKIP_FAULTY_WEBSITE |
Website unreachable/broken |
SKIP_IRRELEVANT |
Company not a fit |
SKIPPED |
Generic skip |
DISQUALIFIED |
Permanently excluded |
Opportunity.demoType
| Value | Meaning |
|---|---|
CHATBOT (or null = legacy) |
Personalized chatbot demo (/inboxmate-demo) |
INBOX |
Demo-Postfach: seeded pre-triaged inbox (/inboxmate-inbox-demo), email-product outreach. CRM view "InboxMate Email Outreach" filters on this. |
Opportunity.stage
| Stage | Meaning |
|---|---|
NEW |
Fresh lead, no outreach |
SCREENING |
Outreach phase |
MEETING |
Responded / call scheduled |
PROPOSAL |
Quoted or decision-maker demo |
CUSTOMER |
Paying customer |
Campaign Structure
Campaigns group opportunities into sendable batches with shared offerExpiresAt and offerText. Created by /plan-campaign, consumed by /setup-email-drafts.
How to Query Each System
CRM (Twenty) — GraphQL
- Endpoint:
https://crm.psquared.dev/graphql - Auth:
Authorization: Bearer $PSQUARED_CRM_TOKEN - Key objects:
companies,people,opportunities,campaigns,tasks,notes
Example — list opportunities in a campaign:
query {
opportunities(filter: { campaignId: { eq: "CAMPAIGN_ID" } }) {
edges { node { id name stage demoStatus demoUrl } }
}
}
Supabase (AgentHub DB)
- Project:
fevtfywriufbqnvbgyrm - Tool:
mcp__plugin_supabase_supabase__execute_sql - Key tables:
demo_pages,agents,knowledge,knowledge_bucket_items,knowledge_bucket_chunks,chats,messages,accounts
Example — find chats on demo agents:
SELECT dp.company_name, c.id as chat_id, c.created_at,
(SELECT count(*) FROM messages m WHERE m.chat_id = c.id) as msg_count
FROM demo_pages dp
JOIN chats c ON c.agent_id = dp.agent_id
ORDER BY c.created_at DESC
Ackee Analytics — GraphQL
- Endpoint:
https://ackee.psquared.dev/api - Auth:
Authorization: Bearer $ACKEE_TOKEN - Demo domain ID:
4bdddc8c-11d9-4d7e-ab94-aeb7866f0bb2 - CTA event ID:
0f037f1c-c2c0-4205-b90d-3cb9bf66f9c2
Example — get demo page views:
query {
domain(id: "4bdddc8c-11d9-4d7e-ab94-aeb7866f0bb2") {
statistics { views(interval: MONTHLY, type: UNIQUE) { count } }
facts { viewsMonth viewsToday activeVisitors }
}
}
Notification Service — REST
- Base URL:
https://notifications.psquared.dev - Auth (admin):
Authorization: Bearer $BEARER_TOKEN - Auth (drafts only):
Authorization: Bearer $EMAIL_DRAFT_ONLY_BEARER
Key endpoints:
GET /drafts?status=SENT&pageSize=50— list sent emailsGET /drafts/:id— read full email (html_body, variables, subject)POST /drafts/create— create draft from templatePOST /drafts/send— send drafts{ draftIds: [...] }GET /stats/funnel— full conversion funnel dataGET /drafts/campaigns— list CRM campaigns with draft counts
InboxMate MCP — JSON-RPC
- Endpoint:
https://app.psquared.dev/api/mcp - Auth:
Authorization: Bearer $NUXT_MCP_DEMO_TOKEN - Protocol: JSON-RPC 2.0
Key tools:
clear_bucket— remove all items from a knowledge bucketscrape_and_build_knowledge— scrape URLs via Tavily, create knowledge items with real sourceUrlscreate_agent,update_prompt,update_widget_style,publish_agentcreate_knowledge_bucket,add_to_bucket,set_knowledgecreate_demo_page,update_demo_page,list_demos,get_democreate_inbox_demo,update_inbox_demo— Demo-Postfach (type='inbox': seeded pre-triaged inbox, no agent)list_bucket_items,list_knowledge,get_knowledge
Key Metrics
| Metric | Source | How to check |
|---|---|---|
| Demo page views | Ackee | Query demo domain statistics |
| CTA clicks | Ackee | Query CTA event |
| Emails sent | Notification service | GET /drafts?status=SENT |
| Chat interactions | Supabase | chats JOIN demo_pages on agent_id |
| Pipeline funnel | Notification service | GET /stats/funnel |
| Hot leads | CRM | Opportunities with stage > SCREENING |
| Campaign status | CRM + Notification service | Campaigns + draft counts per campaign |
Environment Variables
All in /Users/martinpammesberger/Documents/psquared/claude-overlord-folder/.env:
| Variable | Service |
|---|---|
PSQUARED_CRM_TOKEN |
Twenty CRM GraphQL |
NUXT_MCP_DEMO_TOKEN |
InboxMate MCP endpoint |
NUXT_TAVILY_SEARCH_API_KEY |
Tavily web scraping |
EMAIL_DRAFT_ONLY_BEARER |
Notification service (draft creation) |
NOTIFICATIONS_SERVICE_BEARER_TOKEN |
Notification service (admin) |
ACKEE_TOKEN |
Ackee analytics |
Pricing Tiers (credits model, since 2026-09)
Note: If prices change, this table must be updated. The /price-change skill handles pricing updates across all touchpoints — make sure this file is included in the update list.
Model: pay per Postfach (mailbox) + AI credits + one-time setup. All prices net (zzgl. USt.). Manual invoicing, bank transfer. Stripe is NOT used for InboxMate billing (do not create Stripe prices). 14-day Pro trial, no credit card; at trial end the account is downgraded to Free (data kept).
| Tier | Price | Postfächer | Credits/mo | Users | Agents | Notes |
|---|---|---|---|---|---|---|
| Free | €0 | 0 | 50 | 1 | 1 | where accounts land after the trial; not marketed (website shows no chatbot since 2026-09-24) |
| Pro | €129/mo · €107/mo yearly | 1 (extra €49/mo) | 2,500 | 5 | 5 | entry paid plan; API+MCP, auto-send, triage, advanced analytics |
| Business | €389/mo · €349/mo yearly | 5 (extra €39/mo) | 15,000 | 10 | unlimited | SLA tickets, time tracking, advanced export, priority support |
| Enterprise | individuell / auf Anfrage (never show a price) | more than 5 | individual | — | — | custom integrations built by psquared, SLA, named contact, training. SaaS only — never offer Exoscale/self-hosting or a framework contract. |
- Starter is removed from all displays. The code tier key
im_starterstays in agenthub (schemas, Shopify) — hide only. - Setup (Einrichtung), Pro and Business: Standard €890 one-time (1 Postfach, up to 10 rules, Microsoft 365 / IMAP, test run, 2 adjustments; each extra mailbox + €290). Individuell: fixed price after first call (webhooks, integrations, complex rules). Enterprise: individual. Display + AGB only, not in code.
- Top-ups: €40 per 1,000 credits, €175 per 5,000 (
shared/constants/credits.ts), instant grant, invoiced afterwards. - Credit costs (
agenthub/server/utils/creditLedger.ts): categorize (one run) 2, chat reply 1, email draft 1, email send 1, webhook 0.5, PDF/OCR 1, scrape 5, tool call 0, test chat 0. Grace buffer 20% (×1.2). - Grandfathered: Doppler Holding €100/mo for 3 mailboxes. Do not mention publicly.
Knowledge System
Agents use RAG (vector search) over knowledge buckets:
- Each bucket contains knowledge items (text entries with
sourceUrl) - Items are chunked and embedded for vector similarity search
- When the agent's
searchKnowledgetool is called, it returns matching chunks WITH theirsourceUrl - The widget UI shows sources as clickable links in citations
To upgrade knowledge quality: clear_bucket → scrape_and_build_knowledge with real page URLs → publish_agent