mcpField
W
wazoo

wazoo

github.com/wazootechData & databases014 installsUpdated 4w ago
Repository

About wazoo

Wazoo Skill provides command examples for managing Wazoo knowledge graph worlds and their access tokens. It also documents importing, searching, querying, and exporting graph data for durable agent context.

Key features

  1. 01List, create, update, and delete worlds
  2. 02Manage platform and world tokens
  3. 03Import graph data
  4. 04Search world context
  5. 05Run SPARQL and export graph data

Use cases

  1. 01Create a world for project context
  2. 02Import text or RDF quads into graph memory
  3. 03Search stored context or run graph queries
  4. 04Export data for auditing or backup

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/wazootech/wazoo-skills --skill wazoo

After installing, type/wazooin Claude Code to confirm it loaded.

Details

From the project README

Wazoo Skill

Use this skill when interacting with the Wazoo platform, managing knowledge graph worlds, querying structured memory, or maintaining durable agent context.

Environment setup

Wazoo uses two token types:

  • WAZOO_PLATFORM_TOKEN (wzp_...): Control plane management (worlds, tokens, usage, billing).
  • WORLDS_TOKEN (wzw_...): Data plane operations (import, search, SPARQL, export).
export WAZOO_PLATFORM_TOKEN="wzp_..."
export WORLDS_TOKEN="wzw_..."

1. Control plane management

List worlds
curl -s -X GET "https://api.wazoo.dev/v1/worlds" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"
Create a world

Create a world with a display name. worlds-api mints one immutable w_<ULID> ID. The create request has display-name and optional-region fields, with no caller-selected ID or slug field. The response exposes the ID as world.id; reuse it unchanged as WORLD_ID.

curl -s -X POST "https://api.wazoo.dev/v1/worlds" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "world": { "displayName": "Project Context Graph", "region": "auto" }
  }'

For the examples below, replace this sample with the id returned above:

export WORLD_ID="w_01jd8x5mqv7k3n9r2t4w6y8z0b"
Get world details
curl -s -X GET "https://api.wazoo.dev/v1/worlds/$WORLD_ID" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"
Update a world
curl -s -X PATCH "https://api.wazoo.dev/v1/worlds/$WORLD_ID" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "updateMask": "displayName",
    "world": { "displayName": "Project Context Graph v2" }
  }'
Delete a world
curl -s -X DELETE "https://api.wazoo.dev/v1/worlds/$WORLD_ID" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"
Undelete a world

Deletes are soft and recoverable. Restore a deleted world with undelete:

curl -s -X POST "https://api.wazoo.dev/v1/worlds/$WORLD_ID/undelete" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"

2. Token management

List platform tokens
curl -s -X GET "https://api.wazoo.dev/v1/auth/api-tokens" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"
Create a platform token
curl -s -X POST "https://api.wazoo.dev/v1/auth/api-tokens" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-agent-token",
    "scope": "users.read worlds.read usage.read"
  }'
Revoke a platform token
curl -s -X DELETE "https://api.wazoo.dev/v1/auth/api-tokens/my-agent-token" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"
List world tokens
curl -s -X GET "https://api.wazoo.dev/v1/worlds/$WORLD_ID/auth/tokens" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"
Create a world token

World tokens are scoped to a single world for data-plane access:

curl -s -X POST "https://api.wazoo.dev/v1/worlds/$WORLD_ID/auth/tokens" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "ci-data-access" }'
Revoke a world token
curl -s -X DELETE "https://api.wazoo.dev/v1/worlds/$WORLD_ID/auth/tokens/{tokenUid}" \
  -H "Authorization: Bearer $WAZOO_PLATFORM_TOKEN"

3. Data plane operations

Import graph data

Import RDF quads (JSON array) or chunk text into a world:

curl -s -X POST "https://data.wazoo.dev/worlds/$WORLD_ID/import" \
  -H "Authorization: Bearer $WORLDS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "contentType": "text/plain",
    "data": "Architectural Decision Record 001: Use hybrid SPARQL and vector search for durable memory."
  }'
Hybrid search across context

Search world graph memory by query text:

curl -s -X POST "https://data.wazoo.dev/worlds/$WORLD_ID/search" \
  -H "Authorization: Bearer $WORLDS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Architectural Decision Record",
    "limit": 5
  }'
Execute SPARQL query

Run graph queries over triples/quads in the world:

curl -s -X POST "https://data.wazoo.dev/worlds/$WORLD_ID/sparql" \
  -H "Authorization: Bearer $WORLDS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "SELECT ?s ?p ?o WHERE { ?s ?p ?o } LIMIT 10"
  }'
Export graph data

Export world quads for auditing or local backup:

curl -s -X GET "https://data.wazoo.dev/worlds/$WORLD_ID/export?format=application/json&limit=100" \
  -H "Authorization: Bearer $WORLDS_TOKEN"

Comments

Markdown supported