How do I create a MatCraft account?

Creating a MatCraft account takes less than two minutes. You have several options depending on whether you want to use the hosted cloud service or a self-hosted instance.

Cloud Service (matcraft.io)

1. Visit matcraft.ai/register.
2. Sign up with your email address or use OAuth via GitHub or Google.
3. Verify your email address by clicking the link sent to your inbox.
4. Choose your plan — the Free tier includes 3 active campaigns and 1,000 evaluations per month, which is enough for most individual researchers.
5. You will be dropped into the dashboard with a guided onboarding tour.

Self-Hosted Instance

If your organization runs a self-hosted MatCraft deployment, your administrator will provide the URL. Account creation depends on your organization's identity provider:

• Local accounts: Navigate to https://your-instance.com/signup and register with email/password.
• SSO/SAML: Click "Sign in with SSO" and authenticate through your organization's identity provider (Okta, Azure AD, etc.). Your account is created automatically on first login.

API Token

After creating your account, generate an API token for CLI and SDK usage:

1. Go to Settings > API Tokens in the dashboard.
2. Click Generate New Token.
3. Copy the token and store it securely. Set it as an environment variable:

export MATCRAFT_TOKEN="mc_live_abc123..."

1. Verify connectivity:

materia auth whoami

Your token has the same permissions as your user account. For CI/CD pipelines, we recommend creating a dedicated service account with limited permissions.