Title: feat: Add support for Completions Metadata by kentcdodds · Pull Request #589 · modelcontextprotocol/modelcontextprotocol · GitHub
Open Graph Title: feat: Add support for Completions Metadata by kentcdodds · Pull Request #589 · modelcontextprotocol/modelcontextprotocol
X Title: feat: Add support for Completions Metadata by kentcdodds · Pull Request #589 · modelcontextprotocol/modelcontextprotocol
Description: This adds (non-breaking) support for title and description in the completions server response which clients can use to display something different for a value than the value itself. SEP: #1440 Motivation and Context @connor4312 demonstrates the need for this in a real world setting today: The user experience could be much better if they could provide display values. Here's another example from a Journaling server I run (screenshot from MCP Inspector): This is the best they can do. Users have to just know what ID they want. Would be better if I could display the journal entry title and the date in parentheses. With this setup, the user would naturally type the title rather than the ID and the server could filter based on the title (or any other field) instead of just the ID. How Has This Been Tested? No, but it's a common pattern in many libraries with UX experiences like this. Breaking Changes I'm not a huge fan of having two ways to do this, but for simple use cases, it's much better to just use an array of strings so there's a good argument to support both an array of value/displayValue objects as well as an array of strings. If we do go this direction, then there is no breaking change here. Types of changes Bug fix (non-breaking change which fixes an issue) New feature (non-breaking change which adds functionality) Breaking change (fix or feature that would cause existing functionality to change) Documentation update Checklist I have read the MCP Documentation My code follows the repository's style guidelines New and existing tests pass locally I have added appropriate error handling I have added or updated documentation as needed Additional context Closes #585
Open Graph Description: This adds (non-breaking) support for title and description in the completions server response which clients can use to display something different for a value than the value itself. SEP: #1440 Moti...
X Description: This adds (non-breaking) support for title and description in the completions server response which clients can use to display something different for a value than the value itself. SEP: #1440 Moti...
Opengraph URL: https://github.com/modelcontextprotocol/modelcontextprotocol/pull/589
X: @github
Domain: github.com
| route-pattern | /:user_id/:repository/pull/:id/files(.:format) |
| route-controller | pull_requests |
| route-action | files |
| fetch-nonce | v2:7d9872e6-c85e-4a61-b8cc-7ec3c2af0f77 |
| current-catalog-service-hash | ae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b |
| request-id | D778:355826:29012DD:3557AF6:6A5CBD17 |
| html-safe-nonce | 6478e01d68dbe326aaba06fbfc5d37388a4c826aa8060200d56162f35f52195c |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJENzc4OjM1NTgyNjoyOTAxMkREOjM1NTdBRjY6NkE1Q0JEMTciLCJ2aXNpdG9yX2lkIjoiMjk0NDA5NDE5MDc3Mzc3OTczNSIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | 31408525d5a5fef2fb7e6164422e69dcf775feb15bdce651d53f34061e1b56e0 |
| hovercard-subject-tag | pull_request:2550327896 |
| github-keyboard-shortcuts | repository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/modelcontextprotocol/modelcontextprotocol/pull/589/files |
| twitter:image | https://avatars.githubusercontent.com/u/1500684?s=400&v=4 |
| twitter:card | summary_large_image |
| og:image | https://avatars.githubusercontent.com/u/1500684?s=400&v=4 |
| og:image:alt | This adds (non-breaking) support for title and description in the completions server response which clients can use to display something different for a value than the value itself. SEP: #1440 Moti... |
| og:site_name | GitHub |
| og:type | object |
| hostname | github.com |
| expected-hostname | github.com |
| None | 5290d7e14309ad1e76106a9c4237bd1041517e83ea182c8ab756752cb0c6940b |
| turbo-cache-control | no-preview |
| diff-view | unified |
| go-import | github.com/modelcontextprotocol/modelcontextprotocol git https://github.com/modelcontextprotocol/modelcontextprotocol.git |
| octolytics-dimension-user_id | 182288589 |
| octolytics-dimension-user_login | modelcontextprotocol |
| octolytics-dimension-repository_id | 862570523 |
| octolytics-dimension-repository_nwo | modelcontextprotocol/modelcontextprotocol |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 862570523 |
| octolytics-dimension-repository_network_root_nwo | modelcontextprotocol/modelcontextprotocol |
| turbo-body-classes | logged-out env-production page-responsive full-width |
| disable-turbo | true |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 9c975978430e9ad293956f2bbdaf153b1bd84a99 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width