Glubean

Glubean

API quality layer: functional correctness tests and load performance tests in the same TypeScript project, with AI agents that write, run, and repair them.

[](https://www.npmjs.com/package/@glubean/sdk) [](https://github.com/glubean/glubean/actions/workflows/ci.yml) [](LICENSE)

npx glubean config mcp        # AI agent can run and inspect tests
npx skills add glubean/skill   # AI agent learns Glubean patterns

"write a smoke test for /users"
"migrate our Postman collection"
"design the billing API contracts before I build it"
"run a load test and show me p95 latency per endpoint"

The agent writes the test, runs it via MCP, reads the structured failure, fixes it, and reruns — in one conversation.

Two ways to use it

API already exists? Point the agent at your API. It writes tests that run, break, get repaired, and graduate from explore/ to tests/ to CI. Add a load plan alongside to track performance over time.

API doesn't exist yet? Describe what it should do. The agent writes executable contracts in contracts/ — the implementation must satisfy them. After you build the API, the same contracts become your regression tests and can seed load scenarios.

Quick start

npx glubean init      # interactive wizard: try, test existing API, or contract-first
npx glubean run       # run tests
npx glubean load      # run load plans (discover *.load.ts, write structured artifacts)
npx glubean login     # authenticate with Glubean Cloud (browser device flow)

Or with AI:

npx glubean config mcp
npx skills add glubean/skill

Then ask your agent anything — it writes, runs, reads structured failures, and fixes in a loop.

VS Code extension

The extension serves two roles:

1. Postman replacement — explore/ is your API collection in code. Click the gutter play button to send a request, see full response in the result viewer. Save parameter sets with test.pick, share via git. No Postman account, no per-seat pricing.
2. Visual layer for test results — run from gutter or Test Explorer, inspect structured traces, debug with typed expected vs actual.

Same TypeScript file works as both API collection entry and CI regression test. No export, no conversion.

Packages

| Package | What it does | |---------|-------------| | [@glubean/sdk](packages/sdk) | Author tests — test(), configure(), assertions, builder flows | | [@glubean/sdk/load](packages/sdk) | Author load plans — loadScenario(), loadRunner(), traffic-mix, feeders | | [@glubean/cli](packages/cli) | Run tests and load plans, manage environments, init projects | | [@glubean/engine](packages/engine) | Environment-agnostic run-loop core (Node runner + browser host) | | [@glubean/runner](packages/runner) | Test and load executor | | [@glubean/scanner](packages/scanner) | Static analysis for IDE integration | | [@glubean/mcp](packages/mcp) | MCP server — agents run and inspect tests | | [@glubean/redaction](packages/redaction) | Sensitive data redaction |

Plugins

| Plugin | Protocol | |--------|----------| | [@glubean/auth](packages/auth) | Bearer, API key, OAuth 2.0 | | [@glubean/browser](packages/browser) | Browser automation (Puppeteer) | | [@glubean/graphql](packages/graphql) | GraphQL queries and mutations | | [@glubean/grpc](packages/grpc) | gRPC unary calls | | [@glubean/oauth-code](packages/oauth-code) | OAuth Authorization Code flow for explore mode |

Links

• Landing — product overview
• Docs — full documentation
• VS Code Extension
• Cookbook — working examples
• Agent Skill — teach AI agents Glubean patterns

Contributing

Bug reports, feature requests, and pull requests are welcome — see [CONTRIBUTING.md](CONTRIBUTING.md). Security issues go through [private vulnerability reporting](SECURITY.md), not public issues.

License

[Apache-2.0](LICENSE)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: glubean
• Source: glubean/glubean
• License: Apache-2.0
• Homepage: https://glubean.com

Install and usage instructions live in the source repository linked above.