Skip to content

Add Server Instructions blog post and update clients table#1482

Merged
olaservo merged 35 commits intomodelcontextprotocol:mainfrom
olaservo:add-server-instructions-post-v2
Nov 4, 2025
Merged

Add Server Instructions blog post and update clients table#1482
olaservo merged 35 commits intomodelcontextprotocol:mainfrom
olaservo:add-server-instructions-post-v2

Conversation

@olaservo
Copy link
Copy Markdown
Member

@olaservo olaservo commented Sep 16, 2025

Motivation and Context

More clients are starting to add support for this feature, and it relates to a lot of use cases I've seen discussed. A few of them are here, but its not totally exhaustive.

Note: original PR is here: #1334

How Has This Been Tested?

Here is the related GitHub server PR with more details on testing: github/github-mcp-server#1091

Breaking Changes

N/A

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

Also added Instructions to the Clients feature support matrix with 5 clients listed as supporting so far.

@olaservo olaservo changed the title Add Server Instructions blog post Add Server Instructions blog post and update clients table Sep 16, 2025
@dsp-ant dsp-ant added the blog label Sep 19, 2025
@olaservo olaservo requested review from dend and dsp-ant September 19, 2025 13:56
@olaservo
Copy link
Copy Markdown
Member Author

Fyi, I'll wait to resolve the Clients page conflicts again until we know we're closer to merging.

@olaservo olaservo requested a review from a team October 27, 2025 01:18
@olaservo olaservo force-pushed the add-server-instructions-post-v2 branch from 09766c4 to 33378ec Compare October 29, 2025 03:56
olaservo and others added 5 commits October 28, 2025 21:01
- Added Chatbox and ChatFrame clients with Instructions column
- Added VT Code client with Instructions column
- Updated Amp: Prompts support changed from ❌ to ✅
- Updated AIQL TUUI: Elicitation support changed from ❓ to ✅
- Updated Langflow URL to new organization (langflow-ai)
- Preserved Instructions column from add-server-instructions-post-v2 branch
During the merge conflict resolution, these clients were accidentally removed:
- ECA
- Jenova
- JetBrains Junie
- LM-Kit.NET
- MCP Bundler for MacOS
- MCPJam
- Mistral AI: Le Chat
- Needle
- Simtheory
- Smithery Playground
- Swarms

All clients have been re-added in alphabetical order with the Instructions
column (set to ❓ for unknown support status, matching the pattern for other
clients where support is not yet documented).
| Model | With Instructions | Without Instructions | Improvement |
| ------------------- | ----------------- | -------------------- | ----------- |
| **GPT-5-Mini** | 8/10 (80%) | 2/10 (20%) | **+60%** |
| **Claude Sonnet-4** | 9/10 (90%) | 10/10 (100%) | N/A |
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

aeh..wat?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Yes I was thinking it was probably random chance that Claude only got 9/10 with instructions in this example, while the other model significantly improved. Would be curious to try a larger sample size to see if it was a consistent pattern.

dsp-ant
dsp-ant previously approved these changes Oct 30, 2025
Copy link
Copy Markdown
Member

@dsp-ant dsp-ant left a comment

Choose a reason for hiding this comment

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

LGTM! Thank you!

olaservo and others added 2 commits November 2, 2025 21:14
- Updated publish date from September 22 to November 3, 2025
- Renamed file to match new publish date

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
- Added Avatar Shell section back to client details
- Added Avatar Shell link reference

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
localden
localden previously approved these changes Nov 3, 2025
Allow core maintainers to approve general documentation changes,
not just specification docs. This gives core maintainers broader
authority over all documentation.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
@olaservo olaservo merged commit 6163a0b into modelcontextprotocol:main Nov 4, 2025
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants