Agent-to-Agent (A2A) server configuration patterns for HTTP, STDIO, SSE, and WebSocket transports. Use when building A2A servers, configuring MCP transports, setting up server endpoints, or when user mentions A2A configuration, server transport, MCP server setup, or agent communication protocols.
This skill is limited to using the following tools:
examples/http-fastapi-example.mdexamples/sse-streaming-example.mdexamples/stdio-simple-example.mdexamples/websocket-bidirectional-example.mdscripts/generate-server.shscripts/test-transport.shscripts/validate-config.shtemplates/python-http-server.pytemplates/python-sse-server.pytemplates/python-stdio-server.pytemplates/python-websocket-server.pytemplates/typescript-http-server.tstemplates/typescript-sse-server.tstemplates/typescript-stdio-server.tstemplates/typescript-websocket-server.tsProvides complete patterns and templates for configuring Agent-to-Agent (A2A) servers with different transport mechanisms (HTTP, STDIO, SSE, WebSocket) following MCP (Model Context Protocol) standards.
CRITICAL: When generating any configuration files or code:
NEVER hardcode actual API keys or secrets
NEVER include real credentials in examples
NEVER commit sensitive values to git
ALWAYS use placeholders: your_service_key_here
ALWAYS create .env.example with placeholders only
ALWAYS add .env* to .gitignore (except .env.example)
ALWAYS read from environment variables in code
ALWAYS document where to obtain keys
Placeholder format: {service}_{env}_your_key_here
Determine server configuration needs:
Transport Type
Framework Detection
Configuration Needs
Based on requirements, use templates from templates/:
Python Templates:
templates/python-http-server.py - FastAPI HTTP servertemplates/python-stdio-server.py - STDIO transporttemplates/python-sse-server.py - SSE streamingtemplates/python-websocket-server.py - WebSocket bidirectionalTypeScript Templates:
templates/typescript-http-server.ts - Express HTTP servertemplates/typescript-stdio-server.ts - STDIO transporttemplates/typescript-sse-server.ts - SSE streamingtemplates/typescript-websocket-server.ts - WebSocket bidirectionalApply configuration based on transport type:
HTTP Configuration:
# Python (FastAPI)
if __name__ == "__main__":
import uvicorn
uvicorn.run(
"main:app",
host="0.0.0.0",
port=8000,
reload=True
)
// TypeScript (Express)
const PORT = process.env.PORT || 8000;
app.listen(PORT, () => {
console.log(`Server running on port ${PORT}`);
});
STDIO Configuration:
# Python
mcp.run(transport="stdio")
// TypeScript
server.connect(new StdioServerTransport());
SSE Configuration:
# Python
@app.get("/events")
async def events():
return EventSourceResponse(event_generator())
WebSocket Configuration:
# Python
@app.websocket("/ws")
async def websocket_endpoint(websocket: WebSocket):
await websocket.accept()
For HTTP/SSE/WebSocket servers:
# Python
from fastapi.middleware.cors import CORSMiddleware
app.add_middleware(
CORSMiddleware,
allow_origins=["*"], # Configure appropriately
allow_credentials=True,
allow_methods=["*"],
allow_headers=["*"],
)
// TypeScript
import cors from 'cors';
app.use(cors({
origin: process.env.ALLOWED_ORIGINS?.split(',') || '*',
credentials: true
}));
Create .env.example with placeholders:
# Server Configuration
PORT=8000
HOST=0.0.0.0
ALLOWED_ORIGINS=http://localhost:3000,http://localhost:5173
# API Keys (NEVER commit real values)
ANTHROPIC_API_KEY=your_anthropic_key_here
OPENAI_API_KEY=your_openai_key_here
# Transport Settings
TRANSPORT_TYPE=http
ENABLE_CORS=true
Run validation script:
bash scripts/validate-config.sh <server-file>
Checks:
scripts/validate-config.sh - Validate server configurationscripts/generate-server.sh - Generate server from templatescripts/test-transport.sh - Test transport connectivityPython:
templates/python-http-server.py - HTTP server with FastAPItemplates/python-stdio-server.py - STDIO transporttemplates/python-sse-server.py - SSE streaming servertemplates/python-websocket-server.py - WebSocket serverTypeScript:
templates/typescript-http-server.ts - HTTP server with Expresstemplates/typescript-stdio-server.ts - STDIO transporttemplates/typescript-sse-server.ts - SSE streaming servertemplates/typescript-websocket-server.ts - WebSocket serverexamples/http-fastapi-example.md - Complete HTTP server with FastAPIexamples/stdio-simple-example.md - Basic STDIO serverexamples/sse-streaming-example.md - SSE streaming configurationexamples/websocket-bidirectional-example.md - WebSocket bidirectional communicationSetting up HTTP server for remote A2A communication
Configuring STDIO for local agent communication
Implementing SSE for real-time agent updates
Setting up WebSocket for bidirectional agent chat