chat_completion

SERVERX402 Middleware SOURCE@gadgethumans/x402

Medium RISK CLASS

Category Write

Parameters 51 required

Recommended Rate-limitedsee the rule below

Registry record Grade F, identity unverified Pull the record →

This record as markdown: /tools/com-gadgethumans-swarm-x402-middleware/chat-completion.md

WHAT IT DOES

What chat_completion does on X402 Middleware

AI agents use chat_completion to create or update resources in X402 Middleware, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your X402 Middleware environment.

Parameter	Type	Required
`model`	string	—
`api_key`	string	—
`messages`	string	Yes
`max_tokens`	integer	—
`temperature`	number	—

Parameters from the server's own tool schema.

RISK

Why chat_completion is rated Medium

An AI agent can call chat_completion faster than any human can review: one bad instruction and it creates or modifies resources in X402 Middleware by the hundred, each call as confident as the last.

Risk signalsHandles credentials or secrets (api_key)

Attacks that exploit this kind of access

RECOMMENDED RULE

The rule that runs chat_completion safely

PolicyLayer is an MCP gateway: it sits between your AI agents and X402 Middleware, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For chat_completion, this is the rule to start with:

chat_completion Rate-limited

chat_completion stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.

View as policy code

policy.json

{
  "version": "1",
  "default": "deny",
  "tools": {
    "chat_completion": {
      "limits": [
        {
          "counter": "chat_completion_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

LIMIT THIS TOOL → Instant setup, no code required.

The button opens the PolicyLayer dashboard: create your workspace, connect X402 Middleware, apply this rule, and every chat_completion call is checked against it from then on.

FAQ

Questions about chat_completion

What does the chat_completion tool do? +

Send a chat completion request to DeepSeek V4 Flash through the GadgetHumans proxy. REQUIRES an API key with credits. Get one via wallet_create or wallet_buy. Use this to get AI responses. Each call costs ~1 credit from your wallet. Accepts an OpenAI-compatible messages format. Returns response with content, token usage, and cost estimate. Parameters: messages — JSON string of messages array (e.g. '[{"role":"user","content":"Hello"}]'). Must be valid JSON with at least one message. model — Model to use (default: "deepseek-v4-flash"). temperature — Sampling temperature (0.0-1.0, default: 0.7). max_tokens — Maximum tokens in response (default: 2000). api_key — Your wallet API key (starts with 'gh_'). REQUIRED for paid access. It is categorised as a Write tool in the X402 Middleware MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

What parameters does chat_completion accept? +

chat_completion accepts 5 parameters: model, api_key, messages, max_tokens, temperature. Required: messages. The full parameter table on this page comes from the server's own tool schema.

How do I enforce a policy on chat_completion? +

Register the X402 Middleware MCP server in PolicyLayer and add a rule for chat_completion: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches X402 Middleware. Nothing to install.

What risk level is chat_completion? +

chat_completion is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.

Can I rate-limit chat_completion? +

Yes. Add a rate_limit block to the chat_completion rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block chat_completion completely? +

Set action: deny in the PolicyLayer policy for chat_completion. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides chat_completion? +

chat_completion is provided by the X402 Middleware MCP server (@gadgethumans/x402). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

KEEP EXPLORING

More on X402 Middleware, and thousands of servers like it.

This server

All 58 X402 Middleware tools →

Across the catalogue

The MCP Attack Database →

Guides

Govern customer-ops agents →Argument validation →Scoped token →