Skip to main content

Cloud Integration

Bellwether Cloud provides baseline history, webhooks, and verification badges for your MCP servers.

Features​

FeatureDescription
Baseline HistoryTrack all baseline versions over time
Drift TimelineSee when and how behavior changed
Webhook NotificationsGet alerts when drift is detected
Verification BadgesDisplay status in your README
CI/CD IntegrationAutomated uploads and drift checks

Getting Started​

1. Create an Account​

Visit bellwether.sh to create an account.

2. Login via CLI​

bellwether login

This opens your browser for authentication. After logging in, credentials are stored locally.

cd your-mcp-server
bellwether link

Follow the prompts to create or select a project.

4. Upload Your First Baseline​

# Generate and upload
bellwether interview --save-baseline npx your-server
bellwether upload

Verification Badge​

Display your server's verification status in READMEs and documentation.

Get Badge via CLI​

# Get full badge information
bellwether badge

# Get just the markdown snippet
bellwether badge --markdown

# Get just the badge URL
bellwether badge --url

# Get badge for specific project
bellwether badge --project proj_abc123

Add to README​

Copy the markdown from the badge command:

[![Bellwether](https://img.shields.io/badge/bellwether-verified-brightgreen)](https://bellwether.dev/p/proj_abc123)

Badge Status​

StatusColorMeaning
passingGreenServer verified, no drift
passing (Stable)GreenMultiple versions, no drift
driftYellowBehavioral changes detected
failingRedBreaking changes detected
unknownGrayNo baseline uploaded yet

Update Badge in CI​

# After uploading baseline, get updated badge
bellwether interview --preset ci npx your-server
bellwether upload
bellwether badge --markdown

CI/CD Integration​

GitHub Actions​

name: Bellwether CI
on: [push]

jobs:
  bellwether:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Run Bellwether
        env:
          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
          BELLWETHER_SESSION: ${{ secrets.BELLWETHER_SESSION }}
        run: |
          npx @dotsetlabs/bellwether interview --save-baseline npx your-server
          npx @dotsetlabs/bellwether upload --ci --fail-on-drift

Getting CI Token​

# Get your session token
bellwether login --status
# Copy BELLWETHER_SESSION value

# Add to GitHub Secrets as BELLWETHER_SESSION

Viewing History​

Via CLI​

bellwether history

Via Dashboard​

Visit https://bellwether.sh/projects/proj_xxx to see:

  • All baseline versions
  • Diff between any two versions
  • Drift timeline
  • Upload metadata (branch, commit, CI run)

Comparing Versions​

Via Dashboard​

  1. Go to project page
  2. Click "Compare" tab
  3. Select two versions
  4. View semantic diff

Via Direct URL​

https://bellwether.sh/projects/proj_xxx/diff/10/12

Project Settings​

Notifications​

Configure alerts for:

  • Breaking drift detected
  • Security findings
  • Upload failures

Webhooks​

Send events to external services:

{
  "event": "drift.breaking",
  "project": "proj_abc123",
  "baseline": {
    "version": 12,
    "changes": [...]
  }
}

Pricing​

TierPriceFeatures
Free$0/mo1 project, 100 uploads/month, 30-day history
Pro$19/mo10 projects, 5,000 uploads/month, 1-year history, webhooks

Visit bellwether.sh/pricing for details.

Data Retention​

TierBaseline History
Free30 days
Pro1 year

Security​

  • All data encrypted in transit (TLS 1.3)
  • Data encrypted at rest
  • No baseline content shared between users

Offline Usage​

Bellwether works fully offline. Cloud is optional for:

  • Local drift detection with --compare-baseline
  • Local baseline management with --save-baseline
  • Local documentation generation

Cloud adds:

  • Historical tracking across versions
  • Webhook notifications for drift
  • Verification badges for your README

See Also​