Add Agent Skills index + correct MCP discovery metadata

[elkimek]

Summary

Adds the Agent Skills discovery check from isitagentready.com, and corrects the MCP server card after an end-to-end audit against the getbased-agents monorepo source (getbased-mcp v0.2.5).

New

• .well-known/agent-skills/index.json — discovery index per the Agent Skills Discovery RFC v0.2.0: $schema + a skills array with name, type, description, url, digest (sha256).
• .well-known/agent-skills/getbased-health-data/SKILL.md — one real skill teaching an agent how to connect to and responsibly query a user's getbased health data via the getbased-mcp server.

Corrected (.well-known/mcp.json, shipped in #4)

Audited against getbased-agents/packages/mcp/getbased_mcp.py v0.2.5:

• Added getbased_wearables_series — the server exposes 9 tools, the card listed 8.
• License GPL-3.0-only → AGPL-3.0-or-later (matches pyproject.toml).
• Version 0.2.0 → 0.2.5.

Verified correct

• Install (pip install getbased-mcp), console command (getbased-mcp), bundle (getbased-agent-stack) — all match pyproject.toml.
• Auth env GETBASED_TOKEN, gateway default https://sync.getbased.health — match source.
• Tool names + behavior, Settings > Data > Messenger Access, docs URL — match the monorepo README and source.

Test plan

• curl https://getbased.health/.well-known/agent-skills/index.json returns valid JSON
• sha256sum of the served SKILL.md matches the digest in index.json
• curl https://getbased.health/.well-known/mcp.json lists 9 tools and AGPL-3.0-or-later
• Re-scan on isitagentready.com shows Agent Skills index passing

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
get-based-site	Ready	Preview, Comment	May 14, 2026 11:11am

[greptile-apps]

Greptile Summary

This PR adds the Agent Skills discovery index for getbased.health, satisfying the Agent Skills check on isitagentready.com. It also updates mcp.json with a version bump, a license correction, and a new wearables tool.

• .well-known/agent-skills/index.json — new discovery index per RFC v0.2.0 with one skill-md entry; the sha256 digest was independently verified to match the committed SKILL.md exactly.
• .well-known/agent-skills/getbased-health-data/SKILL.md — new skill document covering setup, tool inventory, and clinical-responsibility guardrails; tool list is consistent with mcp.json.
• .well-known/mcp.json — version bumped to 0.2.5, license updated to AGPL-3.0-or-later, and getbased_wearables_series added to the tool array.

Confidence Score: 5/5

Safe to merge — adds static discovery files and a metadata update with no logic changes.

All three files are static content (JSON discovery index, Markdown skill document, JSON MCP card). The SHA256 digest in index.json was independently verified against the committed SKILL.md and matches exactly. The tool inventory in SKILL.md is consistent with mcp.json. No executable code, authentication paths, or data-handling logic is touched.

No files require special attention.

Important Files Changed

Filename	Overview
.well-known/agent-skills/index.json	New Agent Skills discovery index; SHA256 digest verified to match the actual SKILL.md contents.
.well-known/agent-skills/getbased-health-data/SKILL.md	New skill document; tool table is consistent with the tool list in mcp.json; responsible-use guardrails are present.
.well-known/mcp.json	Version bumped to 0.2.5, license updated to AGPL-3.0-or-later, and getbased_wearables_series tool added — all consistent with SKILL.md.

Sequence Diagram

sequenceDiagram
    participant Agent
    participant Site as getbased.health
    participant MCP as getbased-mcp (local)

    Agent->>Site: GET /.well-known/agent-skills/index.json
    Site-->>Agent: skills array (name, type, url, digest)

    Agent->>Site: GET /.well-known/agent-skills/getbased-health-data/SKILL.md
    Site-->>Agent: Skill instructions (setup, tools, guardrails)

    Agent->>Agent: Verify sha256 digest of SKILL.md

    Note over Agent,MCP: User has already installed getbased-mcp locally and set GETBASED_TOKEN env var

    Agent->>MCP: getbased_section() — discover available sections
    MCP-->>Agent: section index

    Agent->>MCP: getbased_lab_context / getbased_section / getbased_wearables_series
    MCP-->>Agent: read-only health context (no raw data)

    Agent->>Agent: Reason over user health data with guardrails

Loading

_{Reviews (2): Last reviewed commit: "Correct MCP metadata against getbased-mc..." | Re-trigger Greptile}