create_test_clock

Creates a disposable, identity-owned simulation for agent testing. Supply RFC 3339 timestamps; scheduled events must fall between frozenTime and maxTime. Accep…

Use with an AI agent

Export this page as Markdown or bundle it with a task for your agent.

Try a task
0 charactersPage docs attached
Preview the prompt that will be copied

Access

  • Effect: Creates data
  • Required scope: write (the mcp scope also grants it)

Example request

The JSON-RPC message an MCP client sends to call this tool. Your client builds it for you; this is for reference and debugging in a tool such as MCP Inspector.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_test_clock",
    "arguments": {}
  }
}

Example IDs refer to fictional demo data. Replace them with IDs from your account before calling the real server.

Description

Creates a disposable, identity-owned simulation for agent testing. Supply RFC 3339 timestamps; scheduled events must fall between frozenTime and maxTime. Accepts at most 100 transactions and 25 goals with up to 100 contributions each. Transaction types are INCOME or EXPENSE; names are 1-120 characters, amounts are positive and at most 1000000000, currencies are three uppercase letters, and categories are at most 80 characters. Goal targets are positive and at most 1000000000; initial amounts cannot exceed targets; contribution amounts are positive and at most 1000000000. frozenTime must be within ten years of now; maxTime is ten years after frozenTime. Supply a frozenTime and scheduled synthetic transactions and goal contributions. Only clock readback exposes these records; they never touch real accounts, transactions, goals, or bank connections. Clocks expire after seven days.

Input parameters

NameTypeRequiredDescription
frozenTimestringNo
goalsarrayNo
transactionsarrayNo
Full input schema (JSON Schema)
json
{
  "additionalProperties": false,
  "properties": {
    "frozenTime": {
      "type": "string"
    },
    "goals": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "contributions": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "amount": {
                  "type": "number"
                },
                "at": {
                  "type": "string"
                }
              },
              "required": [
                "at",
                "amount"
              ],
              "type": "object"
            },
            "type": [
              "null",
              "array"
            ]
          },
          "initialAmount": {
            "type": "number"
          },
          "name": {
            "type": "string"
          },
          "targetAmount": {
            "type": "number"
          }
        },
        "required": [
          "name",
          "targetAmount"
        ],
        "type": "object"
      },
      "type": [
        "null",
        "array"
      ]
    },
    "transactions": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "amount": {
            "type": "number"
          },
          "at": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        },
        "required": [
          "at",
          "name",
          "amount",
          "currency",
          "type"
        ],
        "type": "object"
      },
      "type": [
        "null",
        "array"
      ]
    }
  },
  "type": "object"
}