Repository navigation
[Docs] Add AGENTS.md - #634
Merged
Merged
Conversation
chr-hertel
requested review from
CodeWithKyrian,
Nyholm and
soyuka
as code owners
October 27, 2026 21:10
Contributor
There was a problem hiding this comment.
🟡 Changes recommended
AGENTS.md points OAuth work to the wrong namespace and incorrectly claims that supported modern-only result fields are not modeled.
2 open issues
What changed in this PR
Adds repository guidance for AI coding agents working on the PHP MCP SDK. This documentation-only change covers development workflows, architecture, and contribution conventions.
Changes:
- Documents setup, testing, analysis, and documentation commands.
- Maps server, client, and shared protocol components across both protocol eras.
- Defines coding, specification-reference, and review communication guidelines.
| File | Description |
|---|---|
| AGENTS.md | Adds commands, architecture guidance, and contribution conventions for AI coding agents. |
Review effort: Balanced
Clarify the role of codecs in adapting results to wire shapes and handling modern fields. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Clarified OAuth resource-server-only sections in documentation. Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
chr-hertel
added a commit
to BrocksiNet/php-sdk
that referenced
this pull request
Nov 4, 2026
…et/php-sdk into pr-618-end-a-listen-stream-that-can * 'fix/listen-empty-filter' of https://github.com/BrocksiNet/php-sdk: (25 commits) [Server] Pass an explicit null to a nullable tool parameter with a default (modelcontextprotocol#642) [Capability] Check tool names against the spec's 128-character limit and character set (modelcontextprotocol#639) [Tests] Stop php -S servers together with their forked workers (modelcontextprotocol#658) chore(deps): bump astral-sh/setup-uv from 10.3.2 to 10.3.3 (modelcontextprotocol#659) [Server] Accept plain http on `*.localhost` and `127.0.0.0/8` hosts in OAuth URLs (modelcontextprotocol#620) [Capability] Map PHPDoc pseudo-types to the JSON Schema type of their base type (modelcontextprotocol#643) Raise minimum versions of `phpdocumentor/reflection-docblock` and `psr/container` (modelcontextprotocol#657) [Server] Use compact JSON in result formatters (modelcontextprotocol#647) [Server] Filter list completions in one pass (modelcontextprotocol#649) [Server] Fix result lists being sent as JSON objects (modelcontextprotocol#656) Avoid repeated array merges in prompt formatting (modelcontextprotocol#650) [Docs] Add AGENTS.md (modelcontextprotocol#634) Avoid repeated array merges in resource formatting (modelcontextprotocol#651) [Server] Fix `"0"` prefix offering all completions (modelcontextprotocol#655) Filter enum completions in one pass (modelcontextprotocol#652) Paginate registry references before mapping (modelcontextprotocol#653) Extract JWT scopes in one pass (modelcontextprotocol#654) [Server] Fix `Session::save()` wiping a session that the store failed to read (modelcontextprotocol#637) [Server] Answer a DELETE of an unknown or ended session with 404 (modelcontextprotocol#638) [Server] Add `Psr6SessionStore` and `Psr6NotificationBus` (modelcontextprotocol#635) ...
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Add an
AGENTS.mdwith commands, architecture overview and coding conventions for AI coding agents.🤖 Generated with Claude Code