Back to Home
dotsetlabs icon

bellwether

Verified Safe

by dotsetlabs

Overview

Interviews MCP (Model Context Protocol) servers to generate behavioral documentation, perform API testing, and detect behavioral drift.

Installation

Run Command
npx bellwether

Environment Variables

  • OPENAI_API_KEY
  • ANTHROPIC_API_KEY
  • OLLAMA_BASE_URL
  • BELLWETHER_CLOUD_API_BASE_URL
  • BELLWETHER_SESSION

Security Notes

The project demonstrates good security practices such as filtering sensitive environment variables before spawning subprocesses (`MCPClient.filterEnv`) and using secure YAML parsing (`parseYamlSecure`) to mitigate injection risks. Baseline loading also uses Zod schema validation to prevent malicious JSON. However, as an 'interviewing' tool, it inherently processes potentially untrusted outputs from MCP servers. A notable 'eval' function is present in `test/fixtures/mock-mcp-server.ts`, which is concerning but confined to test code. The `resolvePath` in `WorkflowExecutor` traverses object paths, which is generally safe, but complex parsing logic always carries some inherent risk of unexpected behavior with malformed inputs.

Similar Servers

Stats

Interest Score0
Security Score7
Cost ClassLow
Avg Tokens800
Stars0
Forks0
Last Update2026-01-17

Tags

MCPLLMAPI TestingDocumentationBehavioral DriftCI/CDTesting Framework