status

Overview

The status tool provides a comprehensive health check of your SESHAT installation. Always call this first before performing any operations.

Note

This tool is the entry point for the agentic experience. It helps you understand the current state before taking action.

Parameters

verbose boolean défaut: false

If true, include detailed per-project statistics and configuration.

Response

{
  "wallet": {
    "address": "0x1234...5678",
    "balance_eth": "0.05",
    "balance_usd": 100,
    "remaining_attestations": 700
  },
  "git_host": {
    "status": "connected",
    "url": "https://api.github.com"
  },
  "notion": {
    "status": "connected",
    "bot_name": "SESHAT"
  },
  "database": {
    "status": "healthy",
    "total_records": 142,
    "by_project": {
      "my-project": 100,
      "other-project": 42
    },
    "by_category": {
      "research": 80,
      "pr": 50,
      "tag": 12
    }
  },
  "last_attestation": "2026-01-16T10:30:00Z",
  "projects": [
    {
      "id": "my-project",
      "name": "My Project",
      "has_repo": true,
      "has_vault": true,
      "has_notion": true,
      "has_git_host": true
    }
  ]
}

Response Fields

wallet object

Ethereum wallet information. Properties: address (string) - Public wallet address, balance_eth (string) - ETH balance on Base L2, balance_usd (number) - Estimated USD value, remaining_attestations (number) - Estimated attestations possible with current balance.

git_host object

Git host connectivity status. Properties: status (string) - connected, disconnected, or not_configured, url (string) - Configured API URL.

notion object

Statut de l’integration Notion. Properties: status (string) - connected, disconnected, ou not_configured, bot_name (string) - Nom du bot Notion (null si non connecte).

database object

Local SQLite ledger statistics.

last_attestation string

ISO timestamp of the most recent attestation

projects array

List of configured projects (only with verbose: true)

Warnings

The agent should warn the user if:

Attention

Low balance: If wallet.balance_eth < 0.01 ETH, warn that fewer than ~140 attestations remain.

Attention

Git host disconnected: If git_host.status is not connected, PR and release sealing will fail.

Attention

Notion deconnecte : Si notion.status est disconnected, verifiez votre NOTION_TOKEN et que l’integration est bien connectee a votre base de donnees.

Examples

Basic Health Check

MCP Prompt

Check SESHAT status

Response

{
  "wallet": {
    "address": "0xABC...123",
    "balance_eth": "0.15",
    "remaining_attestations": 2100
  },
  "git_host": {
    "status": "connected"
  },
  "database": {
    "status": "healthy",
    "total_records": 42
  }
}

Verbose Mode

MCP Prompt

Check SESHAT status with verbose mode enabled

Response

{
  "wallet": { ... },
  "git_host": { ... },
  "notion": { ... },
  "database": { ... },
  "projects": [
    {
      "id": "seshat-mcp",
      "name": "SESHAT MCP",
      "has_repo": true,
      "has_vault": true,
      "has_notion": true,
      "has_git_host": true
    }
  ]
}

When to Use

Scenario	Action
Session start	Always check status first
Before bulk certification	Verify wallet has sufficient balance
After errors	Check connectivity and database health
Before release bundle	Ensure all systems operational