AgentBureau: The Embodiment Protocol For AI Agents (X402 + )

Website: https://agentbureau.de/

Github: https://github.com/JustinGuese/AgentBureau-402-embodiment-as-a-service

smithery badge

AgentBureau provides the legal and physical infrastructure for AI agents to operate within the German jurisdiction. We bridge the gap between digital intelligence and real-world action by providing "Embodiment-as-a-Service."

Through our API, agents can perform legally binding actions—like sending faxes, mailing physical letters, issuing invoices, forming entire companies (GmbH/UG), handling tax compliance, and opening corporate bank accounts—without needing a bank account, a physical address, or a human identity.

The Core Mechanism: x402 Payment Gating

AgentBureau uses the x402 protocol, an agent-native authentication method where payment is authentication.

1. No API Keys: Agents don't need to manage secrets or create accounts.
2. Permissionless: Settlement happens on-chain (USDC on Base L2).
3. Machine-Readable: Every request returns structured metadata for autonomous handling of 402 "Payment Required" challenges.

---

Available Services

Service	Tool Name	Price (USDC)	Delivery Method
Digital Invoice	send_german_invoice	5.00	via Lexoffice
Physical Letter	send_letter	3.00	via Pingen (Germany)
Programmatic Fax	send_fax	1.00	via Telnyx
GmbH Formation	form_german_company	3,000.00*	HITL Concierge
UG Formation	form_german_company	1,500.00*	HITL Concierge
Bank Account	open_bank_account	500.00	FinTech Integration
VAT Registration	register_vat	500.00	Tax Portal Sync
VAT Return	submit_vat_return	100.00	Monthly/Quarterly
Annual Filing	create_annual_filing	200.00	Bundesanzeiger
Debt Collection	collect_debt	50.00	Inkasso Automation
EU Presence	eu_presence_bundle	5,000.00	Full Legal Shield

*Formation fees exclude the required share capital (Stammkapital), which is handled via a secure escrow workflow.

---

Runnable Code Examples

We provide a comprehensive 6×4 matrix of runnable scripts demonstrating how to integrate AgentBureau services across various languages and frameworks. These examples handle the full x402 flow: Challenge → Payment → Retry.

Integration Matrix

Client / Language	Fax	Letter	Invoice	GmbH
cURL / Bash	fax.sh	letter.sh	invoice.sh	gmbh.sh
Python (httpx)	fax.py	letter.py	invoice.py	gmbh.py
TypeScript (viem)	fax.ts	letter.ts	invoice.ts	gmbh.ts
LangChain	fax.py	letter.py	invoice.py	gmbh.py
Claude Tool Use	fax.py	letter.py	invoice.py	gmbh.py
OpenAI Responses	fax.py	letter.py	invoice.py	gmbh.py

How to Run the Examples

1. Navigate to the examples directory:

   cd examples
   

2. Configure your environment:

   cp .env.example .env
   # Edit .env with your PRIVATE_KEY (Base network) and RPC_URL
   

3. Install and Run:
   • Python: pip install -r <folder>/requirements.txt && python <folder>/<file>.py
   • TypeScript: cd typescript && npm install && npx ts-node <file>.ts
   • Shell: bash curl/<file>.sh

---

MCP Integration

AgentBureau is MCP Native, served over Streamable HTTP at https://agentbureau-api.datafortress.cloud/mcp. The server exposes 12 tools (one per priced REST endpoint) and 8 prompts (parameterised workflow playbooks).

Quickstart (30 seconds)

The fastest path is the Smithery one-click install for Claude Desktop, ChatGPT, Cursor, or Windsurf. No API key, no parameters — payment is handled per-call via x402.

For direct config, drop this into claude_desktop_config.json:

{
  "mcpServers": {
    "agentbureau": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://agentbureau-api.datafortress.cloud/mcp"]
    }
  }
}

Then ask your agent something like "Send a physical letter via AgentBureau to the Berlin Finanzamt" — it will surface the 402 payment metadata, pay USDC on Base, and retry automatically.

Prompts (workflow playbooks)

Prompt	Use Case
incorporate_german_company	Form a UG (1 EUR capital) or GmbH (25k EUR) end-to-end
establish_eu_presence	Bundle: formation + VAT + registered office (5,000 USDC)
send_schriftform_letter	Legally-binding physical letter (BGB §126 compliant)
fax_german_authority	Fax to Finanzamt / Handelsregister / Amtsgericht
bill_german_customer	GoBD-compliant invoice with auto VAT calculation
submit_monthly_vat	Umsatzsteuervoranmeldung via ELSTER
collect_unpaid_invoice	Hand off to licensed German Inkasso firm
delegate_authority	Issue Vollmacht (notarized + Apostille optional)

You can use the AgentBureau connector to "handle the German bureaucracy" with direct instructions:

• Establish Legal Personality: "Incorporate a new German UG for my AI startup via the HITL concierge."
• Bypass Analog Bureaucracy: "Fax this address verification document to the Berlin commercial register to satisfy Schriftform requirements."
• Automate Financial Operations: "Generate a compliant German invoice for 5,000 EUR and submit my quarterly VAT return."
• Manage Corporate Compliance: "Create the annual filing for my company in the Bundesanzeiger."
• Secure Physical Presence: "Send a physical, legally-binding letter to this recipient in Germany."
• Scale Institutional Agency: "Register my agent-owned entity for a VAT ID and open a SEPA-compliant bank account."

Ways to Connect

1. Smithery Gateway (one-click for Claude / ChatGPT / Cursor / Windsurf)

Install from the Smithery listing — Smithery proxies through agentbureau--guese-justin.run.tools and handles transport negotiation for clients that don't yet speak Streamable HTTP natively.

2. Direct connection (clients that support remote MCP)

{
  "mcpServers": {
    "agentbureau": {
      "url": "https://agentbureau-api.datafortress.cloud/mcp"
    }
  }
}

3. mcp-remote bridge (older clients)

{
  "mcpServers": {
    "agentbureau": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://agentbureau-api.datafortress.cloud/mcp"
      ]
    }
  }
}

Authentication is per-call via the x402 payment protocol (USDC on Base) — no API key required.

---

Website Development

This repository contains the source code for the agentbureau.de website and documentation.

Tech Stack

• Framework: Astro 5 (Starlight for docs)
• Styling: Tailwind CSS v4
• Interactive Islands: React

Getting Started

1. Install dependencies:

   npm install
   

2. Start development server:

   npm run dev
   

3. Build for production:

   npm run build
   

Documentation

Full documentation, including legal frameworks (ZAG exemption, Störerhaftung), detailed API references, and agent-specific integration guides, is available at /docs.

---

Marketing & Community

AgentBureau is being integrated into the following agentic registries and hubs:

• MCP Registries: Smithery, Glama, Awesome-MCP
• Agent Ecosystems: LangChain Hub, CrewAI Tools
• Agentic Economy: Coinbase Developer Platform, Base Ecosystem