# PHP and WordPress docs

> Current PHP and WordPress pages, plus an error lookup and upgrade breaks.

- name: io.github.ladanyin/php-docs
- version: 1.0.1
- connection class: R1 (autonomous)
- trust: 93/100 flags: duplicate-repo
- quality: 85/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.ladanyin%2Fphp-docs
- tools: https://api.protogrid.dev/v1/servers/io.github.ladanyin%2Fphp-docs/tools

**An agent can connect on its own if it already holds `X_API_KEY`, `X_API_KEY`.** Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "php-docs": {
      "type": "http",
      "url": "https://php.bestsmartgoods.com/mcp",
      "headers": {
        "X-API-Key": "${X_API_KEY}",
        "Authorization": "${X_API_KEY}"
      }
    }
  }
}
```

Placeholders to fill: `${X_API_KEY}`, `${X_API_KEY}`.

## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-100% +updated-3d-ago -duplicate-repo(8 names)
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 85/100 (new)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 93 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 1 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 3 of 3 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 1,032 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool history recorded for 2 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 3, about 1,032 tokens to load them all
- tool set hash: 97bfe8c0ba2326dcf0bcde2985004f52
- tools last changed: 2026-11-05T05:42:15.141Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.ladanyin/php-docs.svg)](https://protogrid.dev/servers/io.github.ladanyin/php-docs)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-11-05 `check_php_upgrade` added
  - Check which of the given PHP symbols are linked from the official php.net migration pages between two minor versions. Returns each hit with kind incompatible or deprecated, the version, and the page URL. A symbol that is absent was not named on those pages, which is not proof the code is safe. Send from, to, and symbols, or code instead of symbols. The span can cover at most 8 minor versions. An empty breaks list is still a successful, charged check when the pages were read. The first 5 successful calls each UTC day from one network address are free and need no key. A not_found, bad_range, or fetch_failed is not charged and does not use a free call. After the 5, send X-API-Key. A key call costs 0.04 credit only on success. Key: https://firm.bestsmartgoods.com/signup
- 2026-11-05 `explain_php_error` added
  - Turn one PHP error message into the current English manual page for the function or method it names. Returns the manual URL, version line, signature, description, and first example. Use it when the agent has the error text. A message that names no function returns not_found. The first 5 successful calls each UTC day from one network address are free and need no key. A not_found, bad_range, or fetch_failed is not charged and does not use a free call. After the 5, send X-API-Key. A key call costs 0.04 credit only on success. Key: https://firm.bestsmartgoods.com/signup
- 2026-11-04 `query_php_docs` changed (description, outputSchema)
  - before: Read one current English manual page for a PHP symbol or a WordPress function, hook, or class. Returns the official page URL, the version line, the signature, the description, and the first official example. php.net pages are the live English HTML manual. WordPress pages are the live developer.wordpress.org reference. This is not an archive of older manuals and it does not search Laravel, Symfony, or Markdown docs. Costs 0.04 credit only when a page is returned. A missing API key, not_found, and fetch_failed are not charged. Pass the symbol, for example str_contains or wp_insert_post. Set source to php or wordpress, or omit it and a wp_ name uses WordPress. Set version, for example 8.3 or 6.7, to learn whether that release is covered by the page version line. version_applies is null when version is omitted or the page has no version line. User comments are not included. Key: https://firm.bestsmartgoods.com/signup
  - after: Read one current English manual page for a PHP symbol or a WordPress function, hook, or class. Returns the official page URL, the version line, the signature, the description, and the first official example. php.net pages are the live English HTML manual. WordPress pages are the live developer.wordpress.org reference. This is not an archive of older manuals and it does not search Laravel, Symfony, or Markdown docs. The first 5 successful pages each UTC day from one network address are free and need no API key. A not_found or fetch_failed does not use a free page. After the 5, send header X-API-Key. A key call costs 0.04 credit only when a page is returned. Pass the symbol, for example str_contains or wp_insert_post. Set source to php or wordpress, or omit it and a wp_ name uses WordPress. Set version, for example 8.3 or 6.7, to learn whether that release is covered by the page version line. version_applies is null when version is omitted or the page has no version line. User comments are not included. Key: https://firm.bestsmartgoods.com/signup

Full history: https://api.protogrid.dev/v1/servers/io.github.ladanyin%2Fphp-docs/changes

## Remotes

- https://php.bestsmartgoods.com/mcp (streamable-http, auth api_key ${X_API_KEY}, reachable true, uptime30d 1)

## Packages

_none_

## Tools (3)

- `check_php_upgrade`: Check which of the given PHP symbols are linked from the official php.net migration pages between two minor versions. Returns each hit with kind incompatible or deprecated, the version, and the page URL. A symbol that is absent was not named on those pages, which is not proof the code is safe. Send from, to, and symbols, or code instead of symbols. The span can cover at most 8 minor versions. An empty breaks list is still a successful, charged check when the pages were read. The first 5 successful calls each UTC day from one network address are free and need no key. A not_found, bad_range, or fetch_failed is not charged and does not use a free call. After the 5, send X-API-Key. A key call costs 0.04 credit only on success. Key: https://firm.bestsmartgoods.com/signup
- `explain_php_error`: Turn one PHP error message into the current English manual page for the function or method it names. Returns the manual URL, version line, signature, description, and first example. Use it when the agent has the error text. A message that names no function returns not_found. The first 5 successful calls each UTC day from one network address are free and need no key. A not_found, bad_range, or fetch_failed is not charged and does not use a free call. After the 5, send X-API-Key. A key call costs 0.04 credit only on success. Key: https://firm.bestsmartgoods.com/signup
- `query_php_docs`: Read one current English manual page for a PHP symbol or a WordPress function, hook, or class. Returns the official page URL, the version line, the signature, the description, and the first official example. php.net pages are the live English HTML manual. WordPress pages are the live developer.wordpress.org reference. This is not an archive of older manuals and it does not search Laravel, Symfony, or Markdown docs. The first 5 successful pages each UTC day from one network address are free and need no API key. A not_found or fetch_failed does not use a free page. After the 5, send header X-API-Key. A key call costs 0.04 credit only when a page is returned. Pass the symbol, for example str_contains or wp_insert_post. Set source to php or wordpress, or omit it and a wp_ name uses WordPress. Set version, for example 8.3 or 6.7, to learn whether that release is covered by the page version line. version_applies is null when version is omitted or the page has no version line. User comments are not included. Key: https://firm.bestsmartgoods.com/signup
