modelcontextprotocol/php-sdk

View on GitHub

The official PHP SDK for Model Context Protocol servers and clients. Maintained in collaboration with The PHP Foundation.

Stars: 1.6k
Forks: 173
Open beginner issues: 0
Indexed issues: 57
Avg merge: 2d 49m
Merged PRs (30d): 23

Dominant language: PHP
License: No license data
Last GitHub push: Sep 15, 2026
Latest indexed: Sep 20, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: help wanted

Beginner friendly Everything

Open All

57 issues indexed so far

[Server] Decode JSON-RPC objects as stdClass, not associative arrays Open

enhancement

Difficulty 4/5 3-5 days Newbie friendliness 55/100

modelcontextprotocol/php-sdk#510 · 1 comment · Opened Sep 14, 2026
[Client] HttpTransport resumes an Amp-suspended Fiber with a JSON-RPC error Open

bug

Difficulty 4/5 3-5 days Newbie friendliness 45/100

modelcontextprotocol/php-sdk#504 · Opened Sep 9, 2026
[Server] Concurrent requests corrupt the session file in FileSessionStore, crashing Session::readData() with JsonException Open

bug P2 Server

Difficulty 4/5 3-5 days Newbie friendliness 68/100

modelcontextprotocol/php-sdk#498 · 2 comments · Opened Sep 4, 2026
[Server][Capability] Element sources should return values, and RegistryInterface should be sliced by role Open

ADR breaking change needs design Server

Difficulty 5/5 Over a week Newbie friendliness 35/100

modelcontextprotocol/php-sdk#495 · Opened Sep 3, 2026
Slicing the SDK into Multiple Packages Open

needs confirmation needs maintainer action

modelcontextprotocol/php-sdk#489 · 3 comments · 3 reactions · 1 assignee · Opened Aug 29, 2026
One placeholder-less resource template makes the whole server unserviceable Open

Server

Difficulty 3/5 1-2 days Newbie friendliness 72/100

modelcontextprotocol/php-sdk#476 · 3 comments · Opened Aug 23, 2026
[Server] McpResourceTemplate throws 500 error when uriTemplate variable is undefined Open

bug P2 Server

Difficulty 3/5 1-2 days Newbie friendliness 55/100

modelcontextprotocol/php-sdk#469 · 2 comments · 1 reaction · Opened Aug 21, 2026
[Server] Handler type uses bare Closure, hard to decorate RegistryInterface under strict PHPStan Open

Server

Difficulty 1/5 Under an hour Newbie friendliness 78/100

modelcontextprotocol/php-sdk#468 · 2 comments · Opened Aug 20, 2026
StreamableHttpTransport returns a JSON array in the response body when parallel POST requests arrive concurrently (PHP-FPM) Open

bug P1 Server

Difficulty 4/5 3-5 days Newbie friendliness 55/100

modelcontextprotocol/php-sdk#467 · 1 comment · Opened Aug 20, 2026
Builder::build() silently skips configured file-based discovery when symfony/finder is missing — should fail loudly Open

needs confirmation needs maintainer action Server

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

modelcontextprotocol/php-sdk#398 · 1 reaction · Opened Jul 17, 2026
[Client][Auth] SEP-2351: Use RFC 8414 well-known URI suffix for AS metadata discovery Open

2026-07-28 auth Client enhancement improves spec compliance

Difficulty 4/5 3-5 days Newbie friendliness 35/100

modelcontextprotocol/php-sdk#377 · Opened Jun 6, 2026
[Client][Auth] SEP-837: Specify OIDC application_type during Dynamic Client Registration Open

2026-07-28 auth Client enhancement improves spec compliance

Difficulty 4/5 3-5 days Newbie friendliness 35/100

modelcontextprotocol/php-sdk#376 · Opened Jun 6, 2026
[Schema] No support for additonalProperties in tool input schema Open

enhancement

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

modelcontextprotocol/php-sdk#370 · Opened May 31, 2026
[Conformance] SEP-2484: Wire SEP traceability files into conformance test runner; surface per-SEP pass rates Open

2026-07-28 conformance-weekly enhancement improves spec compliance

Difficulty 4/5 3-5 days Newbie friendliness 38/100

modelcontextprotocol/php-sdk#367 · 1 comment · Opened May 26, 2026
[Client][Auth] SEP-2207: Request offline_access scope against OIDC-flavored AS for refresh tokens Open

2026-07-28 auth Client enhancement improves spec compliance

Difficulty 4/5 3-5 days Newbie friendliness 48/100

modelcontextprotocol/php-sdk#363 · Opened May 26, 2026
[Client][Auth] SEP-2352: Key DCR registrations and tokens by AS issuer; reject cross-AS credential reuse Open

2026-07-28 auth Client enhancement improves spec compliance

Difficulty 4/5 3-5 days Newbie friendliness 48/100

modelcontextprotocol/php-sdk#361 · Opened May 26, 2026
[Client][Auth] SEP-2468: Validate iss parameter in authorization response (RFC 9207) Open

2026-07-28 auth Client enhancement improves spec compliance

Difficulty 4/5 3-5 days Newbie friendliness 52/100

modelcontextprotocol/php-sdk#360 · Opened May 26, 2026
[Schema] SEP-2106: Harden SchemaValidator against external $ref SSRF and composition DoS Open

2026-07-28 enhancement improves spec compliance Schema

Difficulty 4/5 3-5 days Newbie friendliness 48/100

modelcontextprotocol/php-sdk#358 · Opened May 26, 2026
[Schema] SEP-2106: Support JSON Schema 2020-12 vocabulary in SchemaGenerator (oneOf/anyOf/allOf/if-then-else/$ref) Open

2026-07-28 enhancement improves spec compliance needs design Schema

Difficulty 5/5 Over a week Newbie friendliness 35/100

modelcontextprotocol/php-sdk#356 · Opened May 26, 2026
[Client] SEP-2663 Tasks: Poll task handles and answer inputRequests Open

2026-07-28 enhancement improves spec compliance Server

Difficulty 4/5 3-5 days Newbie friendliness 55/100

modelcontextprotocol/php-sdk#349 · Opened May 26, 2026
[Server] SEP-2663 Tasks: Handlers return task handles; the application advances the task Open

2026-07-28 enhancement improves spec compliance needs design Server

Difficulty 5/5 Over a week Newbie friendliness 35/100

modelcontextprotocol/php-sdk#348 · Opened May 26, 2026
[Server] SEP-2663 Tasks: TaskStoreInterface with InMemory and PSR-16 stores Open

2026-07-28 enhancement improves spec compliance needs design Server

Difficulty 4/5 3-5 days Newbie friendliness 52/100

modelcontextprotocol/php-sdk#347 · Opened May 26, 2026
[Server] SEP-2663 Tasks: TasksExtension, capability gate, tasks/* handlers Open

2026-07-28 enhancement improves spec compliance needs design Server

Difficulty 4/5 3-5 days Newbie friendliness 55/100

modelcontextprotocol/php-sdk#346 · Opened May 26, 2026
[Schema] SEP-2663 Tasks: Task shape, resultType discriminator, tasks/* request/result types Open

2026-07-28 enhancement improves spec compliance Schema

Difficulty 4/5 3-5 days Newbie friendliness 48/100

modelcontextprotocol/php-sdk#345 · 1 reaction · Opened May 26, 2026
[2026-07-28] Governance: deprecations, lifecycle, conformance, SDK tier Open

2026-07-28 Client documentation enhancement improves spec compliance Server

Difficulty 5/5 Over a week Newbie friendliness 25/100

modelcontextprotocol/php-sdk#339 · Opened May 26, 2026
[2026-07-28] Authorization hardening (OAuth/OIDC) Open

2026-07-28 auth Client enhancement improves spec compliance Server

Difficulty 5/5 Over a week Newbie friendliness 25/100

modelcontextprotocol/php-sdk#338 · 1 reaction · Opened May 26, 2026
[2026-07-28] Schema modernization & error code standardization Open

2026-07-28 enhancement improves spec compliance Schema

Difficulty 5/5 Over a week Newbie friendliness 35/100

modelcontextprotocol/php-sdk#337 · Opened May 26, 2026
[2026-07-28] Transport & observability headers/metadata Open

2026-07-28 Client enhancement improves spec compliance Schema Server

Difficulty 4/5 3-5 days Newbie friendliness 35/100

modelcontextprotocol/php-sdk#336 · Opened May 26, 2026
[2026-07-28] Extensions framework + Tasks + MCP Apps Open

2026-07-28 Client enhancement improves spec compliance needs design Schema Server

Difficulty 5/5 Over a week Newbie friendliness 28/100

modelcontextprotocol/php-sdk#335 · Opened May 26, 2026
[Client] Print contents of stderr when command in StdioTransport fails to start Open

enhancement

Difficulty 3/5 1-2 days Newbie friendliness 58/100

modelcontextprotocol/php-sdk#332 · 2 comments · Opened May 26, 2026
[Client] Extend conformance client.php with scenario context env vars Open

auth Client enhancement

Difficulty 3/5 1-2 days Newbie friendliness 72/100

modelcontextprotocol/php-sdk#329 · Opened May 19, 2026
[Client] Fill elicitation defaults when accepting (SEP-1034) Open

Client enhancement improves spec compliance Schema

Difficulty 3/5 1-2 days Newbie friendliness 72/100

modelcontextprotocol/php-sdk#328 · Opened May 19, 2026
[Client] Implement SSE reconnect with Last-Event-ID Open

Client enhancement improves spec compliance

Difficulty 4/5 3-5 days Newbie friendliness 66/100

modelcontextprotocol/php-sdk#327 · Opened May 19, 2026
[Client] Add OAuth 2025-03-26 metadata backcompat fallback Open

auth Client enhancement improves spec compliance

Difficulty 4/5 3-5 days Newbie friendliness 52/100

modelcontextprotocol/php-sdk#326 · Opened May 19, 2026
[Client] Implement Cross-App Access (token exchange, RFC 8693) Open

auth Client enhancement improves spec compliance

Difficulty 4/5 3-5 days Newbie friendliness 45/100

modelcontextprotocol/php-sdk#325 · Opened May 19, 2026
[Client] Implement client_credentials grant (client_secret_basic + private_key_jwt) Open

auth Client enhancement improves spec compliance

Difficulty 4/5 3-5 days Newbie friendliness 48/100

modelcontextprotocol/php-sdk#324 · Opened May 19, 2026
[Client] Implement refresh_token grant + offline_access scope Open

auth Client enhancement improves spec compliance

Difficulty 4/5 3-5 days Newbie friendliness 48/100

modelcontextprotocol/php-sdk#323 · 1 comment · Opened May 19, 2026
[Client] Implement OAuth scope handling (WWW-Authenticate, scopes_supported, step-up, retry-limit, omitted) Open

auth Client enhancement improves spec compliance

Difficulty 4/5 3-5 days Newbie friendliness 48/100

modelcontextprotocol/php-sdk#322 · 1 comment · Opened May 19, 2026
[Client] Support token_endpoint_auth_method: client_secret_basic, client_secret_post, none Open

auth Client enhancement improves spec compliance

Difficulty 4/5 3-5 days Newbie friendliness 55/100

modelcontextprotocol/php-sdk#321 · 1 comment · Opened May 19, 2026
[Client] Implement Dynamic Client Registration (RFC 7591) + pre-registered client support Open

auth Client enhancement improves spec compliance

Difficulty 4/5 3-5 days Newbie friendliness 52/100

modelcontextprotocol/php-sdk#320 · 1 comment · Opened May 19, 2026
[Client] Implement OAuth 2.0 Authorization Code flow with PKCE (RFC 6749 + RFC 7636) Open

auth Client enhancement improves spec compliance

Difficulty 5/5 Over a week Newbie friendliness 35/100

modelcontextprotocol/php-sdk#319 · 1 comment · Opened May 19, 2026
[Client] Implement Authorization Server Metadata discovery (RFC 8414) Open

auth Client enhancement improves spec compliance

Difficulty 4/5 3-5 days Newbie friendliness 55/100

modelcontextprotocol/php-sdk#318 · 1 comment · Opened May 19, 2026
[Client] Implement Protected Resource Metadata discovery (RFC 9728) Open

auth Client enhancement improves spec compliance

Difficulty 4/5 3-5 days Newbie friendliness 48/100

modelcontextprotocol/php-sdk#317 · Opened May 19, 2026
[Client] Inject Bearer token into HttpTransport requests + handle 401 re-auth Open

auth Client enhancement improves spec compliance

Difficulty 4/5 3-5 days Newbie friendliness 48/100

modelcontextprotocol/php-sdk#316 · Opened May 19, 2026
[Client] Add OAuth 2.0 credential storage interface (TokenStorageInterface) Open

auth Client enhancement improves spec compliance

Difficulty 4/5 3-5 days Newbie friendliness 48/100

modelcontextprotocol/php-sdk#315 · 1 comment · Opened May 19, 2026
Streamable HTTP server does not validate body/header protocol-version consistency on initialize Open

bug

Difficulty 4/5 3-5 days Newbie friendliness 48/100

modelcontextprotocol/php-sdk#309 · Opened May 16, 2026
[Streamable HTTP][Server] GET should open a server→client SSE listener Open

bug

Difficulty 4/5 3-5 days Newbie friendliness 48/100

modelcontextprotocol/php-sdk#291 · 1 comment · Opened Apr 20, 2026
Add server lifecycle events (ServerStarted / ServerStopped) Open

enhancement needs confirmation

Difficulty 4/5 3-5 days Newbie friendliness 52/100

modelcontextprotocol/php-sdk#286 · 2 comments · Opened Apr 16, 2026
[Streamable HTTP][Server] Concurrent requests in the same session can overwrite queued responses and cause stale/unknown message IDs Open

bug

Difficulty 5/5 Over a week Newbie friendliness 35/100

modelcontextprotocol/php-sdk#275 · 4 comments · 1 reaction · Opened Apr 2, 2026
[Docs][Server] Add documentation on how to use webserver Open

documentation Server

Difficulty 3/5 1-2 days Newbie friendliness 45/100

modelcontextprotocol/php-sdk#174 · 1 comment · 2 reactions · Opened Nov 30, 2025

modelcontextprotocol/php-sdk

Get new issues in your inbox