Skip to main content
Glama

testbay-mcp

License: MIT Node MCP

Standalone Model Context Protocol server for Testbay — 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

npx -y testbay-mcp

Or from this repository:

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

Related MCP server: mcp-devops-deploy

1-minute client setup

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "testbay": {
      "command": "npx",
      "args": ["-y", "testbay-mcp"],
      "env": {
        "TESTBAY_API_KEY": "YOUR_TESTBAY_API_KEY"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.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

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

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 configures automatic build and security scanning on 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 has .mcp.json at the repo root (this repo).

  2. Open 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 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 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 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 (not inside the main Testbay app repo). Then:

Directory

What to do

Smithery

Sign in with GitHub → connect LeoSprr/testbay-mcp (uses smithery.yaml).

MCP Registry

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

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

Submit form with the GitHub repo URL and install command npx -y testbay-mcp.

Glama

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables comprehensive social media management through Oktopost's REST API, including campaign creation, content scheduling, post management, workflow approvals, employee advocacy, and media asset handling across connected social profiles.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables automation of routine operations on Twproject installations, including task, assignment, issue, person, company, worklog, and cost management through safe, non-destructive API calls.
      1
      Apache 2.0