Documentation
Everything you need to know about setting up and using Spyke for your load testing needs.
Getting Started
Create New Organization
To begin using Spyke, your first step is creating an organization. An organization acts as the top-level billing and administrative container for your team and all associated load tests.
- Navigate to the Sign Up page.
- Fill out your personal details (Name, Email, Password).
- In the Organization Name field, provide a clear identifier for your company or team (e.g., "Acme Corp Engineering").
- Click "Create Account". Your organization will be provisioned immediately with a starting allocation of 1,000 Free Virtual User hours (VUh).
Login
Access your organization's resources through the secure login portal.
- Go to the Login page.
- Enter the email and password you used during registration.
- Upon successful authentication, you will be redirected to your centralized Dashboard Overview, where you can view your Available Credit and recent test history.
Create Project Optional
Projects allow you to group related tests together and implement granular Role-Based Access Control (RBAC). Note: If you are a solo developer or do not require strict access isolation between teams, you can skip this step and run tests directly in your default workspace.
- From your dashboard sidebar, click on Administration.
- Navigate to the Projects tab.
- Click the New Project button.
- Provide a descriptive Project Name (e.g., "Mobile API Load Tests") and an optional description.
- Click Create. You can now use the Project Dropdown in the top-right header to switch contexts and assign users specific roles (Editor/Viewer) exclusively to this project.
Create Test
Spyke allows you to execute distributed load tests using your existing framework scripts. The orchestration engine automatically parses your requirements and spins up the necessary cloud infrastructure.
- Click the prominent Create Test button at the top of your dashboard sidebar.
- Test Name: Give your test a recognizable name (e.g., "Black Friday Checkout Flow").
- Test Configuration:
- Choose Global Load for a simplified setup, or Regional Load to explicitly distribute virtual users across different geographic data centers.
- Define your target Virtual Users (VUs).
- Set the Duration (in minutes) and Ramp-up Time.
- Test Script: Select your preferred framework tab (JMeter, k6, Locust, Gatling, or Artillery) and upload your raw script file (e.g., `.jmx`, `.js`, `.py`).
- Review the Estimated Cost in VUh at the bottom of the form to ensure it fits your available balance.
- Click Launch Test. Spyke will provision the agents, distribute your script, and automatically transition you to the real-time telemetry dashboard.
AI Agent Integration
Install MCP Server
Spyke provides a Model Context Protocol (MCP) server that allows AI agents like Claude and Cursor to interact directly with your load testing infrastructure. Before installing the server, you must generate an API Key.
Prerequisite: Generate API Key
- Navigate to API Keys in your dashboard sidebar.
- Click Create Key and securely copy the generated token.
- Set this token as the
SPYKE_API_KEYenvironment variable in your agent's configuration.
Claude Code
You can quickly add Spyke to the Claude CLI using the built-in MCP command. Ensure your API key is available in your shell environment.
# Export your key, then add the server
export SPYKE_API_KEY="sk_..."
claude mcp add spyke npx -y @spyke.cloud/mcp-server
Cursor
To integrate Spyke directly into your Cursor IDE, configure a new MCP server in the settings panel:
- Open Cursor Settings.
- Navigate to Features > MCP.
- Click + Add New MCP Server.
- Name:
Spyke - Type:
command - Command:
npx -y @spyke.cloud/mcp-server - Environment Variables: Add
SPYKE_API_KEYwith your generated key.
General Installation
Via NPM Package
npx -y @spyke.cloud/mcp-serverVia Remote URL
For agents that support SSE (Server-Sent Events), you can connect to:
https://spyke.cloud/api/mcpCLI
Command Line Interface is coming soon. Stay tuned!