GET STARTED · FREE LOCAL SCANNING

Your first result.
One command away.

Run a scan, understand what it found, then decide whether to save it online. No account or card needed to start.

  1. 1. Run a scan
  2. 2. Read the result
  3. 3. Save it online
STEP 1

Open your terminal. Paste this command.

On macOS, open Terminal. On Windows, open PowerShell. On Linux, open your terminal. Run this in the project folder you want to check.

Requires Node.js 20 or newer and npm. Install the current Node.js LTS if you don’t have them, then reopen your terminal.

npx -y @kryptosai/mcp-observatory@latest

The command downloads Observatory and checks your first configured MCP server. If none is configured, it checks an included example so you can see a real report.

Want to try only the included example?

This runs the bundled demo without discovering or starting your configured servers.

npx -y @kryptosai/mcp-observatory@latest demo --example
Already installed Observatory?

Run mcp-observatory in your terminal. You can use the same commands below without the npx -y @kryptosai/mcp-observatory@latest prefix.

STEP 2

Read the findings, then choose your next action.

Your terminal shows the server name, score, checks, and the path to your saved receipt. A demo report describes the example, not your own server.

Checks passed

The configured checks passed for this run. Keep the receipt and compare it after changes.

Checks need attention

The scan ran and found something to review. Read the failing checks, fix the cause, then run it again. Paying does not change the result.

Could not connect

Check the server’s startup command, required credentials, and timeout. Resolve the connection before treating the scan as evidence.

Scan your own server or inspect a published example.

STEP 3 · OPTIONAL

Save your first hosted snapshot free.

In the same project folder, run:

npx -y @kryptosai/mcp-observatory@latest cloud upload

Open the verification link printed in your terminal, confirm the code, and connect with GitHub. Return to the terminal and wait for Upload complete, then open the dashboard link it prints.

This uploads your latest scan receipt to your personal account. Free includes one target, the latest snapshot, seven-day retention, and 10 uploads per month. What gets stored.

Stuck? Pick what you’re seeing.

“npx” is not recognized or command not found

Install Node.js LTS with npm, close and reopen the terminal, and try again.

“No run artifact found” when uploading

Go back to the folder where you ran the scan. Run the scan there first, or pass the receipt path: mcp-observatory cloud upload path/to/receipt.json.

My login code expired

Run the upload command again for a fresh verification link. Use the GitHub account you want to own the result.

I want to keep everything local

Stop after step 2. Local scanning, local reports, and local CI checks stay free. Hosted history and hosted CI ingestion are optional.