# Glubean

> Workflow verification platform — write API tests in TypeScript, run locally or in CI, let AI agents write and repair them

- **Type:** MCP server
- **Install:** `agentstack add mcp-glubean-glubean`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [glubean](https://agentstack.voostack.com/s/glubean)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [glubean](https://github.com/glubean)
- **Source:** https://github.com/glubean/glubean
- **Website:** https://glubean.com

## Install

```sh
agentstack add mcp-glubean-glubean
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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)

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

```text
"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

```bash
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:

```bash
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](https://glubean.com) — product overview
- [Docs](https://docs.glubean.com) — full documentation
- [VS Code Extension](https://marketplace.visualstudio.com/items?itemName=glubean.glubean)
- [Cookbook](https://github.com/glubean/cookbook) — working examples
- [Agent Skill](https://github.com/glubean/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](https://github.com/glubean)
- **Source:** [glubean/glubean](https://github.com/glubean/glubean)
- **License:** Apache-2.0
- **Homepage:** https://glubean.com

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-glubean-glubean
- Seller: https://agentstack.voostack.com/s/glubean
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
