Skip to content

docs(readme): retitle, add capability list and REST-vs-MCP guidance#26

Merged
fedorov merged 2 commits into
mainfrom
docs/readme-capabilities
Jul 14, 2026
Merged

docs(readme): retitle, add capability list and REST-vs-MCP guidance#26
fedorov merged 2 commits into
mainfrom
docs/readme-capabilities

Conversation

@fedorov

@fedorov fedorov commented Jul 14, 2026

Copy link
Copy Markdown
Member

Summary

  • Retitle the README from IDC API to IDC REST API & MCP Server — the old title named only one of the two surfaces and was confusing.
  • Add a What you can do section: a brief, feature-level capability list (discover, build cohorts, retrieve, run SQL, explore clinical data, publish responsibly) with a pointer to the User Guide for the full reference.
  • Add a short REST or MCP? paragraph on when to use which surface: REST when you write the code (scripts/apps/notebooks), MCP when an LLM agent does the querying.
  • Slim the status blockquote so the capability enumeration lives in exactly one place.
  • Point stale repo links at the ImagingDataCommons org: the CI badge (README) and the private vulnerability-report link (SECURITY.md) still used the pre-transfer fedorov/ path.

Docs-only; no user-visible API change, so no CHANGELOG entry per the changelog rule.

🤖 Generated with Claude Code

Retitle the README to name both surfaces ("IDC REST API & MCP Server").
Add a "What you can do" section: a brief feature-level capability list
(discover, cohorts, retrieval, SQL, clinical data, licenses/citations)
plus a short "REST or MCP?" paragraph on when to use which, pointing at
the user guide for the full reference. Slim the status blockquote so the
capability enumeration lives in one place.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 14, 2026 21:42

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the project’s README to more clearly present IDC’s two public query surfaces (REST API and MCP server) and to provide a feature-level capability overview for readers landing on the repository.

Changes:

  • Retitles the README to reflect both the REST API and MCP server surfaces.
  • Adds a “What you can do” capability list and a short “REST or MCP?” usage guide.
  • Simplifies the status blockquote by moving capability enumeration into the new dedicated section.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

The CI badge (README) and the private vulnerability-report link
(SECURITY.md) still pointed at the pre-transfer fedorov/ repo path.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@fedorov
fedorov merged commit fe22693 into main Jul 14, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants