feat: add list_mock_captures tool (v0.3.0)

The mock toolset shipped in v0.2.0 covered create/configure/deploy
but had no way for an agent to verify the integration was actually
calling the mock URL. This adds list_mock_captures so an agent can
close the loop: deploy → trigger from app under test → list captures
→ confirm method/path/status match expectations.

Wraps the existing GET /api/mock-endpoints/:id/interactions endpoint.
Returns id, method, path, statusCode, matchedRuleId, occurredAt,
remoteAddress per capture, with a count + total summary.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: cuongmx

README.md

@@ -114,6 +114,7 @@ Add to `~/.windsurf/mcp_config.json`:
 | `create_mock_endpoint` | Create a mock endpoint (returns live `{slug}.rbmock.dev` URL) |
 | `add_mock_rule` | Append a routing rule (match method/path → status + headers + body) |
 | `deploy_mock` | Publish the current rule set so the live mock server picks it up |
+| `list_mock_captures` | List recent requests that hit a mock endpoint — verify your integration is actually calling the mock URL |
 
 ## Example Workflow
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@requestbin/mcp-server",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "MCP server for RequestBin — test webhooks from Claude Code, Cursor, and Windsurf",
   "license": "MIT",
   "homepage": "https://github.com/requestbin/mcp-server",

src/api-client.ts

@@ -159,4 +159,9 @@ export class RequestBinClient {
       method: 'POST',
     });
   }
+
+  async listMockCaptures(endpointId: string, opts: { limit?: number } = {}): Promise<any> {
+    const limit = Math.max(1, Math.min(200, opts.limit ?? 50));
+    return this.request(`/api/mock-endpoints/${endpointId}/interactions?limit=${limit}`);
+  }
 }

src/index.ts

@@ -418,6 +418,43 @@ server.tool(
   },
 );
 
+// ── Tool: list_mock_captures ──
+
+server.tool(
+  'list_mock_captures',
+  'List recent captured requests that hit a mock endpoint. Use this to verify your integration is actually calling the mock URL — shows method, path, status, and time for each capture. Returns up to 50 by default.',
+  {
+    endpointId: z.string().describe('The mock endpoint ID (from list_mock_endpoints)'),
+    limit: z.number().int().min(1).max(200).optional().describe('Max captures to return (1-200, default 50)'),
+  },
+  async ({ endpointId, limit }) => {
+    try {
+      const result = await client.listMockCaptures(endpointId, { limit });
+      const captures = (result.interactions || []).map((i: any) => ({
+        id: i.id,
+        method: i.method,
+        path: i.path,
+        statusCode: i.statusCode,
+        matchedRuleId: i.matchedRuleId,
+        occurredAt: i.occurredAt,
+        remoteAddress: i.remoteAddress,
+      }));
+      return {
+        content: [{
+          type: 'text' as const,
+          text: JSON.stringify({
+            count: captures.length,
+            total: result.total ?? captures.length,
+            captures,
+          }, null, 2),
+        }],
+      };
+    } catch (e: any) {
+      return { content: [{ type: 'text' as const, text: `Error: ${e.message}` }], isError: true };
+    }
+  },
+);
+
 // ── Start server ──
 
 async function main() {