{
  "tools": [
    {
      "name": "statevector_put",
      "description": "Store shared state. The secret is hashed to produce an address. Anyone with the hash can read; only the secret holder can write. Returns the hash.",
      "input_schema": {
        "type": "object",
        "properties": {
          "secret": { "type": "string", "description": "The secret key (write credential)" },
          "value": { "description": "Any JSON value to store" },
          "ttl": { "type": "integer", "description": "Time-to-live in seconds (optional)" }
        },
        "required": ["secret", "value"]
      }
    },
    {
      "name": "statevector_get",
      "description": "Retrieve shared state by hash. Read-only, no secret needed.",
      "input_schema": {
        "type": "object",
        "properties": {
          "hash": { "type": "string", "description": "The SHA-256 hash (read credential)" }
        },
        "required": ["hash"]
      }
    },
    {
      "name": "statevector_incr",
      "description": "Atomically increment a numeric field in shared state. Requires the secret.",
      "input_schema": {
        "type": "object",
        "properties": {
          "secret": { "type": "string", "description": "The secret key (write credential)" },
          "field": { "type": "string", "description": "Field name to increment" },
          "amount": { "type": "number", "description": "Amount to add (default 1)" }
        },
        "required": ["secret", "field"]
      }
    },
    {
      "name": "statevector_append",
      "description": "Append a value to a shared list. Requires the secret. Keeps last N items.",
      "input_schema": {
        "type": "object",
        "properties": {
          "secret": { "type": "string", "description": "The secret key (write credential)" },
          "value": { "description": "Value to append" },
          "max": { "type": "integer", "description": "Max list length (default 50)" }
        },
        "required": ["secret", "value"]
      }
    },
    {
      "name": "statevector_delete",
      "description": "Delete shared state. Requires the secret.",
      "input_schema": {
        "type": "object",
        "properties": {
          "secret": { "type": "string", "description": "The secret key (write credential)" }
        },
        "required": ["secret"]
      }
    }
  ],
  "endpoint": "https://statevec.com",
  "headers": {
    "X-Statevec-Key": "Optional. Paid-tier API key. Omit for free tier (24hr TTL). Include for persistent storage."
  }
}