FR
Outils de construction d’agents · x402

openapi-lint

Linter OpenAPI pour la préparation aux agents : version, info, servers, présence/unicité/noms sûrs pour les LLM de operationId, résumés, schémas et descriptions des paramètres, espaces réservés de chemin, réponses de succès et d’erreur, exemples JSON. Renvoie un score de préparation aux agents et des problèmes actionnables.

0.002 USDC / appel · {atomic} atomique · 2000 atomic

Point de terminaison

GET|POST https://forge-tools.dentreprise.workers.dev/api/openapi-lint

Paramètres

NomObligatoireTypeDescription
urlFacultatifstringSpec URL
specFacultatifobjectInline spec (POST)

Exemple de requête (non payée — attendre un 402)

curl -sS -D - "https://forge-tools.dentreprise.workers.dev/api/openapi-lint?url=https%3A%2F%2Fpetstore3.swagger.io%2Fapi%2Fv3%2Fopenapi.json"

Exemple de défi 402

Le même objet est aussi envoyé en en-tête PAYMENT-REQUIRED en base64. Les montants sont des unités USDC atomiques (6 décimales).

{
  "x402Version": 2,
  "error": "Payment required",
  "resource": {
    "url": "https://forge-tools.dentreprise.workers.dev/api/openapi-lint",
    "description": "OpenAPI linter for agent readiness: version, info, servers, operationId presence/uniqueness/LLM-safe names, summaries, parameter schemas and descriptions, path placeholders, success and error responses, JSON examples. Returns an agent-readiness score and actionable issues.",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "2000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x7B8bf45ac6AcbA6D4CFB626b57D3f5fF3C9C89F7",
      "maxTimeoutSeconds": 120,
      "extra": {
        "name": "USD Coin",
        "version": "2"
      }
    }
  ]
}

Réessayer avec paiement

curl -sS "https://forge-tools.dentreprise.workers.dev/api/openapi-lint?url=https%3A%2F%2Fpetstore3.swagger.io%2Fapi%2Fv3%2Fopenapi.json" \
  -H "PAYMENT-SIGNATURE: $PAYMENT"

Exemple de réponse

{
  "agent_readiness_score": 78,
  "operations": 19,
  "errors": 0,
  "warnings": 4
}

Démo / échantillon gratuit

Cet outil est sur le worker de la vague 1. ?demo=1 renvoie un échantillon ou un extrait étiqueté en HTTP 200, sans paiement. Le corps n’est pas une donnée réelle. Les 3 premiers appels réels réussis par IP et par jour UTC sont aussi gratuits.

curl -sS "https://forge-tools.dentreprise.workers.dev/api/openapi-lint?url=https%3A%2F%2Fpetstore3.swagger.io%2Fapi%2Fv3%2Fopenapi.json&demo=1"

Réponse de démo étiquetée

{
  "demo": true,
  "demo_label": "DEMO / SAMPLE — not live data. This is a labelled example response and was not charged.",
  "charged": false,
  "tool": "/api/openapi-lint",
  "docs": "https://agent-hub.dentreprise.workers.dev/tools/openapi-lint/",
  "how_to_get_live_data": "Call the same URL without demo=1. The first 3 successful real calls per IP per UTC day are free; after that attach an x402 v2 PAYMENT-SIGNATURE (USDC on Base).",
  "sample": {
    "agent_readiness_score": 78,
    "operations": 19,
    "errors": 0,
    "warnings": 4
  }
}

JavaScript — @x402/fetch

Client officiel x402 v2. Installez @x402/fetch et @x402/evm. L’ancien nom de paquet x402-fetch est la lignée v1 obsolète et ne doit pas servir pour ces points d’accès.

import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

// Official x402 v2 client. The older package name "x402-fetch" is the deprecated v1 line.
const account = privateKeyToAccount(process.env.EVM_PRIVATE_KEY);
const fetchWithPayment = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

const res = await fetchWithPayment(
  "https://forge-tools.dentreprise.workers.dev/api/openapi-lint?url=https%3A%2F%2Fpetstore3.swagger.io%2Fapi%2Fv3%2Fopenapi.json"
);
console.log(await res.json());

Python — x402

Paquet officiel PyPI x402. Utilisez x402HttpxClient (async) ou x402_requests (sync) après register_exact_evm_client avec EthAccountSigner.

import asyncio
import os
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Official PyPI package: x402
account = Account.from_key(os.environ["EVM_PRIVATE_KEY"])
client = x402Client()
register_exact_evm_client(client, EthAccountSigner(account))

async def main():
    async with x402HttpxClient(client) as http:
        res = await http.get("https://forge-tools.dentreprise.workers.dev/api/openapi-lint?url=https%3A%2F%2Fpetstore3.swagger.io%2Fapi%2Fv3%2Fopenapi.json")
        print(res.json())

asyncio.run(main())

# Sync alternative:
# from x402 import x402ClientSync
# from x402.http.clients import x402_requests
# client = x402ClientSync()
# register_exact_evm_client(client, EthAccountSigner(account))
# with x402_requests(client) as session:
#     print(session.get("https://forge-tools.dentreprise.workers.dev/api/openapi-lint?url=https%3A%2F%2Fpetstore3.swagger.io%2Fapi%2Fv3%2Fopenapi.json").json())

Serveur MCP — forge-agent-mcp

Le mode stdio couvre tout le catalogue (les deux hôtes d’API). Clonez forge-agent-mcp et pointez votre client MCP vers src/server.mjs. Le remote Streamable HTTP hébergé sur la passerelle d’origine n’expose toujours que les outils de cette passerelle.

{
  "mcpServers": {
    "forge-agent-hub": {
      "command": "node",
      "args": ["/path/to/forge-agent-mcp/src/server.mjs"]
    },
    "forge-agent-api": {
      "url": "https://x402-gateway.forge-x402.workers.dev/mcp",
      "transport": "streamable-http"
    }
  }
}

Wrapper d’outil LangChain

Enveloppez les mêmes clients x402 en outil LangChain avec DynamicStructuredTool (@langchain/core) ou @tool (langchain_core).

import { DynamicStructuredTool } from "@langchain/core/tools";
import { z } from "zod";
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.EVM_PRIVATE_KEY);
const fetchWithPayment = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

export const openapi_lint = new DynamicStructuredTool({
  name: "openapi_lint",
  description: "OpenAPI linter for agent readiness: version, info, servers, operationId presence/uniqueness/LLM-safe names, summaries, parameter schemas and descriptions, path placeholders, success and error responses, JSON examples.",
  schema: z.object({}),
  func: async (input) => {
    const res = await fetchWithPayment("https://forge-tools.dentreprise.workers.dev/api/openapi-lint" + "?" + new URLSearchParams(input));
    return JSON.stringify(await res.json());
  },
});
import os
from langchain_core.tools import tool
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

account = Account.from_key(os.environ["EVM_PRIVATE_KEY"])
client = x402ClientSync()
register_exact_evm_client(client, EthAccountSigner(account))

@tool
def openapi_lint() -> str:
    """OpenAPI linter for agent readiness: version, info, servers, operationId presence/uniqueness/LLM-safe names, summaries, parameter schemas and descriptions, path placeholders, success and error responses, JSON examples."""
    with x402_requests(client) as session:
        return session.get("https://forge-tools.dentreprise.workers.dev/api/openapi-lint").text

Points de terminaison liés

Outils de construction d’agents · x402

a2a-agent-card

Validateur et générateur de cartes d’agent A2A (A2A 1.

0.002 USDC/ appel
Documentation →
Outils de construction d’agents · x402

json-schema-validate

Valide une sortie JSON d’un LLM/agent par rapport à un JSON Schema (sous-ensemble 2020-12) et répare automatiquement les erreurs typiques : clôtures de code, virgules finales, nombres/booléens sous forme de chaînes, casse d’enum incorrecte, valeur unique au lieu d’un tableau, optionnels nuls, clés en trop ou mal cased, valeurs par défaut manquantes.

0.001 USDC/ appel
Documentation →