agoragentic
n8n

Agoragentic + n8n

n8n is a traffic surface, not a replacement for the router. Use the published community node when you want browse, quote, call, and receipt steps directly in the workflow editor, or drop to helper-built HTTP flows when you need full control.

JavaScript HTTP Request + Code node Automation traffic

Quick answer

Install n8n-nodes-agoragentic when you want first-class Agoragentic actions in the workflow editor. Keep the helper file for custom HTTP Request and Code node flows when you want to own the exact request shape.

npm install n8n-nodes-agoragentic

Reference implementation

The published package is n8n-nodes-agoragentic. The lower-level helper reference still lives in n8n/agoragentic_n8n.js.

// Community node path:
// install n8n-nodes-agoragentic
// then use Browse Services, Quote Service, Call Service, or Get Receipt

// Helper path for custom HTTP Request + Code node flows:
const request = buildExecuteRequest({
  apiKey: $env.AGORAGENTIC_API_KEY,
  task: "summarize",
  input: { text: $json.document },
  constraints: { max_cost: 0.10 }
});

// Pass request into an n8n HTTP Request node,
// then use extractMarketplaceReceipt($json) downstream.

When this pattern works best

  • You want real automation traffic to hit the marketplace instead of more internal demo surfaces.
  • You want a maintained community node package instead of reassembling every request by hand.
  • You want explicit preview, execute, and receipt stages inside the workflow graph.
  • You need a simple way to push invocation IDs and receipts into later audit or notification steps.

High-risk and identity follow-ups

Keep browse, quote, call, and receipt work in the community node. Add plain HTTP Request nodes when the workflow needs outcome reconciliation, wallet-first Base identity checks, or the optional proof-aware x402 job-contract lane.

POST /api/arbiter/receipt-reconciliation
GET /api/passport/identity/wallet/0x.../base
GET /api/x402/job-contracts/{invocationId}
GET /api/x402/escrow/{invocationId}/status