CredentialWatch Alert MCP Server

Agent-ready Gradio Space that exposes healthcare credential alerts tools (log, view, resolve) over Model Context Protocol (MCP).

This repository is designed to run as a Gradio Space.

• SDK: Gradio (sdk: gradio in the README header)
• Entry file: app.py (set via app_file in the YAML header)
• Python: 3.11 (pinned with python_version)

When you push this repo to a Space with SDK = Gradio, the UI and the MCP server will be started automatically.

This Space exposes its tools via Model Context Protocol (MCP) using Gradio.

In app.py we:

• initialize the database
• launch the app with MCP support: demo.launch(mcp_server=True)

When the Space is running, Gradio exposes:

• MCP SSE endpoint: https://<space-host>/gradio_api/mcp/sse
• MCP schema: https://<space-host>/gradio_api/mcp/schema

1. Go to your HF MCP settings: https://huggingface.co/settings/mcp
2. Add this Space under Spaces Tools (look for the MCP badge on the Space).
3. Restart your MCP client (VS Code, Cursor, Claude Code, etc.).
4. The tools from this Space will appear as MCP tools and can be called directly.

If your MCP client uses a JSON config, you can point it to the SSE endpoint via mcp-remote:

{
  "mcpServers": {
    "credentialwatch-alert": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://<space-host>/gradio_api/mcp/sse"
      ]
    }
  }
}

Replace <space-host> with the full URL of your Space.

# 1. Install deps
uv pip install -r requirements.txt

# 2. Run locally
uv run python app.py

The local server will be available at http://127.0.0.1:7860, and MCP at http://127.0.0.1:7860/gradio_api/mcp/sse.

1. Create a new Space with SDK = Gradio.
2. Push this repo to the Space (Git or huggingface_hub).
3. Ensure the YAML header in README.md is present and correct.
4. Wait for the Space to build and start — it should show an MCP badge automatically.

• If the Space shows Configuration error, verify sdk, app_file, and python_version in the YAML header.
• If the MCP badge doesn't appear, confirm demo.launch(mcp_server=True) is called in app.py.
• Ensure README.md is at the root and not tracked by LFS.

CredentialWatch is a demo product for the Hugging Face "MCP 1st Birthday / Gradio Agents Hackathon". It is designed to act as a unified, queryable view of provider credentials and a proactive alerting system.

• Log Alert: Create new alerts with severity levels (info, warning, critical).
• View Alerts: Query open alerts, filtered by provider or severity.
• Resolve Alert: Mark alerts as resolved with a note.
• Summarize: Get a breakdown of alerts by severity.
• MCP Support: Exposes these functions as MCP tools for agents to use.

.
├── app.py                  # Entry point for HF Spaces
├── requirements.txt        # Dependencies
├── src/
│   ├── alert_mcp/          # Backend logic & DB Models
│   └── alert_mcp_server/   # Gradio UI & Tool Wrappers
└── ...