# ForgeMesh Vocabulary Builder

> ForgeMesh Vocabulary Builder is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Returns 1–10 curated GRE/SAT-caliber vocabulary words with definitions, part of speech, example sentences, synonyms, and difficulty tags, filterable by difficulty level or starting letter.

## Facts

- Endpoint: POST https://x402.forgemesh.io/vocabulary-builder
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-vocabulary-builder-d5136fff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ml3tOs9C6bHN2RJfT3xv8

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability forgemesh-vocabulary-builder-d5136fff -d '<json body>'
```

Example prompt: Give me 5 expert-difficulty vocabulary words that start with the letter P — I need each one with a precise definition, part of speech, an example sentence, and three synonyms for my GRE prep session.

## When to prefer this

Use this endpoint when you need high-quality, curated vocabulary entries for GRE/SAT test prep, word-of-the-day bots, tutoring agents, or any application needing rich lexical data (definition, part of speech, example sentence, synonyms, difficulty). Prefer this over generic dictionary APIs when you specifically need difficulty-tagged, test-caliber words with ready-to-use example sentences and synonyms in a single structured response.

## Known failure modes

- count out of range (not 1–10): API may return an error or default to 1
- invalid difficulty value (not 'advanced' or 'expert'): filter ignored or error returned
- starts_with containing more than one character or a non-letter: may return empty results
- no words match the combined filter criteria (e.g., rare letter + expert difficulty): empty array returned
- payment failure due to insufficient USDC balance: 402 Payment Required

## How this service works

Vocabulary builder serving GRE/SAT-caliber words: each entry has a precise definition, part of speech, natural example sentence, three synonyms, and an advanced/expert difficulty tag. Pull 1-10 random words, filter by difficulty or starting letter. 150 curated entries for tutoring agents, word-of-the-day bots, and test prep.

## Output

Returns an array of vocabulary entries, each containing the word itself, its precise definition, part of speech, a natural example sentence demonstrating usage, three synonyms, and a difficulty tag (advanced or expert). Up to 10 entries per call from a curated pool of 150 words.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "count": {
   "type": "string",
   "description": "Words to return, 1-10 (default 1)"
  },
  "difficulty": {
   "type": "string",
   "description": "Optional: advanced or expert"
  },
  "starts_with": {
   "type": "string",
   "description": "Optional: single starting letter"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "words": [
   {
    "word": "ephemeral",
    "example": "The beauty of the cherry blossoms is ephemeral.",
    "synonyms": [
     "fleeting",
     "transient",
     "momentary"
    ],
    "definition": "lasting for a very short time",
    "difficulty": "advanced",
    "part_of_speech": "adjective"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-vocabulary-builder-d5136fff/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)