Sentinel Signal Mcp

Created By
sentinelsignal3 months ago
Local stdio MCP server exposing Sentinel Signal as agent tools: score workflows, check limits/usage, and submit feedback. Supports env-based auth or auto-minted trial key for fast start.
Overview

Sentinel Signal MCP

Local stdio MCP server exposing Sentinel Signal as agent tools:

  • Score workflows
  • Check limits & usage
  • Submit feedback

Supports env-based auth or auto-minted trial key for fast start (unless disabled).


Skills (Tools)

  • score_workflow — Score a structured payload against a named workflow
  • get_limits — Retrieve plan limits for the current key
  • get_usage — Retrieve usage for a given month
  • submit_feedback — Submit structured outcome feedback

Install & Run

Recommended:

uvx sentinel-signal-mcp

Environment Variables

export SENTINEL_BASE_URL="https://api.sentinelsignal.io"
export SENTINEL_TOKEN_BASE_URL="https://token.sentinelsignal.io"
export SENTINEL_TIMEOUT_SECONDS="30"

# If omitted, the server can auto-mint a trial key (unless disabled)
# export SENTINEL_API_KEY="ss_live_or_test_..."

# Disable auto-trial minting
# export SENTINEL_NO_TRIAL="1"

# Override credentials cache location
# export SENTINEL_CREDENTIALS_PATH="$HOME/.sentinel/credentials.json"

Troubleshooting

402: upgrade_required: trial quota exhausted → follow the returned upgrade URL.
429: rate limited → retry later.
401/403: invalid or missing API key (set SENTINEL_API_KEY or remove SENTINEL_NO_TRIAL to allow trial).

Credentials stuck / need fresh trial key: reset cached credentials:

sentinel-signal-mcp --reset-credentials

PyPI: https://pypi.org/project/sentinel-signal-mcp/ Docs/Homepage: https://sentinelsignal.io

Server Config

{
  "mcpServers": {
    "sentinel-signal": {
      "command": "uvx",
      "args": [
        "sentinel-signal-mcp"
      ],
      "env": {
        "SENTINEL_BASE_URL": "https://api.sentinelsignal.io",
        "SENTINEL_TOKEN_BASE_URL": "https://token.sentinelsignal.io",
        "SENTINEL_TIMEOUT_SECONDS": "30"
      }
    }
  }
}
Project Info
Created At
3 months ago
Updated At
3 months ago
Author Name
sentinelsignal
Star
-
Language
-
License
-
Category

Recommend Servers

View All