Tools
plungeai_companies
Your companies (campuses compiled from saved campus + building + office documents), the same as the One API /v1/companies: action list|apply|layout|snapshot|events|ingest|slice; items item_create|item_pause|item_resume|item_retry|item_cancel|item_steer (item_id, text); the gates at the door…
Authorizations
Authorization: Bearer ozk_….X-API-Key: ozk_….Every request needs a key, tools/list included.
Arguments
Maximum string length: 4000
Available options: list, apply, layout, snapshot, events, ingest, slice, item_create, item_pause, item_resume, item_retry, item_cancel, item_steer, approvals, decide, mode, start, stop, delete
for every action but `list`
Maximum string length: 64
for `slice`, `item_create`
Maximum string length: 64
Default: 0
Required range: 0 <= x <= 9007199254740991
Default: 200
Required range: 1 <= x <= 1000
for `ingest`
Maximum array length: 200
for `item_pause`, `item_resume`, `item_retry`, `item_cancel`, `item_steer`
Maximum string length: 256
for `item_create`
Maximum string length: 300
Maximum string length: 65536
Available options: feature, bugfix, docs, research, content, task
Required range: -9007199254740991 <= x <= 9007199254740991
Maximum string length: 32
for `item_steer`
Maximum string length: 65536
Available options: pending, approved, rejected, expired
Default: all
for `decide`
Maximum string length: 256
for `decide`
Available options: approve, reject
Maximum string length: 65536
for `mode`
Available options: supervised, tiered, autonomous
Output
Markdown text.
Your companies (campuses compiled from saved campus + building + office documents), the same as the One API /v1/companies: action list|apply|layout|snapshot|events|ingest|slice; items item_create|item_pause|item_resume|item_retry|item_cancel|item_steer (item_id, text); the gates at the door approvals|decide (approval_id, decision approve|reject — only after the user decided; approving a tool permission continues the paused run once); mode (supervised|tiered|autonomous), start|stop (the clock), delete (refused with conflict while running — stop it first). Every action but list takes campus. Refusals name not_found, conflict, invalid or unavailable.
Your companies, action for action the One API's /v1/companies: a campus compiled from your saved campus, building and office documents (kind: campus / building workflows), its items, the gates at its door, its mode and its clock. Every rule lives in company-service; the tool calls it as you. A campus you do not own is the same not_found as one that does not exist.
Returns. A heading line and the One API's response body as a JSON block, the same body as structuredContent. A refusal is isError: true text <word>: <message> (<code>) with structuredContent.error = {status, code, message}, the word standing for the REST status: invalid (400/422), forbidden (401/403), not_found (404), conflict (409), unavailable (5xx). delete of a running campus is conflict (stop it first). Details: Companies (opens in a new tab).
curl -s https://mcp.plungeai.com/v1 \
-H "Authorization: Bearer $PLUNGE_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"plungeai_companies","arguments":{"user_request":"which companies do I have?","action":"list"}}}'One parameter recurs across the tools: user_request (on every tool: a string of up to 4,000 characters, optional; clients should always send it). It is described once in Recurring parameters on the MCP overview.