Ship Mate
Back to Home

Ship Mate Documentation

Automated AI beta testing, QA, and ecosystem integration for your SaaS applications.

How Ship Mate Works

Ship Mate acts as your team's autonomous beta tester. Register your SaaS application (like taskflowapp.xyz), provide test credentials, and our AI agents will visually navigate the DOM, click buttons, fill forms, and discover bugs exactly like human users would.

The 24-Hour Testing Cycle

Every 24 hours, our asynchronous cron workers automatically wake up and test your active projects. We deduct 1 Testing Credit per workflow. To protect limits, projects are automatically paused if you haven't logged in within the last 30 days. No runaways, no surprise bills.

Plans & Personas

Free TierActive

  • • 1 Project limit
  • • 30 Testing Credits / month
  • • Full API Access

Runs the Typical User persona nightly, ensuring your app's core paths are stable.

Pro Tier$10 / mo

  • • 5 Projects limit
  • • 150 Testing Credits / month
  • • Full API Access

Every 24 hours, it randomly cycles through the Bug Hunter, UX Critic, Accessibility Expert, or Typical User to catch extreme edge cases.

Ecosystem Polling API (Headless Syncing)

Ship Mate isn't just a dashboard—it's a headless QA engine designed to send context into orchestrators like SpecStack or IDE coding agents like Copilot.

GET/api/v1/projects/[id]/interactions?since=[date]

Authenticates via Bearer Token (Ship Mate API Key). Pulls all AI insights and artifacts generated since your last poll, bundled with a fresh markdown summary.

{
  "sender": "Ship Mate: The QA Persona",
  "summary": "# Workflow Complete\\nI tested the authentication flow and found that...",
  "entities": [
    {
      "kind": "insight",
      "domain": "engineering",
      "format": "markdown",
      "title": "Missing Loading State on Login",
      "content": "Severity: Medium\\n\\nSteps to reproduce..."
    }
  ]
}

Event-Driven Runs API

Instead of waiting for the daily cron runs, you can trigger Ship Mate testing dynamically from your CI/CD pipeline (e.g., GitHub Actions) as soon as you deploy to staging.

POST/api/v1/runs

Authenticates via Bearer Token. Triggers a new asynchronous workflow.

// Example Payload
{
  "projectId": "proj_123xyz...",
  "persona": "QA Tester" // optional
}

// Response
{
  "success": true,
  "workflowId": "miss_456abc...",
  "status": "pending"
}

Feed API

Query a timeline of the most recent insights, metrics, and actions taken by the AI agent on a specific project. Perfect for syncing updates to other AI orchestrators or dashboards.

GET/api/v1/projects/[id]/feed

Authenticates via Bearer Token. Returns the last 50 universal entity nodes associated with the project.

{
  "success": true,
  "data": [
    {
      "id": "ent_abc123",
      "kind": "insight",
      "title": "Authentication Flow Tested",
      "content": "Successfully interacted with login forms...",
      "createdAt": "2026-05-25T12:00:00.000Z"
    }
  ]
}

Model Context Protocol (MCP) Server

Ship Mate provides a native Model Context Protocol (MCP) server, allowing external AI coding assistants (like Cline, Cursor, or Sidekick42) to securely control Ship Mate natively from your IDE.

Add the following configuration to your MCP-compatible client to integrate Ship Mate's toolset autonomously.

{
  "mcpServers": {
    "makerminion-qa": {
      "url": "https://makerminionagent.com/api/mcp",
      "env": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

Available MCP Tools:

get_daily_brief - Fetches synthesized markdown of the day's test insights.

Additional REST API Endpoints

Alongside the main endpoints, Ship Mate exposes standard read access to core elements for custom dashboard integrations. Provide your token via Bearer Authorization header.

EndpointMethodDescription
/api/v1/projectsGETList all projects owned by the authenticated user.
/api/v1/projects/[id]/insightsGETGet categorized tracking items (Bugs, Recommendations).
/api/v1/projects/[id]/tasksGETGet the actionable To-Do task checklist generated by AI.
/api/v1/projects/[id]/chatPOSTChat programmatically with the project context.

The Universal Node Schema

All data generated by Ship Mate (findings, bug reports, visual specs) is saved using the Universal Node Schema. Because Ship Mate and tools like SpecStack speak the exact same underlying language (`kind: "insight"`, `format: "markdown"`), you never need heavy integration adapters. QA automation feeds naturally into your backlog context.