testbay-mcp
by LeoSprr
README.md
# testbay-mcp
[](LICENSE)
[](package.json)
[](https://modelcontextprotocol.io)
Standalone **Model Context Protocol** server for [Testbay](https://testbay.dev) — the marketplace where developers fund real people to test websites and iOS TestFlight apps.
This package is a thin, open-source client: it calls the public Testbay REST API and exposes four typed tools over **stdio**. No database keys, Supabase URLs or server secrets ship in the npm package.
## Quick start
```bash
npx -y testbay-mcp
```
Or from this repository:
```bash
cd testbay-mcp
npm ci && npm run build
node dist/index.js
```
### Environment
| Variable | Required | Default | Purpose |
| --- | --- | --- | --- |
| `TESTBAY_API_KEY` | Yes (all tools) | — | Developer Bearer token from Testbay |
| `TESTBAY_API_URL` | No | `https://testbay.dev/api` | REST API base URL |
## 1-minute client setup
### Cursor (`~/.cursor/mcp.json`)
```json
{
"mcpServers": {
"testbay": {
"command": "npx",
"args": ["-y", "testbay-mcp"],
"env": {
"TESTBAY_API_KEY": "YOUR_TESTBAY_API_KEY"
}
}
}
}
```
### Claude Desktop (`claude_desktop_config.json`)
```json
{
"mcpServers": {
"testbay": {
"command": "npx",
"args": ["-y", "testbay-mcp"],
"env": {
"TESTBAY_API_KEY": "YOUR_TESTBAY_API_KEY"
}
}
}
}
```
Restart the client after changing configuration.
### Claude Code
```bash
claude mcp add testbay -- npx -y testbay-mcp
export TESTBAY_API_KEY="YOUR_TESTBAY_API_KEY"
```
Or add the same `mcpServers` block to your Claude Code MCP settings file with `env.TESTBAY_API_KEY`.
## Tools
| Tool | Description |
| --- | --- |
| `list_tests` | Your draft, active (live) and completed test listings |
| `create_test_draft` | Unpaid draft with reward, platform, requirements and slots |
| `get_test_feedback` | Tester answers, ratings in responses, voice timestamps and screen captures |
| `get_account_summary` | Account status, wallet credits and publisher profile |
### `list_tests`
| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `limit` | integer | `25` | Max tests per group (draft / active / completed) |
### `create_test_draft`
| Parameter | Type | Description |
| --- | --- | --- |
| `title` | string | Short title (1–120 chars) |
| `description` | string | Product summary |
| `what_to_test` | string | Focus areas |
| `instructions` | string | Steps for testers |
| `platform` | `"web"` \| `"ios"` | Target platform |
| `link` | string (https) | Site URL or TestFlight join link |
| `reward_cents` | integer | USD cents per tester |
| `max_testers` | integer | Slot count |
| `est_minutes` | integer | Estimated duration (default `15`) |
### `get_test_feedback`
| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `test_id` | UUID | — | Test to read |
| `limit` | integer | `25` | Sessions per page |
| `offset` | integer | `0` | Pagination offset |
| `only_approved` | boolean | `false` | Only reviewed feedback |
### `get_account_summary`
No parameters.
## Development
```bash
npm run build
npm test
```
Tool responses are JSON text in MCP `content`. Failures set `isError: true` with a stable `error.code`.
## Smithery
[`smithery.yaml`](smithery.yaml) configures automatic build and security scanning on [Smithery.ai](https://smithery.ai).
## Show up in Cursor and agent libraries
Agents discover MCP servers through directories, not Arcade-style remote URLs (unless you host HTTP yourself).
### Cursor (fast path — community library)
1. Ensure [LeoSprr/testbay-mcp](https://github.com/LeoSprr/testbay-mcp) has **`.mcp.json`** at the repo root (this repo).
2. Open **[cursor.directory/plugins/new](https://cursor.directory/plugins/new)** → sign in with GitHub.
3. Paste **`https://github.com/LeoSprr/testbay-mcp`** → Submit.
4. An automated scan runs; when marked safe, the listing appears in **cursor.directory** and users can add it to Cursor.
5. After install, set **`TESTBAY_API_KEY`** in Cursor’s MCP settings (never commit the token).
### Cursor (official marketplace — slow)
Hand-reviewed; mostly partners. Optional: [cursor.com/marketplace/publish](https://cursor.com/marketplace/publish) with a public repo, MIT license, README + logo. Expect **weeks**, not hours.
### OAuth / no API key (hosted Testbay MCP)
For **sign-in in the browser** instead of `TESTBAY_API_KEY`, use Testbay’s hosted server:
- URL: **`https://testbay.dev/mcp`**
- Documented on [testbay.dev](https://testbay.dev) under MCP setup (Cursor “Add Testbay” deeplink).
That endpoint is separate from this npm package; deploy the main Testbay app for it to work.
### Other agents
| Agent | How users find Testbay |
| --- | --- |
| Claude Desktop / many clients | [Official MCP Registry](https://registry.modelcontextprotocol.io) entry `io.github.LeoSprr/testbay-mcp` (already published) |
| Glama | GitHub topics `mcp` + `mcp-server` on this repo |
| mcp.so / awesome-mcp | Manual submit / PR |
**Smithery** often expects a **running HTTP URL**, not a GitHub stdio repo — skip Smithery unless you deploy an HTTP transport.
## Directory listings
Publish this tree as the **standalone** repo [`LeoSprr/testbay-mcp`](https://github.com/LeoSprr/testbay-mcp) (not inside the main Testbay app repo). Then:
| Directory | What to do |
| --- | --- |
| [Smithery](https://smithery.ai) | Sign in with GitHub → connect `LeoSprr/testbay-mcp` (uses `smithery.yaml`). |
| [MCP Registry](https://registry.modelcontextprotocol.io) | Install the Go CLI: `brew install mcp-publisher` (not an npm package). Then `mcp-publisher login github` and `mcp-publisher publish`. Requires **npm publish** of `testbay-mcp` first (registry verifies package ownership). |
| [awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers) | PR adding a line in alphabetical order: `- [LeoSprr/testbay-mcp](https://github.com/LeoSprr/testbay-mcp) 📇 ☁️ 🏠 🍎 🪟 🐧 - Paid user-testing marketplace: list your tests, create drafts, read feedback and wallet via testbay.dev. \`npx -y testbay-mcp\`` |
| [mcp.so](https://mcp.so) | Submit form with the GitHub repo URL and install command `npx -y testbay-mcp`. |
| [Glama](https://glama.ai/mcp/servers) | On the public repo, set GitHub topics **`mcp`** and **`mcp-server`**; indexing is automatic within a few hours. |
After creating the GitHub repo, add topics: **mcp**, **mcp-server**, **testbay**, **model-context-protocol**.
## License
MIT — see [LICENSE](LICENSE).This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues