PHP: Symfony

composer require agentcat/sdk

return [
    // ...
    AgentCat\Symfony\AgentCatBundle::class => ['all' => true],
];

AGENTCAT_PROJECT_ID=proj_YOUR_PROJECT_ID

# Default configuration for extension with alias: "agentcat"
agentcat:

    # On or off for every MCP server and every AgentCat call: true or false. Unset: on, except while your tests run.
    enabled:              '%env(default::AGENTCAT_ENABLED)%'

    # Your AgentCat project ID (proj_…). Unset: no events go to AgentCat; exporters still run.
    project_id:           '%env(default::AGENTCAT_PROJECT_ID)%'

    # Servers AgentCat never tracks: names of mcp.servers entries; a string is one name. Names written here are read when the container compiles, names from environment variables when each server is built.
    exclude_servers:      []

    # Another project for some servers: mcp.servers name => project ID. A null project is project_id.
    projects:

        # Prototype
        server:               ~

    # The service ID of a PSR-3 logger for AgentCat's own lines, for example monolog.logger.mcp, written here, not in an environment variable. Unset: their own file, agentcat.log in the log directory.
    logger:               null

    # The AgentCat API. Unset: AgentCat's. MCPCAT_API_URL, the TypeScript SDK's name, is read too.
    api_url:              '%env(default::AGENTCAT_API_URL)%'

    # Adds the get_more_tools tool, so agents can report tools they miss. Default: true. Takes true, false, 1, 0, yes, no, on, off or an %env()% value.
    enable_report_missing: true

    # Publishes one event for every tool call. Default: true. Takes true, false, 1, 0, yes, no, on, off or an %env()% value.
    enable_tracing:       true

    # Adds a context parameter to your tools, so agents explain each call. Default: true. Takes true, false, 1, 0, yes, no, on, off or an %env()% value.
    enable_tool_call_context: true

    # Replaces the default description of the context parameter. Unset: the default description.
    custom_context_description: null

    # Adds an agent_id parameter to your tools, to tell agents apart. Default: false. Takes true, false, 1, 0, yes, no, on, off or an %env()% value.
    enable_agent_tracking: false

    # The service ID of an invokable service, written here, not in an environment variable. The service is resolved when the hook runs.
    identify:             null

    # The service ID of an invokable service, written here, not in an environment variable. The service is resolved when the hook runs.
    resolve_session_id:   null

    # The service ID of an invokable service, written here, not in an environment variable. The service is resolved when the hook runs.
    event_tags:           null

    # The service ID of an invokable service, written here, not in an environment variable. The service is resolved when the hook runs.
    event_properties:     null

    # The service ID of an invokable service, written here, not in an environment variable. The service is resolved when the hook runs.
    redact_sensitive_information: null

    # The service ID of an invokable service, written here, not in an environment variable. The service is resolved when the hook runs.
    redact_event:         null

    # Your own telemetry tools: name => {type: otlp|datadog|sentry|posthog, …}. A ~ entry is skipped.
    exporters:            null

    # Diagnostics: AgentCat's own log lines, sent to AgentCat so that it can find broken installs. true turns them off; in a list, one true value is enough. DISABLE_DIAGNOSTICS, the TypeScript SDK's name, is read too.
    disable_diagnostics:

        # Defaults:
        - %env(default::AGENTCAT_DISABLE_DIAGNOSTICS)%
        - %env(default::DISABLE_DIAGNOSTICS)%

    # Where diagnostics go: an OpenTelemetry collector (OTLP/HTTP logs). Unset: AgentCat's.
    diagnostics_endpoint: '%env(default::AGENTCAT_DIAGNOSTICS_ENDPOINT)%'

    # The bearer token of diagnostics_endpoint. Unset: AgentCat's.
    diagnostics_token:    '%env(default::AGENTCAT_DIAGNOSTICS_TOKEN)%'

    # Keeps AgentCat from installing its SIGTERM and SIGINT handlers in CLI servers. Default: false. Takes true, false, 1, 0, yes, no, on, off or an %env()% value.
    disable_signal_handlers: false

agentcat:
    projects:
        billing: '%env(default::AGENTCAT_BILLING_PROJECT_ID)%'

agentcat:
    exclude_servers: [internal]
    projects:
        billing: '%env(default::AGENTCAT_BILLING_PROJECT_ID)%'

namespace App\Mcp;

use AgentCat\Identity;
use AgentCat\ToolCall;

final class IdentifyActor
{
    public function __invoke(ToolCall $call): ?Identity
    {
        $token = $call->headers['authorization'] ?? null;

        return $token === null ? null : new Identity(userId: hash('sha256', $token));
    }
}

agentcat:
    identify: App\Mcp\IdentifyActor

monolog:
    handlers:
        mcp:
            type: stream
            path: '%kernel.logs_dir%/mcp.log'
            channels: ['mcp']