mpx-api 1.2.2 → 1.2.3

package/README.md

@@ -4,18 +4,23 @@
 
 No GUI. No proprietary formats. Just powerful, git-friendly API testing from your terminal.
 
+Part of the [Mesaplex](https://mesaplex.com) developer toolchain.
+
 [![npm version](https://img.shields.io/npm/v/mpx-api.svg)](https://www.npmjs.com/package/mpx-api)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![License: Dual](https://img.shields.io/badge/license-Dual-blue.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org)
 
-## Why mpx-api?
+## Features
 
-- **Git-friendly**: Collections are YAML files, not proprietary blobs
-- **CI/CD ready**: Exit codes, JSON output, no GUI dependency
-- **Developer experience**: Beautiful terminal output, syntax highlighting
-- **Request chaining**: Use response from one request in another (`{{request.response.body.id}}`)
-- **Built-in mock server**: Test against OpenAPI specs without deploying
-- **Assertions in collections**: No separate test code needed
-- **Fast**: Pure Node.js, minimal dependencies, < 200ms startup
+- **Git-friendly** — Collections are YAML files, not proprietary blobs
+- **CI/CD ready** — Exit codes, JSON output, no GUI dependency
+- **Beautiful terminal output** with syntax highlighting
+- **Request chaining** — Use response data from one request in another
+- **Built-in mock server** — Test against OpenAPI specs without deploying (Pro)
+- **Load testing** — RPS control, percentile reporting (Pro)
+- **Doc generation** — Generate API docs from collections (Pro)
+- **MCP server** — Integrates with any MCP-compatible AI agent
+- **Self-documenting** — `--schema` returns machine-readable tool description
 
 ## Installation
 
@@ -23,27 +28,26 @@ No GUI. No proprietary formats. Just powerful, git-friendly API testing from you
 npm install -g mpx-api
 ```
 
-Or use with `npx`:
+Or run directly with npx:
 
 ```bash
 npx mpx-api get https://api.github.com/users/octocat
 ```
 
-## Quick Start
+**Requirements:** Node.js 18+ · No native dependencies · macOS, Linux, Windows
 
-### Make HTTP Requests
+## Quick Start
 
 ```bash
 # Simple GET request
 mpx-api get https://jsonplaceholder.typicode.com/users
 
 # POST with JSON
-mpx-api post https://api.example.com/users --json '{"name":"Alice","email":"alice@example.com"}'
+mpx-api post https://api.example.com/users --json '{"name":"Alice"}'
 
 # Custom headers
 mpx-api get https://api.example.com/protected \
-  -H "Authorization: Bearer $TOKEN" \
-  -H "Accept: application/json"
+  -H "Authorization: Bearer $TOKEN"
 
 # Verbose output (show headers)
 mpx-api get https://httpbin.org/get -v
@@ -52,7 +56,22 @@ mpx-api get https://httpbin.org/get -v
 mpx-api get https://api.example.com/data -q
 ```
 
-### Create a Collection
+## Usage
+
+### HTTP Requests
+
+Supports `get`, `post`, `put`, `patch`, `delete`, `head`, and `options`:
+
+```bash
+mpx-api get https://api.example.com/users
+mpx-api post https://api.example.com/users --json '{"name":"Bob"}'
+mpx-api put https://api.example.com/users/1 --json '{"name":"Alice"}'
+mpx-api delete https://api.example.com/users/1
+```
+
+### Collections
+
+Collections are YAML files for repeatable API test suites:
 
 ```bash
 # Initialize collection in your project
@@ -66,9 +85,7 @@ mpx-api collection add create-user POST /users --json '{"name":"Bob"}'
 mpx-api collection run
 ```
 
-### Collection File Format
-
-Collections are simple YAML files (`.mpx-api/collection.yaml`):
+Collection file format (`.mpx-api/collection.yaml`):
 
 ```yaml
 name: My API Tests
@@ -90,111 +107,68 @@ requests:
     url: /users/{{get-users.response.body[0].id}}
     assert:
       status: 200
-      body.email: { exists: true }
-
-  - name: create-post
-    method: POST
-    url: /posts
-    json:
-      title: New Post
-      userId: {{get-users.response.body[0].id}}
-    assert:
-      status: 201
-      body.title: New Post
 ```
 
-**Key features:**
-
-- **Request chaining**: `{{get-users.response.body[0].id}}` uses the response from a previous request
-- **Environment variables**: `{{env.API_TOKEN}}` pulls from environment files
-- **Assertions**: Test status codes, response times, body fields, headers
-- **Operators**: `gt`, `lt`, `gte`, `lte`, `eq`, `ne`, `contains`, `exists`
+Features: request chaining (`{{request.response.body.id}}`), environment variables (`{{env.VAR}}`), built-in assertions.
 
 ### Environments
 
 ```bash
-# Initialize environments (creates dev, staging, production)
-mpx-api env init
-
-# Set variables
-mpx-api env set staging API_URL=https://staging.example.com
-mpx-api env set staging API_TOKEN=abc123
-
-# List environments
-mpx-api env list
-
-# List variables in environment
-mpx-api env list staging
-
-# Run collection with environment
-mpx-api collection run --env staging
-```
-
-Environment files (`.mpx-api/environments/staging.yaml`):
-
-```yaml
-name: staging
-variables:
-  API_URL: https://staging.example.com
-  API_TOKEN: secret-token-here
+mpx-api env init                              # Create dev, staging, production
+mpx-api env set staging API_URL=https://...   # Set variables
+mpx-api env list                              # List environments
+mpx-api collection run --env staging          # Run with environment
 ```
 
 ### Testing & Assertions
 
 ```bash
-# Run tests from collection
 mpx-api test ./collection.yaml
-
-# With environment
 mpx-api test ./collection.yaml --env production
-
-# JSON output for CI/CD
 mpx-api test ./collection.yaml --json
+mpx-api test ./collection.yaml --pdf report.pdf    # Export PDF report
 ```
 
-Assertions support:
-
-- **Status codes**: `status: 200`
-- **Response time**: `responseTime: { lt: 500 }`
-- **Headers**: `headers.content-type: application/json`
-- **Body fields**: `body.users[0].name: Alice`
-- **Operators**:
-  - `{ gt: 10 }` - greater than
-  - `{ lt: 100 }` - less than
-  - `{ gte: 5 }` - greater than or equal
-  - `{ lte: 50 }` - less than or equal
-  - `{ eq: "value" }` - equals
-  - `{ ne: "value" }` - not equals
-  - `{ contains: "text" }` - contains substring
-  - `{ exists: true }` - field exists
+Assertion operators: `gt`, `lt`, `gte`, `lte`, `eq`, `ne`, `contains`, `exists`
 
 ### Request History
 
 ```bash
-# View recent requests
-mpx-api history
+mpx-api history         # View recent requests
+mpx-api history -n 50   # Last 50
+```
 
-# Limit to last 50
-mpx-api history -n 50
+### Mock Server (Pro)
+
+```bash
+mpx-api mock ./openapi.yaml --port 4000
 ```
 
-### Cookie Management
+### Load Testing (Pro)
 
-Cookies are automatically saved and sent with subsequent requests. Cookie jar is stored at `~/.mpx-api/cookies.json`.
+```bash
+mpx-api load https://api.example.com/health --rps 100 --duration 30s
+```
 
-## AI Agent Usage 🤖
+### Documentation Generation (Pro)
 
-**mpx-api is AI-native!** Every command supports structured JSON output, schema discovery, and MCP (Model Context Protocol) integration for seamless AI agent automation.
+```bash
+mpx-api docs ./collection.yaml --output API.md
+```
+
+## AI Agent Usage
+
+mpx-api is designed to be used by AI agents as well as humans.
 
 ### JSON Output
 
-Add `--json` to any command for machine-readable output:
+Add `--json` to any command for structured, machine-readable output:
 
 ```bash
-# HTTP request with JSON output
 mpx-api get https://api.github.com/users/octocat --json
+```
 
-# Output structure
+```json
 {
   "request": {
     "method": "GET",
@@ -206,8 +180,7 @@ mpx-api get https://api.github.com/users/octocat --json
     "status": 200,
     "statusText": "OK",
     "headers": { "content-type": "application/json" },
-    "body": { "login": "octocat", ... },
-    "rawBody": "...",
+    "body": { "login": "octocat" },
     "responseTime": 145,
     "size": 1234
   }
@@ -216,30 +189,15 @@ mpx-api get https://api.github.com/users/octocat --json
 
 ### Schema Discovery
 
-AI agents can discover all available commands, flags, and output formats:
-
 ```bash
 mpx-api --schema
 ```
 
-Returns a complete JSON schema describing:
-- All commands and subcommands
-- Available flags and their types
-- Input/output schemas
-- Usage examples
-- Exit codes
-
-Perfect for dynamic tool discovery by AI assistants!
-
-### MCP Server Mode
+Returns a complete JSON schema describing all commands, flags, inputs, outputs, and examples.
 
-Start mpx-api as an MCP (Model Context Protocol) server for AI agent integration:
-
-```bash
-mpx-api mcp
-```
+### MCP Integration
 
-Add to your MCP client configuration (e.g., Claude Desktop, Cline):
+Add to your MCP client configuration (Claude Desktop, Cursor, Windsurf, etc.):
 
 ```json
 {
@@ -252,222 +210,65 @@ Add to your MCP client configuration (e.g., Claude Desktop, Cline):
 }
 ```
 
-**Available MCP tools:**
-
-- `http_request` - Send HTTP requests with full control over method, headers, body
-- `get_schema` - Get the complete tool schema for dynamic discovery
-
-**Example MCP usage:**
-
-AI agents can now make API requests on your behalf:
-- "Make a GET request to https://api.github.com/users/octocat"
-- "POST to https://api.example.com/users with JSON body {name: 'Alice'}"
-- "What commands does mpx-api support?" (via get_schema)
-
-### Quiet Mode
-
-Suppress non-essential output with `--quiet` or `-q`:
-
-```bash
-mpx-api get https://api.example.com/data --quiet --json
-```
-
-Perfect for scripting and automation where you only want the result data.
-
-### Composability
-
-All commands are designed for Unix-style composition:
-
-```bash
-# Pipe output to jq
-mpx-api get https://api.github.com/users/octocat --json | jq '.response.body.login'
-
-# Use in scripts
-STATUS=$(mpx-api get https://api.example.com/health --json | jq -r '.response.status')
-if [ "$STATUS" -eq 200 ]; then
-  echo "API is healthy"
-fi
-
-# Batch processing
-cat urls.txt | while read url; do
-  mpx-api get "$url" --json >> results.jsonl
-done
-```
+The MCP server exposes these tools:
+- **`http_request`** — Send HTTP requests with full control over method, headers, body
+- **`get_schema`** — Get the complete tool schema for dynamic discovery
 
 ### Exit Codes
 
-Predictable exit codes for automation:
+| Code | Meaning |
+|------|---------|
+| 0 | Success (2xx or 3xx HTTP status) |
+| 1 | Request failed or 4xx/5xx HTTP status |
 
-- `0` - Success (2xx or 3xx HTTP status)
-- `1` - Request failed or 4xx/5xx HTTP status
+### Automation Tips
 
-```bash
-# Check if request succeeded
-if mpx-api get https://api.example.com/endpoint --quiet; then
-  echo "Success!"
-else
-  echo "Request failed"
-fi
-```
-
-## Pro Features 💎
-
-Upgrade to **mpx-api Pro** ($12/mo) for advanced features:
-
-### Mock Server
-
-Start a mock API server from an OpenAPI spec:
-
-```bash
-mpx-api mock ./openapi.yaml --port 4000
-```
-
-Supports:
-- OpenAPI 3.0 specs (YAML or JSON)
-- Automatic response generation from schemas
-- Configurable response delay: `--delay 200`
-- CORS support: `--cors`
-
-### Load Testing
-
-```bash
-mpx-api load https://api.example.com/health --rps 100 --duration 30s
-```
-
-Features:
-- Requests per second (RPS) control
-- Response time percentiles (P50, P95, P99)
-- Status code distribution
-- Error tracking
-
-### Documentation Generation
-
-Generate beautiful API docs from your collections:
-
-```bash
-mpx-api docs ./collection.yaml --output API.md
-```
-
-Creates Markdown documentation with:
-- Table of contents
-- Request/response examples
-- Expected responses from assertions
-- Auto-generated from your test collections
-
-### Request Chaining
-
-Already included in free tier! Use response data from previous requests:
-
-```yaml
-requests:
-  - name: login
-    method: POST
-    url: /auth/login
-    json:
-      username: test
-      password: secret
-
-  - name: get-profile
-    method: GET
-    url: /users/me
-    headers:
-      Authorization: Bearer {{login.response.body.token}}
-```
-
-## Examples
-
-See the `examples/` directory for real-world collections:
-
-- `jsonplaceholder.yaml` - CRUD operations with JSONPlaceholder API
-- `github-api.yaml` - GitHub API with request chaining
-- `openapi-petstore.yaml` - OpenAPI spec for mock server testing
-
-Run examples:
-
-```bash
-mpx-api test examples/jsonplaceholder.yaml
-mpx-api collection run examples/github-api.yaml
-```
+- Use `--json` for machine-parseable output
+- Use `--quiet` to suppress banners and progress info
+- Pipe output to `jq` for filtering
+- Check exit codes for pass/fail in CI/CD
 
 ## CI/CD Integration
 
-Use exit codes for CI/CD pipelines:
-
-```bash
-# In your CI script
-mpx-api test ./api-tests.yaml --env production
-
-# Exit code 0 = all tests passed
-# Exit code 1 = tests failed
-```
-
-GitHub Actions example:
-
 ```yaml
+# .github/workflows/api-tests.yml
 - name: Run API Tests
   run: npx mpx-api test ./tests/api-collection.yaml --env staging
 ```
 
-## Error Handling
-
-mpx-api gracefully handles:
-
-- **DNS failures**: Clear error messages
-- **Timeouts**: Configurable with `--timeout <ms>`
-- **SSL errors**: Skip verification with `--no-verify`
-- **Invalid JSON**: Parse errors with helpful messages
-- **Large responses**: Automatic truncation in terminal (full body still accessible)
-
-## Configuration
-
-Global config: `~/.mpx-api/config.json`  
-Project config: `.mpx-api/config.json`  
-Cookie jar: `~/.mpx-api/cookies.json`  
-History: `~/.mpx-api/history.jsonl`
-
-## Comparison
+## Free vs Pro
 
-| Feature | mpx-api | Postman | HTTPie Pro | curl |
-|---------|---------|---------|------------|------|
-| **Price** | Free / $12 Pro | $49/user | $9/mo | Free |
-| **Collections** | ✅ YAML files | ✅ Proprietary | ❌ | ❌ |
-| **Request chaining** | ✅ | ✅ | ❌ | ❌ |
-| **Assertions** | ✅ Built-in | ✅ Scripts | ❌ | ❌ |
-| **Mock server** | ✅ Pro | ✅ Pro | ❌ | ❌ |
-| **Load testing** | ✅ Pro | ✅ Pro | ❌ | ❌ |
-| **Git-friendly** | ✅ | ⚠️ Export needed | N/A | N/A |
-| **No GUI needed** | ✅ | ❌ | ✅ | ✅ |
-| **Syntax highlighting** | ✅ | ✅ | ✅ | ❌ |
+| Feature | Free | Pro |
+|---------|------|-----|
+| HTTP requests | ✅ | ✅ |
+| Collections & chaining | ✅ | ✅ |
+| Environments | ✅ | ✅ |
+| Assertions & testing | ✅ | ✅ |
+| JSON output | ✅ | ✅ |
+| MCP server | ✅ | ✅ |
+| Mock server | ❌ | ✅ |
+| Load testing | ❌ | ✅ |
+| Doc generation | ❌ | ✅ |
 
-## Development
+**Upgrade to Pro:** [https://mesaplex.com/mpx-api](https://mesaplex.com/mpx-api)
 
-```bash
-# Clone and install
-git clone https://github.com/mesaplex/mpx-api.git
-cd mpx-api
-npm install
-
-# Run tests
-npm test
-
-# Link for local development
-npm link
-```
-
-## Contributing
+## License
 
-Contributions welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) first.
+Dual License — Free tier for personal use, Pro license for commercial use and advanced features. See [LICENSE](LICENSE) for full terms.
 
-## License
+## Links
 
-MIT © Mesaplex
+- **Website:** [https://mesaplex.com](https://mesaplex.com)
+- **npm:** [https://www.npmjs.com/package/mpx-api](https://www.npmjs.com/package/mpx-api)
+- **GitHub:** [https://github.com/mesaplexdev/mpx-api](https://github.com/mesaplexdev/mpx-api)
+- **Support:** support@mesaplex.com
 
-## Support
+### Related Tools
 
-- **Issues**: [GitHub Issues](https://github.com/mesaplex/mpx-api/issues)
-- **Discussions**: [GitHub Discussions](https://github.com/mesaplex/mpx-api/discussions)
-- **Email**: support@mpx-api.dev
+- **[mpx-scan](https://www.npmjs.com/package/mpx-scan)** — Website security scanner
+- **[mpx-db](https://www.npmjs.com/package/mpx-db)** — Database management CLI
+- **[mpx-secrets-audit](https://www.npmjs.com/package/mpx-secrets-audit)** — Secret lifecycle tracking and audit
 
 ---
 
-**Built with ❤️ by developers, for developers.**
+**Made with ❤️ by [Mesaplex](https://mesaplex.com)**

package/bin/mpx-api.js

@@ -32,14 +32,34 @@ if (process.argv.includes('--schema')) {
   process.exit(0);
 }
 
+// Handle --no-color early
+if (process.argv.includes('--no-color') || !process.stdout.isTTY) {
+  process.env.FORCE_COLOR = '0';
+}
+
+// Handle --json as alias for --output json
+if (process.argv.includes('--json') && !process.argv.includes('--output')) {
+  const idx = process.argv.indexOf('--json');
+  process.argv.splice(idx, 1, '--output', 'json');
+}
+
 program
   .name('mpx-api')
   .description('Developer-first API testing, mocking, and documentation CLI')
   .version(pkg.version)
   .enablePositionalOptions()
   .passThroughOptions()
+  .option('--json', 'Output as JSON (machine-readable)')
   .option('-o, --output <format>', 'Output format: json for structured JSON (machine-readable)')
-  .option('-q, --quiet', 'Suppress non-essential output');
+  .option('-q, --quiet', 'Suppress non-essential output')
+  .option('--no-color', 'Disable colored output')
+  .option('--schema', 'Output JSON schema describing all commands and flags');
+
+// Error handling — must be set BEFORE .command() so subcommands inherit exitOverride
+program.exitOverride();
+program.configureOutput({
+  writeErr: () => {} // Suppress Commander's own error output; we handle it in the catch below
+});
 
 // Register HTTP method commands (get, post, put, patch, delete, head, options)
 registerRequestCommands(program);
@@ -129,7 +149,7 @@ program
       if (jsonMode) {
         console.log(JSON.stringify({ error: err.message, code: 'ERR_UPDATE' }, null, 2));
       } else {
-        console.error(chalk.red.bold('\n❌ Update check failed:'), err.message);
+        console.error(chalk.red('Error:'), err.message);
         console.error('');
       }
       process.exit(1);
@@ -149,4 +169,22 @@ program
     }
   });
 
-program.parse();
+// Error handling
+program.exitOverride();
+program.configureOutput({
+  writeErr: () => {} // Suppress Commander's own error output; we handle it below
+});
+
+try {
+  await program.parseAsync(process.argv);
+} catch (err) {
+  if (err.code === 'commander.version') {
+    process.exit(0);
+  }
+  if (err.code !== 'commander.help' && err.code !== 'commander.helpDisplayed') {
+    const chalk = (await import('chalk')).default;
+    const msg = err.message.startsWith('error:') ? `Error: ${err.message.slice(7)}` : `Error: ${err.message}`;
+    console.error(chalk.red(msg));
+    process.exit(2);
+  }
+}

package/package.json

@@ -1,26 +1,29 @@
 {
   "name": "mpx-api",
-  "version": "1.2.2",
-  "description": "Developer-first API testing, mocking, and documentation CLI with AI-native features (JSON output, MCP server)",
+  "version": "1.2.3",
+  "description": "API testing, mocking, and documentation CLI. Developer-first HTTP workflows. AI-native with JSON output and MCP server.",
   "main": "src/index.js",
   "bin": {
     "mpx-api": "bin/mpx-api.js"
   },
   "keywords": [
+    "cli",
+    "devtools",
+    "mesaplex",
+    "ai-native",
+    "mcp",
+    "model-context-protocol",
+    "automation",
+    "json-output",
     "api",
     "testing",
     "http",
     "rest",
     "mock",
-    "cli",
     "postman",
     "httpie",
     "openapi",
-    "swagger",
-    "mcp",
-    "ai-native",
-    "model-context-protocol",
-    "automation"
+    "swagger"
   ],
   "author": "Mesaplex <support@mesaplex.com>",
   "license": "SEE LICENSE IN LICENSE",
@@ -42,22 +45,22 @@
     "lint": "echo 'TODO: Add eslint'",
     "prepublishOnly": "npm test"
   },
+  "funding": "https://mesaplex.com/pricing",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
     "chalk": "^5.3.0",
-    "commander": "^12.0.0",
-    "yaml": "^2.3.4",
-    "undici": "^6.6.0",
     "cli-highlight": "^2.1.11",
+    "commander": "^12.0.0",
+    "filenamify": "^6.0.0",
+    "pdfkit": "^0.17.2",
     "tough-cookie": "^4.1.3",
-    "filenamify": "^6.0.0"
+    "undici": "^6.6.0",
+    "yaml": "^2.3.4"
   },
-  "devDependencies": {},
   "files": [
     "src/",
     "bin/",
     "README.md",
-    "LICENSE",
-    "package.json"
+    "LICENSE"
   ]
 }

package/src/commands/collection.js

@@ -1,9 +1,8 @@
 import { existsSync, readdirSync, readFileSync, writeFileSync } from 'fs';
 import { parse, stringify } from 'yaml';
 import { ensureLocalDir } from '../lib/config.js';
-import { formatSuccess, formatError, formatInfo, formatWarning } from '../lib/output.js';
+import { formatSuccess, formatError, formatInfo, formatWarning, formatTestResults } from '../lib/output.js';
 import { runCollection } from '../lib/collection-runner.js';
-import { formatTestResults } from '../lib/output.js';
 import { join } from 'path';
 
 export function registerCollectionCommands(program) {
@@ -96,6 +95,7 @@ export function registerCollectionCommands(program) {
     .option('-e, --env <name>', 'Environment to use')
     .option('--base-url <url>', 'Override base URL')
     .option('--json', 'Output results as JSON')
+    .option('--pdf <filename>', 'Export results as a PDF report')
     .action(async (file, options, command) => {
       try {
         const collectionPath = file || join('.mpx-api', 'collection.yaml');
@@ -122,7 +122,21 @@ export function registerCollectionCommands(program) {
         
         const baseUrl = options.baseUrl || collection.baseUrl || '';
         
+        const startTime = Date.now();
         const results = await runCollection(collection, { env, baseUrl });
+        const totalTime = Date.now() - startTime;
+        
+        // Generate PDF if requested
+        if (options.pdf) {
+          const { generatePDFReport } = await import('../lib/pdf-report.js');
+          const pdfPath = options.pdf.endsWith('.pdf') ? options.pdf : `${options.pdf}.pdf`;
+          await generatePDFReport(results, {
+            target: baseUrl || collection.baseUrl || 'API Tests',
+            collectionName: collection.name,
+            totalTime,
+          }, pdfPath);
+          formatSuccess(`PDF report saved to ${pdfPath}`);
+        }
         
         const globalOpts = command.optsWithGlobals();
         const jsonOutput = options.json || globalOpts.output === 'json';

package/src/commands/test.js

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync } from 'fs';
 import { parse } from 'yaml';
-import { formatError } from '../lib/output.js';
+import { formatError, formatSuccess } from '../lib/output.js';
 import { runCollection } from '../lib/collection-runner.js';
 import { formatTestResults } from '../lib/output.js';
 import { join } from 'path';
@@ -12,6 +12,7 @@ export function registerTestCommand(program) {
     .option('-e, --env <name>', 'Environment to use')
     .option('--base-url <url>', 'Override base URL')
     .option('--json', 'Output results as JSON')
+    .option('--pdf <filename>', 'Export results as a PDF report')
     .action(async (file, options) => {
       try {
         const collectionPath = file || join('.mpx-api', 'collection.yaml');
@@ -37,7 +38,21 @@ export function registerTestCommand(program) {
         
         const baseUrl = options.baseUrl || collection.baseUrl || '';
         
+        const startTime = Date.now();
         const results = await runCollection(collection, { env, baseUrl });
+        const totalTime = Date.now() - startTime;
+        
+        // Generate PDF if requested
+        if (options.pdf) {
+          const { generatePDFReport } = await import('../lib/pdf-report.js');
+          const pdfPath = options.pdf.endsWith('.pdf') ? options.pdf : `${options.pdf}.pdf`;
+          await generatePDFReport(results, {
+            target: baseUrl || collection.baseUrl || 'API Tests',
+            collectionName: collection.name,
+            totalTime,
+          }, pdfPath);
+          formatSuccess(`PDF report saved to ${pdfPath}`);
+        }
         
         if (options.json) {
           console.log(JSON.stringify(results, null, 2));

package/src/lib/http-client.js

@@ -63,12 +63,10 @@ export class HttpClient {
       requestOptions.maxRedirections = 0;
     }
 
-    // Handle timeout
+    // Handle timeout via undici's built-in options
     if (this.timeout) {
-      const controller = new AbortController();
-      const timeoutId = setTimeout(() => controller.abort(), this.timeout);
-      requestOptions.signal = controller.signal;
-      requestOptions._timeoutId = timeoutId;
+      requestOptions.headersTimeout = this.timeout;
+      requestOptions.bodyTimeout = this.timeout;
     }
 
     // Add cookies to request
@@ -89,10 +87,7 @@ export class HttpClient {
     }
 
     try {
-      const timeoutId = requestOptions._timeoutId;
-      delete requestOptions._timeoutId;
       const response = await request(url, requestOptions);
-      if (timeoutId) clearTimeout(timeoutId);
       
       // Store cookies from response
       const setCookieHeaders = response.headers['set-cookie'];
@@ -139,7 +134,7 @@ export class HttpClient {
       };
     } catch (err) {
       // Handle network errors gracefully
-      if (err.name === 'AbortError' || err.code === 'UND_ERR_ABORTED') {
+      if (err.name === 'AbortError' || err.code === 'UND_ERR_ABORTED' || err.code === 'UND_ERR_HEADERS_TIMEOUT' || err.code === 'UND_ERR_BODY_TIMEOUT') {
         throw new Error(`Request timeout after ${this.timeout}ms`);
       } else if (err.code === 'ENOTFOUND') {
         throw new Error(`DNS lookup failed for ${url}`);

package/src/lib/pdf-report.js

@@ -0,0 +1,217 @@
+/**
+ * PDF Report Generator for mpx-api
+ * 
+ * Generates professional API test result reports using PDFKit.
+ * Style consistent with mpx-scan PDF reports.
+ */
+
+import PDFDocument from 'pdfkit';
+import { createWriteStream, readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const pkg = JSON.parse(readFileSync(join(__dirname, '../../package.json'), 'utf8'));
+
+// Color palette (consistent with mpx-scan)
+const COLORS = {
+  primary: '#1a56db',
+  dark: '#1f2937',
+  gray: '#6b7280',
+  lightGray: '#e5e7eb',
+  white: '#ffffff',
+  pass: '#16a34a',
+  warn: '#ea580c',
+  fail: '#dc2626',
+  headerBg: '#1e3a5f',
+  sectionBg: '#f3f4f6',
+};
+
+/**
+ * Generate a PDF report from test/collection results
+ * @param {Array} results - Array of test result objects from collection-runner
+ * @param {object} meta - Metadata: { target, collectionName, totalTime }
+ * @param {string} outputPath - Path to write the PDF
+ * @returns {Promise<string>} - Resolved path of the generated PDF
+ */
+export function generatePDFReport(results, meta, outputPath) {
+  return new Promise((resolve, reject) => {
+    try {
+      const now = new Date().toLocaleDateString('en-US', {
+        year: 'numeric', month: 'long', day: 'numeric',
+        hour: '2-digit', minute: '2-digit',
+      });
+
+      const passed = results.filter(r => r.passed).length;
+      const failed = results.filter(r => !r.passed).length;
+      const total = results.length;
+
+      const doc = new PDFDocument({
+        size: 'A4',
+        margins: { top: 50, bottom: 50, left: 50, right: 50 },
+        info: {
+          Title: `mpx-api Test Report — ${meta.target || 'API Tests'}`,
+          Author: 'mpx-api',
+          Subject: 'API Test Results',
+          Creator: `mpx-api v${pkg.version}`,
+        },
+        bufferPages: true,
+      });
+
+      const stream = createWriteStream(outputPath);
+      doc.pipe(stream);
+
+      const pageWidth = doc.page.width - doc.page.margins.left - doc.page.margins.right;
+
+      // ─── Header ───
+      doc.rect(0, 0, doc.page.width, 100).fill(COLORS.headerBg);
+      doc.fontSize(22).fillColor(COLORS.white).font('Helvetica-Bold')
+        .text('mpx-api Test Report', 50, 30);
+      doc.fontSize(10).fillColor('#a0b4cc').font('Helvetica')
+        .text(`v${pkg.version}  •  ${now}  •  ${meta.target || 'Collection Run'}`, 50, 60);
+
+      doc.y = 120;
+
+      // ─── Summary Box ───
+      const passRate = total > 0 ? Math.round((passed / total) * 100) : 0;
+      const gradeColor = passRate === 100 ? COLORS.pass : passRate >= 50 ? COLORS.warn : COLORS.fail;
+
+      doc.roundedRect(50, doc.y, pageWidth, 80, 6).fill(COLORS.sectionBg);
+      const summaryTop = doc.y + 12;
+
+      // Pass rate circle
+      doc.circle(100, summaryTop + 28, 26).fill(gradeColor);
+      doc.fontSize(20).fillColor(COLORS.white).font('Helvetica-Bold')
+        .text(`${passRate}%`, 100 - 20, summaryTop + 16, { width: 40, align: 'center' });
+
+      // Summary text
+      doc.fontSize(14).fillColor(COLORS.dark).font('Helvetica-Bold')
+        .text(`${passed}/${total} tests passed`, 145, summaryTop + 5);
+
+      const timingText = meta.totalTime ? `Total time: ${meta.totalTime}ms` : '';
+      const collName = meta.collectionName ? `Collection: ${meta.collectionName}` : '';
+      const subtext = [collName, timingText].filter(Boolean).join('  •  ');
+      if (subtext) {
+        doc.fontSize(10).fillColor(COLORS.gray).font('Helvetica')
+          .text(subtext, 145, summaryTop + 25);
+      }
+
+      // Counts on right side
+      const countsX = 370;
+      const counts = [
+        { label: 'Passed', count: passed, color: COLORS.pass },
+        { label: 'Failed', count: failed, color: COLORS.fail },
+        { label: 'Total', count: total, color: COLORS.primary },
+      ];
+      counts.forEach((c, i) => {
+        const cx = countsX + i * 60;
+        doc.fontSize(18).fillColor(c.color).font('Helvetica-Bold')
+          .text(String(c.count), cx, summaryTop + 5, { width: 50, align: 'center' });
+        doc.fontSize(7).fillColor(COLORS.gray).font('Helvetica')
+          .text(c.label, cx, summaryTop + 28, { width: 50, align: 'center' });
+      });
+
+      doc.y = summaryTop + 68;
+
+      // ─── Detailed Results ───
+      for (const result of results) {
+        // Check page space
+        if (doc.y > doc.page.height - 160) {
+          doc.addPage();
+          doc.y = 50;
+        }
+
+        doc.y += 8;
+
+        // Result header bar
+        const statusColor = result.passed ? COLORS.pass : COLORS.fail;
+        const statusLabel = result.passed ? '✓ PASS' : '✗ FAIL';
+
+        doc.roundedRect(50, doc.y, pageWidth, 26, 4).fill(statusColor);
+        doc.fontSize(10).fillColor(COLORS.white).font('Helvetica-Bold')
+          .text(statusLabel, 60, doc.y + 7);
+        doc.fontSize(10).fillColor(COLORS.white).font('Helvetica-Bold')
+          .text(result.name, 120, doc.y + 7);
+
+        // Response info on right
+        if (result.response) {
+          const info = `${result.response.method || 'GET'} ${result.response.status} • ${result.response.responseTime}ms`;
+          doc.fontSize(8).fillColor('#ffffffcc').font('Helvetica')
+            .text(info, 60, doc.y + 8, { width: pageWidth - 20, align: 'right' });
+        }
+
+        doc.y += 32;
+
+        // URL
+        if (result.response?.url) {
+          doc.fontSize(8).fillColor(COLORS.gray).font('Helvetica')
+            .text(result.response.url, 60, doc.y, { width: pageWidth - 20 });
+          doc.y += 14;
+        }
+
+        // Error message
+        if (result.error) {
+          doc.fontSize(9).fillColor(COLORS.fail).font('Helvetica')
+            .text(`Error: ${result.error}`, 60, doc.y, { width: pageWidth - 20 });
+          doc.y += doc.heightOfString(`Error: ${result.error}`, { width: pageWidth - 20, fontSize: 9 }) + 6;
+        }
+
+        // Assertions
+        if (result.assertions && result.assertions.length > 0) {
+          for (const assertion of result.assertions) {
+            if (doc.y > doc.page.height - 80) {
+              doc.addPage();
+              doc.y = 50;
+            }
+
+            const aColor = assertion.passed ? COLORS.pass : COLORS.fail;
+            const aIcon = assertion.passed ? '✓' : '✗';
+
+            doc.fontSize(8).fillColor(aColor).font('Helvetica-Bold')
+              .text(aIcon, 65, doc.y);
+            doc.fontSize(8).fillColor(COLORS.dark).font('Helvetica')
+              .text(assertion.description, 80, doc.y, { width: pageWidth - 45 });
+            doc.y += 14;
+
+            if (!assertion.passed) {
+              doc.fontSize(7).fillColor(COLORS.gray).font('Helvetica')
+                .text(`Expected: ${JSON.stringify(assertion.expected)}  |  Got: ${JSON.stringify(assertion.actual)}`, 80, doc.y, { width: pageWidth - 45 });
+              doc.y += 12;
+            }
+          }
+        }
+
+        doc.y += 4;
+
+        // Separator line
+        doc.moveTo(50, doc.y).lineTo(50 + pageWidth, doc.y)
+          .strokeColor(COLORS.lightGray).lineWidth(0.5).stroke();
+        doc.y += 4;
+      }
+
+      // ─── Footer on every page ───
+      const range = doc.bufferedPageRange();
+      for (let i = range.start; i < range.start + range.count; i++) {
+        doc.switchToPage(i);
+        const footerY = doc.page.height - 35;
+        doc.fontSize(7).fillColor(COLORS.gray).font('Helvetica')
+          .text(
+            `Generated by mpx-api v${pkg.version} on ${now}`,
+            50, footerY, { width: pageWidth, align: 'center' }
+          );
+        doc.text(
+          `Page ${i + 1} of ${range.count}`,
+          50, footerY + 12, { width: pageWidth, align: 'center' }
+        );
+      }
+
+      doc.end();
+
+      stream.on('finish', () => resolve(outputPath));
+      stream.on('error', reject);
+    } catch (err) {
+      reject(err);
+    }
+  });
+}

package/src/mcp.js

@@ -166,8 +166,7 @@ export async function startMCPServer() {
           type: 'text',
           text: JSON.stringify({ 
             error: err.message,
-            code: err.code || 'ERR_REQUEST',
-            stack: err.stack
+            code: err.code || 'ERR_REQUEST'
           }, null, 2)
         }],
         isError: true

package/src/schema.js

@@ -160,7 +160,8 @@ export function getSchema() {
             flags: {
               '-e, --env': { type: 'string', description: 'Environment name to use' },
               '--base-url': { type: 'string', description: 'Override base URL' },
-              '--json': { type: 'boolean', description: 'Output results as JSON' }
+              '--json': { type: 'boolean', description: 'Output results as JSON' },
+              '--pdf': { type: 'string', description: 'Export results as a PDF report to the specified file' }
             }
           },
           list: {
@@ -212,7 +213,8 @@ export function getSchema() {
         },
         flags: {
           '-e, --env': { type: 'string', description: 'Environment name' },
-          '--json': { type: 'boolean', description: 'Output results as JSON' }
+          '--json': { type: 'boolean', description: 'Output results as JSON' },
+          '--pdf': { type: 'string', description: 'Export results as a PDF report to the specified file' }
         }
       },
       history: {
@@ -267,6 +269,10 @@ export function getSchema() {
         ]
       }
     },
+    exitCodes: {
+      0: 'Success',
+      1: 'Error (request failed, validation error, etc.)'
+    },
     globalFlags: {
       '-o, --output': {
         type: 'string',