agtp
The AGTP (Agent-to-Agent Transfer Protocol) module brings standardized multi-agent communication to Drupal. As AI architecture evolves beyond isolated chatbots into collaborative networks, this module provides the crucial messaging tier required for cross-platform interoperability—preventing your multi-agent architecture from turning into a chatty, chaotic swarm.
What solution does this module provide? It turns your Drupal site into an active participant in the global AI workforce. By implementing the open AGTP standard (originally introduced by Google and governed by the Linux Foundation), it allows local Drupal processes to discover, authenticate, and exchange structured tasks with remote agents built on entirely different frameworks (such as LangChain, CrewAI, or AutoGen). Instead of operating in a silo, your site can now delegate complex jobs to specialized external agents and safely process incoming automated requests.
Features
Bi-Directional Communication: Acts as both an AGTP Client (initiating outbound requests and delegating tasks to remote agents) and an AGTP Server (exposing a secure inbound endpoint for external agents).
Standardized Envelope Processing: Fully parses core AGTP/A2A fields, utilizing correlation_id to track multi-step conversation threads and telemetry-compatible tracing to stitch complex execution paths together.
Intent-Based Routing: Intelligently maps incoming payload intents directly to Drupal service callbacks, queue workers, or internal AI workflows.
Secure Handshakes: Integrates cryptographic signature verification to ensure incoming agent requests originate exclusively from trusted, authorized peers.
Asynchronous Callbacks: Implements an async-with-callback pattern for long-running reasoning tasks, processing heavy jobs via the Drupal queue without blocking HTTP connections.
Post-Installation
Once installed, the module prepares your site to act as a networked agent node.
Configure the Agent Node: Navigate to /admin/config/services/agtp to set your local Agent identity, metadata, and default endpoint behaviors.
Set Up Keys: Use the configuration interface to assign the cryptographic keys needed to sign outbound messages and verify incoming peer signatures.
Map Intents: Link specific incoming agent intents (e.g., task.delegate or query.knowledge) to local plugins or event subscribers so your site knows exactly how to respond when called upon.
Additional Requirements
Key Module: Required to securely manage the private and public keys used for agent authentication and signature validation.
Recommended modules/libraries
AI Agents (ai_agents): The ideal companion ecosystem. While ai_agents handles local tool-calling and Drupal configuration manipulation, AGTP acts as its passport to talk to external agent swarms.
ECA (Event Condition Action): Combine this with AGTP to visually orchestrate how your site reacts to incoming agent requests without writing custom PHP.
Similar projects
AI Agents: This framework provides an exceptional toolset for building text-to-action configuration agents within Drupal and leverages frameworks like the Model Context Protocol (MCP). While MCP standardizes how an agent talks to its local tools and data sources, AGTP focuses on how an agent talks to another agent across different networks and platforms. They are designed to complement each other beautifully.
Supporting this Module
Contributions, bug reports, and ecosystem feedback are highly welcome! Check the sandbox issue queue to see our current roadmap, or drop into the #ai channel on Drupal Slack to help shape the future of agentic Drupal.
Community Documentation
Look out for upcoming blog posts and video walkthroughs on setting up local multi-agent DDEV environments.
Once the module transitions from a sandbox to a full contributed project, an interactive DrupalPod demo will be available here for one-click testing.