Skip to main content

Laravel MCP Companion

GitHub release (latest by date) Python Version License Docker Image GitHub Stars

Every Laravel version, the whole ecosystem, fully local.

Laravel MCP Companion is an MCP server that keeps Laravel's documentation on your machine and lets an AI assistant search and read it. It holds the framework docs for every version from 6.x to the newest, the first-party services, and widely used packages. No documentation is fetched while you work, so it answers without a network connection.

Status: pre-1.0. The tools listed below, with their arguments and results, are the ones 1.0 will promise not to break. Upgrading from 0.14 or earlier? See MIGRATING.md.

What it is for

  • Every version, side by side. Laravel 6.x through 13.x are all held. Ask about the version an older application runs on, or compare two versions to see what an upgrade brings.
  • Fully local. The documentation ships inside the Docker image and the Python package. Your questions go nowhere but your assistant, and no documentation service is called, so it works offline and behind an air gap. Documentation is fetched only when you ask for an update. The one other request is at startup: if its list of Laravel versions is more than a day old, the server asks GitHub for it, and carries on with the list it has when there is no answer.
  • It needs no project. It works in a chat client with no code open.

Laravel Boost is the first-party tool for writing code inside a Laravel project: it is installed into the application and knows what the application uses. Use Boost while building. Use Companion to look something up in any Laravel version, in a client with no project open, or where the documentation has to stay on the machine.

Documentation held

  • The framework documentation for Laravel 6.x through 13.x.
  • First-party services: Forge, Vapor, Envoyer, Nova, Cloud, Nightwatch and Herd.
  • Package documentation: Livewire, Filament, Inertia, and Spatie's Permission, Media Library and Backup, each for the package's current major version, and the smaller docs of Debugbar and IDE Helper.
  • Learning material: the courses at laravel.com/learn and an index of Laracasts topics.
  • A package catalog. Separate from the documentation above: a hand-written list of 42 curated packages, saying what each is for, how to install it, what goes with it, and which ones have been superseded.

The project refetches the documentation every night and publishes it; Keeping the documentation current says how it reaches you. The catalog is revised by hand. Ask your assistant how current its documentation is, or call laravel_docs_info, to see the date and page count of every source.

Installation

The server runs as a Docker image, so Docker has to be installed and running. It is also in the official MCP Registry as io.github.brianirish/laravel-mcp-companion.

Claude Code:

claude mcp add laravel-mcp-companion -- docker run --rm -i ghcr.io/brianirish/laravel-mcp-companion:latest

Claude Desktop, and most other MCP clients: add this to the client's MCP configuration (Settings → Developer → Edit Config in Claude Desktop), then restart it:

{
  "mcpServers": {
    "laravel-mcp-companion": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/brianirish/laravel-mcp-companion:latest"]
    }
  }
}

Without Docker: the project is also a Python package (3.12 or newer) with the documentation bundled. It is not on PyPI yet, so install it from the repository with uvx or pip:

uvx --from git+https://github.com/brianirish/laravel-mcp-companion laravel-mcp-companion

Then ask your assistant "how current are your Laravel docs?". It should answer with a date and a list of sources.

Features (v0.15.1)

Twelve tools. API.md documents every argument and result field.

Tool What it does
search_laravel_docs Ranked search over everything held; returns sections, each with a snippet
read_laravel_doc_section Reads one section of a page
read_laravel_doc_content Reads a whole page, or lists its headings
list_laravel_docs Lists what is held, or the files of one collection
laravel_docs_info Reports how current every source is
compare_laravel_versions Lists the pages one Laravel version has and another lacks
update_laravel_docs Fetches newer documentation
get_laravel_package Looks up a package, or a category, in the catalog
recommend_laravel_packages Suggests packages for a described need
get_laravel_service_info Describes a first-party service and what is held for it
get_laravel_learning_path Returns a reading order for a goal (experimental)
browse_docs_by_category Lists pages by topic and difficulty (experimental)
  • Ranked sections, not files. Ask in plain language ("how do I retry a failed queue job") and get the sections that answer it. A section is usually a few hundred tokens where the whole page is tens of thousands.
  • Unified search - One search covers the core framework docs, the services, the package docs and the learning resources, and labels each result with its source. sources narrows it.
  • Results a program can use. Every tool returns a JSON object matching a declared schema, as well as text for the model. A failure is an error with a code to branch on.
  • A stable surface. The tools are recorded in a contract file that a test enforces. VERSIONING.md says what 1.0 will promise; the two tools marked experimental are outside it.

By default a client is shown four tools, not twelve: the first two above, and two helpers that find and run the rest. That keeps tool descriptions out of the model's context. --transform-mode none lists all twelve; see Tool listing modes.

Keeping the documentation current

The project refetches every source each night and publishes a new image. To get it:

docker pull ghcr.io/brianirish/laravel-mcp-companion:latest

Or ask your assistant to update its Laravel docs, and it will fetch them itself. OPERATIONS.md covers image tags, keeping fetched documentation in a Docker volume, and where a pip or uvx install stores it.

More

OPERATIONS.md Every option, tool listing modes, running over HTTP with authentication and rate limiting, health and metrics, the output format
API.md Every tool, argument, result field and error code
MIGRATING.md Upgrading from 0.14 or earlier
VERSIONING.md What a version number promises
ROADMAP.md What is left before 1.0
CONTRIBUTING.md Development setup and tests
SECURITY.md Reporting a vulnerability

License

MIT. See LICENSE.

Acknowledgements

  • Laravel for their excellent documentation
  • Laravel package authors for their contributions to the ecosystem

Metadata

Release files for laravel-mcp-companion 0.15.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for laravel-mcp-companion 0.15.1
File Size Uploaded Provenance Actions
laravel_mcp_companion-0.15.1.tar.gz 6.7 MB With provenance Details for laravel_mcp_companion-0.15.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for laravel-mcp-companion 0.15.1
File Interpreter ABI Platform Actions
laravel_mcp_companion-0.15.1-py3-none-any.whl Python 3 none any Details for laravel_mcp_companion-0.15.1-py3-none-any.whl

Total release size: 14.6 MB

Release files / laravel_mcp_companion-0.15.1.tar.gz

Download URL laravel_mcp_companion-0.15.1.tar.gz
Size 6.7 MB
Tags Source
SHA-256 checksum
How to use checksums
b3c21503a90745e8c2bb1a24b8fb331b77296b4e0f91a156012cdcedb56d934b
BLAKE2b-256 checksum
How to use checksums
dd43f537b5e7e215c8ebe85c972ab2d7f54cce632924637573fd17e17896ce06
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / laravel_mcp_companion-0.15.1-py3-none-any.whl

Download URL laravel_mcp_companion-0.15.1-py3-none-any.whl
Size 7.9 MB
Tags Python 3
SHA-256 checksum
How to use checksums
f814ca466dc6daa9afe0869fe2b1b76b0e04d92cdf4a7bea5272940589a07f85
BLAKE2b-256 checksum
How to use checksums
72d394a68ceeb528df11c16d2014a4aeb51c0239f12dfecd7972ff09cb9e371c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Security for laravel-mcp-companion 0.15.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for laravel_mcp_companion-0.15.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page