Sentinel Signal MCP

Sentinel Signal MCP for Healthcare Claims Scoring

Hosted and local MCP access for healthcare claims workflow scoring, usage, limits, and feedback.

- Hosted remote MCP endpoint:https://mcp.sentinelsignal.io/mcp
- Smithery listing:@sentinelsignal/scoring(https://server.smithery.ai/sentinelsignal/scoring)
- Free no-signup trial key:POST https://token.sentinelsignal.io/v1/keys/trial
- Local package:uvx sentinel-signal-mcp

uvx sentinel-signal-mcp export SENTINEL_BASE_URL="https://api.sentinelsignal.io" export SENTINEL_TOKEN_BASE_URL="https://token.sentinelsignal.io" # Optional: export SENTINEL_API_KEY="ss_live_or_test_api_key_here" # If omitted, the MCP server auto-mints a trial key

Hosted remote MCP endpoint (Streamable HTTP):https://mcp.sentinelsignal.io/mcp

Smithery hosted listing:@sentinelsignal/scoring(https://server.smithery.ai/sentinelsignal/scoring)

If your MCP client supports remote HTTP MCP, point it at that URL and sendAuthorization: Bearer <SENTINEL_API_KEY>. For Smithery-hosted connections, the key is forwarded asx-sentinel-api-key.

{ "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" } } } }

{ "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" } } } }

Windsurf can use the samemcpServersblock shape.

This package provides a local stdio MCP server, while the hosted remote service exposes the same healthcare claims tools over Streamable HTTP. It supports either:

PyPI:https://pypi.org/project/sentinel-signal-mcp/

- list_workflows— list supported workflows and current model versions
- get_workflow_schema— fetch required fields, optional fields, and an example payload for a workflow
- validate_workflow_payload— validate and normalize a workflow payload before scoring
- score_workflow— score denial risk, prior auth, and reimbursement payloads against a named workflow
- score_batch— score up to 25 workflow items in one request
- get_limits— retrieve plan limits for the current key
- get_usage— retrieve usage for a given month
- submit_feedback— submit structured outcome feedback
- Installuv(if needed):https://docs.astral.sh/uv/
- Set env vars (optionalSENTINEL_API_KEY; if omitted, the server auto-mints a trial key and caches it):

export SENTINEL_BASE_URL="https://api.sentinelsignal.io" # optional (default shown) export SENTINEL_TOKEN_BASE_URL="https://token.sentinelsignal.io" # optional (default shown) # export SENTINEL_API_KEY="ss_live_or_test_api_key_here" # optional export SENTINEL_TIMEOUT_SECONDS="30" # optional

{ "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_API_KEY": "ss_live_or_test_api_key_here", "SENTINEL_TIMEOUT_SECONDS": "30" } } } }

If your client accepts a command + args + env definition:

- command:uvx
- args:["sentinel-signal-mcp"]
- env:

- optionalSENTINEL_API_KEY(if omitted, auto-trial mint is used unless disabled)
- optionalSENTINEL_BASE_URL
- optionalSENTINEL_TOKEN_BASE_URL
- optionalSENTINEL_CREDENTIALS_PATH
- optionalSENTINEL_NO_TRIAL=1
- optionalSENTINEL_TIMEOUT_SECONDS

CallsGET /v1/workflowsso agents can discover the supported healthcare workflows and current model versions before scoring.

CallsGET /v1/workflows/{workflow}/schemaso agents can fetch required fields, optional fields, enums, and example payloads before issuing a score.

- workflow(str): workflow ID such ashealthcare.denial

CallsPOST /v1/workflows/{workflow}/validateand returns normalized payload output plus structured validation issues without consuming a scoring call.

- workflow(str): workflow ID such ashealthcare.denial
- payload(object): workflow payload object to validate

Calls the Sentinel Signal unified scoring endpoint (POST /v1/score).

- workflow(str): workflow ID (for examplehealthcare.denial,healthcare.prior_auth,healthcare.reimbursement)
- payload(object): workflow payload object
- options(object, optional): scoring options object

{ "workflow": "healthcare.denial", "payload": { "payer_id": 44, "provider_id": 1021, "patient_id": "PT_DEMO_001", "patient_age": 57, "patient_sex": "F", "cpt_code": "99214", "icd10_code": "M5450", "service_date": "2026-02-13", "place_of_service": "11", "units": 1, "billed_amount": 210.0, "allowed_amount": 145.0, "claim_frequency_code": "1", "network_status": "in_network", "prior_authorization_required": true, "prior_authorization_on_file": false, "referral_on_file": false, "is_emergency": false, "modifier_1": "25", "submission_channel": "edi", "data_source": "api" }, "options": { "allow_fallback": true, "distribution_profile": "commercial_beta", "operating_point": "high_recall" } }

CallsGET /v1/limitsfor the current API key.

- month(str, optional): month filter (for example2026-02)

CallsPOST /v1/score/batchto score up to 25 workflow items sequentially in one request.

- items(array): list of{workflow, payload, options?}scoring items
- continue_on_error(bool, optional): whether later items should continue if an earlier item fails

CallsPOST /v1/feedbackwith a structured feedback payload.

- feedback(object): rawFeedbackRequestobject

{ "feedback": { "request_id": "00000000-0000-0000-0000-000000000001", "endpoint": "denial", "observed_outcome": "denied", "expected_outcome": "paid", "confidence_mismatch": true, "payer_id": 44, "cpt": "99214", "denial_reason_code": "AUTH_MISSING", "severity": "med", "days_to_outcome": 12, "notes": "Example feedback payload for agent integration testing." } }

- ~/.sentinel/credentials.json(permissions0600)

Cached payload includes the trial key plus metadata used by the agent/runtime:

{ "api_key": "ss_trial_...", "account_id": "uuid", "expires_at": "2026-03-10T00:00:00Z", "limits": { "monthly_quota": 1000, "rps": 1, "burst": 5 }, "upgrade_url": "https://sentinelsignal.io/portal/dashboard", "token_base_url": "https://token.sentinelsignal.io", "api_base_url": "https://api.sentinelsignal.io" }

The MCP server stores both base URLs in the cache so it does not accidentally reuse a trial key across different environments.

Reset the cached credentials (force a fresh trial key next run):

uvx sentinel-signal-mcp --reset-credentials

- SENTINEL_BASE_URL(optional, defaulthttps://api.sentinelsignal.io): scoring API base URL
- SENTINEL_TOKEN_BASE_URL(optional, defaulthttps://token.sentinelsignal.io): token-service base URL used for trial key minting
- SENTINEL_API_KEY(optional): if set, used directly and never cached
- SENTINEL_CREDENTIALS_PATH(optional, default~/.sentinel/credentials.json)
- SENTINEL_NO_TRIAL(optional): set to1to disable auto-trial minting
- SENTINEL_TIMEOUT_SECONDS(optional, default30)
- SENTINEL_API_BASE_URL(legacy alias forSENTINEL_BASE_URL)

The MCP tools return structured payloads for both success and common operational failures:

-

success ->{"ok": true, ...}

quota exhausted / payment required (402) ->{"ok": false, "error": {"action": "upgrade_required", "upgrade_url": "...", ...}}

rate limited (429) ->{"ok": false, "error": {"action": "retry_later", ...}}

auth/config issues (401/403or missing credentials) ->{"ok": false, "error": {"action": "configure_credentials", ...}}

This package is set up for PyPI publishing so users can run it with:

python -m build python -m twine upload dist/*

- Do not commit real API keys or customer payloads.
- Use placeholder values in client configs and examples.
- Auto-minted trial credentials are cached locally with file permissions0600.
- UseSENTINEL_CREDENTIALS_PATH=/tmp/...for ephemeral environments if you do not want a persistent cache.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Manage your pickaxe.co AI agents, knowledge bases, users, and analytics directly through natural language.

Automates marketing operations with AI-powered optimization, real-time analytics, and multi-platform integration.

Stubble learns how you work and organizes your day automatically. Export timesheets, surface insights, and supercharge your AI tools.

What Shopify did for ecommerce, Chipp does for AI agents. Build, deploy, and monetize AI agents for your business — no engineering team required.

CodeVF MCP lets AI hand off problems to real engineers instantly, so your workflows don’t stall when models hit their limits.

Require a named human's offline-verifiable approval before an AI agent takes an irreversible action — payment release, record change, deploy. Two-person rule, Ed25519 Trust Receipts, IETF-drafted, Apache-2.0.

Client implementation for Mastra, providing seamless integration with MCP-compatible AI models and tools.

Equip AI agents with evaluation and self-improvement capabilities with Root Signals.

Skene is a codebase analysis toolkit for product-led growth. It scan your codebase, detect growth opportunities, and generate actionable implementation plans.

Agent-native developer Q&A API with MCP + A2A endpoints for citations, job pickup, and answer submission.