Docs / Features

AnythingLLM Integration

AnythingLLM Integration

Seamlessly integrate your Laravel Mail application with AnythingLLM using the Model Context Protocol (MCP). This allows large language models (LLMs) to interact directly with your application's data—subscribers, campaigns, reports, and more—making your email marketing smarter and more agentic.

Overview

The integration functions as an MCP Server built directly into Laravel Mail. This server exposes specific "tools" that an MCP Client (like AnythingLLM) can call.

  • Protocol: Model Context Protocol (MCP) over Stdio (Standard Input/Output).
  • Capabilities:
    • search_subscribers
    • get_subscriber_details
    • list_campaigns
  • Location: mcp/server.php in your project root.

Configuration

Prerequisites

  1. AnythingLLM Desktop installed and running.
  2. PHP 8.2+ available in your system path (if running locally) or accessible via Docker.
  3. Laravel Mail installed and configured.

Setting up in AnythingLLM

  1. Open AnythingLLM Desktop.
  2. Navigate to Workspace Settings > Agent Capabilities > MCP Servers.
  3. Create a New Connection:
    • Name: LaravelMail (or any name you prefer)
    • Type: Stdio (Standard IO)
    • Command: php (or full path to php executable, e.g., /usr/bin/php)
    • Arguments: /path/to/your/project/mcp/server.php

Note for Docker Users: If AnythingLLM is running outside Docker but your app is inside, you may need to wrap the command. For example, using docker exec to run the script inside your application container: Command: docker Arguments: exec -i app.laravelmail.com php /var/www/mcp/server.php

  1. Click Connect/Save.
  2. Once connected, AnythingLLM will list the available tools (search_subscribers, list_campaigns, etc.).

Available Tools

The following tools are currently exposed by the MCP server:

search_subscribers

Finds subscribers by matching their email or name.

  • Parameters: query (string) - The search term.
  • Returns: A list of matching subscribers (ID, Name, Email).

get_subscriber_details

Retrieves comprehensive details for a specific subscriber.

  • Parameters: email (string) - The subscriber's email address.
  • Returns: Full subscriber object including tags and metadata.

list_campaigns

Fetches a list of the most recent campaigns.

  • Parameters: limit (int, default: 5) - Number of campaigns to return.
  • Returns: List of campaigns (ID, Name, Subject, Status, Created Date).

Technical Details

The MCP Server (mcp/server.php)

The server is a standalone PHP script that bootstraps the Laravel framework to access your models (Subscriber, Campaign, etc.). It listens on STDIN for JSON-RPC requests and writes responses to STDOUT.

// mcp/server.php snippet
while ($line = fgets(STDIN)) {
    $request = json_decode($line, true);
    // ... handles 'tools/list' and 'tools/call' ...
}

Extending the Integration

You can easily add more tools by modifying mcp/server.php.

  1. Define the Tool: Add a new entry to the tools/list response.

    [
    'name' => 'create_campaign',
    'description' => 'Create a new draft campaign',
    'inputSchema' => [ ... ]
]

  2. Handle the Call: Add a case to the tools/call switch statement.

    case 'create_campaign':
    // Your logic to create a campaign using Laravel models
    break;

Usage Example

Once configured in AnythingLLM, you can chat with your agent naturally:

User: "Who are the last 5 subscribers matching 'john'?"

Agent (Using search_subscribers): "Here are the subscribers I found: John Doe (john@example.com), ..."

User: "What was the status of our last campaign?"

Agent (Using list_campaigns): "The last campaign 'Summer Sale' is currently 'Sent'."