Repository avatar
Developer Tools
v1.0.0
active

testbay-mcp

io.github.LeoSprr/testbay-mcp

MCP tools for Testbay: list tests, drafts, tester feedback and account credits.

Documentation

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

VariableRequiredDefaultPurpose
TESTBAY_API_KEYYes (all tools)—Developer Bearer token from Testbay
TESTBAY_API_URLNohttps://testbay.dev/apiREST API base URL

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

ToolDescription
list_testsYour draft, active (live) and completed test listings
create_test_draftUnpaid draft with reward, platform, requirements and slots
get_test_feedbackTester answers, ratings in responses, voice timestamps and screen captures
get_account_summaryAccount status, wallet credits and publisher profile

list_tests

ParameterTypeDefaultDescription
limitinteger25Max tests per group (draft / active / completed)

create_test_draft

ParameterTypeDescription
titlestringShort title (1–120 chars)
descriptionstringProduct summary
what_to_teststringFocus areas
instructionsstringSteps for testers
platform"web" | "ios"Target platform
linkstring (https)Site URL or TestFlight join link
reward_centsintegerUSD cents per tester
max_testersintegerSlot count
est_minutesintegerEstimated duration (default 15)

get_test_feedback

ParameterTypeDefaultDescription
test_idUUID—Test to read
limitinteger25Sessions per page
offsetinteger0Pagination offset
only_approvedbooleanfalseOnly 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

AgentHow users find Testbay
Claude Desktop / many clientsOfficial MCP Registry entry io.github.LeoSprr/testbay-mcp (already published)
GlamaGitHub topics mcp + mcp-server on this repo
mcp.so / awesome-mcpManual 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:

DirectoryWhat to do
SmitherySign in with GitHub → connect LeoSprr/testbay-mcp (uses smithery.yaml).
MCP RegistryInstall 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-serversPR 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.soSubmit form with the GitHub repo URL and install command npx -y testbay-mcp.
GlamaOn 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.

NPM
testbay-mcp
Install Command
npm install testbay-mcp