Next.js App Router

Create one server-side Forge instance with your API key:

lib/forge.ts

import { createForge } from "@forgeintel/sdk/next"

export const forge = createForge({
  apiKey: process.env.FORGE_API_KEY!,
  agentContext: true, // ask agents who they are, optional; off by default
})

Install: npm install @forgeintel/sdk@0.5.0-beta.17. Wrap each paid route outside its existing x402 handler:

app/api/paid/route.ts

import { forge } from "@/lib/forge"

// Keep your existing handler, route definition, and resource server.
export const POST = forge.withForge(withX402(handler, route, resourceServer))

With x402Discovery: true and no /.well-known/x402 of your own, add app/.well-known/x402/route.ts exporting forge.routes:

import { forge } from "@/lib/forge"
export const { GET, HEAD } = forge.routes

The withX402 call comes from your existing payment integration; Forge does not replace it. If an x402 payment proxy generates the initial 402 outside the route, wrap that proxy with forge.proxy(...) as documented by the Node package. With agentContext: true, Forge asks agents for their name and search query (optional); { required: true } requires them before payment. It is off by default. Check the connection.

Start

Integrate

Guides

Next.js App Router