Download the PHP package prism-php/relay without Composer

On this page you can find all versions of the php package prism-php/relay. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of prism-php/relay

Informations about the package relay

Total Downloads Latest Stable Version License

Relay

A seamless integration between Prism and Model Context Protocol (MCP) servers that empowers your AI applications with powerful, external tool capabilities.

Installation

You can install the package via Composer:

After installation, publish the configuration file:

Configuration

The published config file (config/relay.php) is where you'll define your MCP server connections.

Configuring Servers

You must define each MCP server explicitly in the config file. Each server needs a unique name and the appropriate configuration parameters:

Basic Usage

Here's how you can integrate MCP tools into your Prism agent:

The agent can now use any tools provided by the Puppeteer MCP server, such as navigating to webpages, taking screenshots, clicking buttons, and more.

Real-World Example

Here's a practical example of creating a Laravel command that uses MCP tools with Prism:

This command creates an interactive CLI that lets you input prompts that will be sent to Claude. The agent can use Puppeteer tools to browse the web, complete tasks, and return the results.

Transport Types

Relay supports multiple transport mechanisms:

HTTP Transport

For MCP servers that communicate over HTTP:

OAuth / Bearer Token Authentication

The MCP 2025-11-25 authorization spec defines an OAuth 2.1 flow for HTTP-based transports. Relay handles only the last step — attaching the token to every request. Your application is responsible for running the full OAuth flow and supplying the resulting access token at runtime.

What your application must handle

Before calling withToken(), your code must:

  1. Discover the authorization server — make an unauthenticated request to the MCP server and read the WWW-Authenticate header from the 401 response, or probe /.well-known/oauth-protected-resource. The response contains the authorization server URL.
  2. Run the OAuth 2.1 authorization code flow — including PKCE (S256 code challenge is required by the spec) and the resource parameter (RFC 8707) identifying the MCP server.
  3. Exchange the code for a token and store/refresh it as needed. Tokens are short-lived; implement refresh token rotation.

[!NOTE] The spec covers this in detail: MCP Authorization — 2025-11-25.

Passing the token to Relay

Once you have a valid Bearer token, pass it to Relay at request time. The runtime token takes priority over any static api_key set in config.

When the MCP server rejects the token with HTTP 401, Relay throws AuthorizationException. Use this to trigger a re-authorization flow in your app:

[!NOTE] OAuth tokens are only supported with HTTP transport. Passing a token to a Stdio-configured server throws a ServerConfigurationException. For Stdio servers, provide credentials via the env config key instead.

STDIO Transport

For locally running MCP servers that communicate via standard I/O:

[!NOTE] The STDIO transport launches a subprocess and communicates with it through standard input/output. This is perfect for running tools directly on your application server.

[!TIP] The env option allows you to pass environment variables to the MCP server process. This is useful for configuring server behavior, enabling debugging, or setting authentication details.

Advanced Usage

Using Multiple MCP Servers

You can combine tools from multiple MCP servers in a single Prism agent:

Error Handling

The package uses specific exception types for better error handling:

License

The MIT License (MIT). Please see the License File for more information.

All versions of relay with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
prism-php/prism Version >=0.93 ^0
laravel/framework Version ^11.0|^12.0|^13.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package prism-php/relay contains the following files

Loading the files please wait ...