> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Assistants connect to Parse over MCP at [https://agent.parse.gl/mcp](https://agent.parse.gl/mcp) (Streamable HTTP). With no sign-in it answers from Parse's public view (the numbers parse.gl's public pages show, up to 5 rows a list), starting with `check_brand`. Signed in with Parse, or sent a workspace key (`parse_mcp_…`), it works in the person's workspace, starting with `get_brief`. Scripts call the same tools over REST at `https://agent.parse.gl/v1/tools/<tool>`.
>
> ```bash
> npx parse-gl init
> ```
>
> To install just the skills: `npx skills add Parsegl/skills`.
> Every tool is also a POST to https://agent.parse.gl/v1/tools/<tool>; its OpenAPI description is https://agent.parse.gl/openapi.json.

# Log work: a note, a plan or what was done

> log_work: a workspace tool on Parse for agents (agent.parse.gl). Arguments, price, and a call over REST and MCP.

Record the user's work and decisions so future sessions build on them: drafts you wrote (status: drafted — drafts are never sent), pitches sent, replies received, pages published, site fixes, hand-offs, waits, research notes, and declined\_offer ids. Never log your own Parse tool calls. Pass brand when the workspace has several brands. Same brand + kind + target appends to the existing item (pass item to target one explicitly; items batches multiple). Free.

## Who may call it, and what it costs

| Name | Access | Effect |
| - | - | - |
| `log_work` | A workspace key, or a sign-in that allows changes. | Changes the workspace |

**Price.** Free. Every reply says what the call cost in `meta.costCredits`. The prices are on [Spending, tracking and stopping](/docs/credits.md).

## Arguments

**move** `one of plan, log, update, close, claim, release`

"plan" for a hand-off or follow-up wait (pair with owner and/or due date)

**text** `string`

what happened or is planned, in your words; pasted email text is fine (up to 4,000 characters)

**title** `string`

a short title; default the note's first sentence, cut to 80 characters

**kind** `string`

Work type: pitch, listing, reply, page\_written, page\_edit, site\_fix, declined\_offer (omit for plain notes or hand-offs)

**status** `string`

drafted (for drafts you wrote — never sent), planned, sent, published, replied, declined

**brand** `string`

brd\_ id, or the brand's name or domain; default the workspace's brand when it has exactly one

**target** `string`

what it is aimed at: a page URL or pg\_ id, a site (domain or site:), a contact's email or ct\_ id, a top\_ id

**page** `string`

the page, as older calls pass it: a pg\_ id or URL

**contact** `string or object`

who it went to: an address, a form or author page URL, a ct\_ id, or \{ name, role, email, site }

**topic** `string`

why: a top\_ id, or the gap in words

**question** `string`

why: a qst\_ id

**due** `string`

when to follow up: a date, today, tomorrow, a weekday, next week, in 3 days

**owner** `string`

who does the work, to hand it to someone: a person's name; default this key's label on a new item. Who wrote each change is kept on its event

**links** `string or list of string or object`

where the work lives: a doc, a PR, a thread

**item** `string`

Existing itm\_… id when recording a reply or follow-up on a prior item

**file** `string`

nt\_ id: file a note kept to file, with what it lacked

**correct** `boolean or string`

true: let status move back or one end change to another, recorded as a correction

**at** `string`

when it happened: a date, yesterday, a weekday (the last one), last week or 3 days ago; default today. A page that went up yesterday is at yesterday

**note** `string`

the same as text

**offer** `one of first_questions, track_weekly, keep_running, top_up, set_up`

with kind declined\_offer: the offer's id

**items** `list of object`

several notes in one call (up to 50), each with the fields above; the call's own fields apply to each as defaults up to 50

Every argument the tool takes, as `GET /v1/tools` serves it, every shared object written out; `https://agent.parse.gl/openapi.json` serves the same schema with the filter and the window named once under `components` and pointed to by `$ref`. MCP `tools/list` leaves out the arguments few calls send, and says the filter and the window once, under `search_answers`; `resolve_ids {"kinds": ["argument"]}` lists what it left out, and a call with any of them runs:

```json theme={null}
{
  "type": "object",
  "properties": {
    "move": {
      "description": "\"plan\" for a hand-off or follow-up wait (pair with owner and/or due date)",
      "type": "string",
      "enum": [
        "plan",
        "log",
        "update",
        "close",
        "claim",
        "release"
      ]
    },
    "text": {
      "description": "what happened or is planned, in your words; pasted email text is fine (up to 4,000 characters)",
      "type": "string"
    },
    "title": {
      "description": "a short title; default the note's first sentence, cut to 80 characters",
      "type": "string",
      "maxLength": 300
    },
    "kind": {
      "description": "Work type: pitch, listing, reply, page_written, page_edit, site_fix, declined_offer (omit for plain notes or hand-offs)",
      "type": "string",
      "maxLength": 60
    },
    "status": {
      "description": "drafted (for drafts you wrote — never sent), planned, sent, published, replied, declined",
      "type": "string",
      "maxLength": 60
    },
    "brand": {
      "description": "brd_ id, or the brand's name or domain; default the workspace's brand when it has exactly one",
      "type": "string",
      "maxLength": 2000
    },
    "target": {
      "description": "what it is aimed at: a page URL or pg_ id, a site (domain or site:), a contact's email or ct_ id, a top_ id",
      "type": "string",
      "maxLength": 2000
    },
    "page": {
      "description": "the page, as older calls pass it: a pg_ id or URL",
      "type": "string",
      "maxLength": 2000
    },
    "contact": {
      "description": "who it went to: an address, a form or author page URL, a ct_ id, or { name, role, email, site }",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 500
        },
        {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "maxLength": 200
            },
            "role": {
              "type": "string",
              "maxLength": 200
            },
            "email": {
              "type": "string",
              "maxLength": 500
            },
            "route": {
              "description": "an address, a form's URL, an author page",
              "type": "string",
              "maxLength": 500
            },
            "site": {
              "type": "string",
              "maxLength": 255
            },
            "id": {
              "description": "a ct_ id a reply gave",
              "type": "string",
              "maxLength": 60
            }
          },
          "additionalProperties": {},
          "description": "who: a name, role, route and site"
        }
      ]
    },
    "topic": {
      "description": "why: a top_ id, or the gap in words",
      "type": "string",
      "maxLength": 2000
    },
    "question": {
      "description": "why: a qst_ id",
      "type": "string",
      "maxLength": 2000
    },
    "due": {
      "description": "when to follow up: a date, today, tomorrow, a weekday, next week, in 3 days",
      "type": "string",
      "maxLength": 2000
    },
    "owner": {
      "description": "who does the work, to hand it to someone: a person's name; default this key's label on a new item. Who wrote each change is kept on its event",
      "type": "string",
      "maxLength": 2000
    },
    "links": {
      "description": "where the work lives: a doc, a PR, a thread",
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2000
        },
        {
          "maxItems": 20,
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2000
              },
              {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "maxLength": 2000
                  },
                  "label": {
                    "type": "string",
                    "maxLength": 200
                  }
                },
                "required": [
                  "url"
                ],
                "additionalProperties": {}
              }
            ]
          }
        }
      ]
    },
    "item": {
      "description": "Existing itm_… id when recording a reply or follow-up on a prior item",
      "type": "string",
      "maxLength": 2000
    },
    "file": {
      "description": "nt_ id: file a note kept to file, with what it lacked",
      "type": "string",
      "maxLength": 2000
    },
    "correct": {
      "description": "true: let status move back or one end change to another, recorded as a correction",
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "string",
          "maxLength": 10
        }
      ]
    },
    "at": {
      "description": "when it happened: a date, yesterday, a weekday (the last one), last week or 3 days ago; default today. A page that went up yesterday is at yesterday",
      "type": "string",
      "maxLength": 2000
    },
    "note": {
      "description": "the same as text",
      "type": "string"
    },
    "offer": {
      "description": "with kind declined_offer: the offer's id",
      "type": "string",
      "enum": [
        "first_questions",
        "track_weekly",
        "keep_running",
        "top_up",
        "set_up"
      ]
    },
    "items": {
      "description": "several notes in one call (up to 50), each with the fields above; the call's own fields apply to each as defaults",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "move": {
            "description": "\"plan\" for a hand-off or follow-up wait (pair with owner and/or due date)",
            "type": "string",
            "enum": [
              "plan",
              "log",
              "update",
              "close"
            ]
          },
          "text": {
            "description": "what happened or is planned, in your words; pasted email text is fine (up to 4,000 characters)",
            "type": "string"
          },
          "title": {
            "description": "a short title; default the note's first sentence, cut to 80 characters",
            "type": "string",
            "maxLength": 300
          },
          "kind": {
            "description": "Work type: pitch, listing, reply, page_written, page_edit, site_fix, declined_offer (omit for plain notes or hand-offs)",
            "type": "string",
            "maxLength": 60
          },
          "status": {
            "description": "drafted (for drafts you wrote — never sent), planned, sent, published, replied, declined",
            "type": "string",
            "maxLength": 60
          },
          "brand": {
            "description": "brd_ id, or the brand's name or domain; default the workspace's brand when it has exactly one",
            "type": "string",
            "maxLength": 2000
          },
          "target": {
            "description": "what it is aimed at: a page URL or pg_ id, a site (domain or site:), a contact's email or ct_ id, a top_ id",
            "type": "string",
            "maxLength": 2000
          },
          "page": {
            "description": "the page, as older calls pass it: a pg_ id or URL",
            "type": "string",
            "maxLength": 2000
          },
          "contact": {
            "description": "who it went to: an address, a form or author page URL, a ct_ id, or { name, role, email, site }",
            "anyOf": [
              {
                "type": "string",
                "maxLength": 500
              },
              {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "role": {
                    "type": "string",
                    "maxLength": 200
                  },
                  "email": {
                    "type": "string",
                    "maxLength": 500
                  },
                  "route": {
                    "description": "an address, a form's URL, an author page",
                    "type": "string",
                    "maxLength": 500
                  },
                  "site": {
                    "type": "string",
                    "maxLength": 255
                  },
                  "id": {
                    "description": "a ct_ id a reply gave",
                    "type": "string",
                    "maxLength": 60
                  }
                },
                "additionalProperties": {},
                "description": "who: a name, role, route and site"
              }
            ]
          },
          "topic": {
            "description": "why: a top_ id, or the gap in words",
            "type": "string",
            "maxLength": 2000
          },
          "question": {
            "description": "why: a qst_ id",
            "type": "string",
            "maxLength": 2000
          },
          "due": {
            "description": "when to follow up: a date, today, tomorrow, a weekday, next week, in 3 days",
            "type": "string",
            "maxLength": 2000
          },
          "owner": {
            "description": "who does the work, to hand it to someone: a person's name; default this key's label on a new item. Who wrote each change is kept on its event",
            "type": "string",
            "maxLength": 2000
          },
          "links": {
            "description": "where the work lives: a doc, a PR, a thread",
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2000
              },
              {
                "maxItems": 20,
                "type": "array",
                "items": {
                  "anyOf": [
                    {
                      "type": "string",
                      "maxLength": 2000
                    },
                    {
                      "type": "object",
                      "properties": {
                        "url": {
                          "type": "string",
                          "maxLength": 2000
                        },
                        "label": {
                          "type": "string",
                          "maxLength": 200
                        }
                      },
                      "required": [
                        "url"
                      ],
                      "additionalProperties": {}
                    }
                  ]
                }
              }
            ]
          },
          "item": {
            "description": "Existing itm_… id when recording a reply or follow-up on a prior item",
            "type": "string",
            "maxLength": 2000
          },
          "file": {
            "description": "nt_ id: file a note kept to file, with what it lacked",
            "type": "string",
            "maxLength": 2000
          },
          "correct": {
            "description": "true: let status move back or one end change to another, recorded as a correction",
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "string",
                "maxLength": 10
              }
            ]
          },
          "at": {
            "description": "when it happened: a date, yesterday, a weekday (the last one), last week or 3 days ago; default today. A page that went up yesterday is at yesterday",
            "type": "string",
            "maxLength": 2000
          },
          "note": {
            "description": "the same as text",
            "type": "string"
          }
        },
        "additionalProperties": {}
      }
    }
  },
  "additionalProperties": {}
}
```

## Example call

A note as you have it: Parse files it as an item on the page, with the contact, and replies with what it understood. Over REST:

```bash theme={null}
export PARSE_API_KEY="<your-key>"

curl -s -X POST https://agent.parse.gl/v1/tools/log_work \
  -H 'content-type: application/json' \
  -H "Authorization: Bearer $PARSE_API_KEY" \
  -d '{"text":"Emailed hello@example.com, the site'"'"'s general inbox, about https://example.com/best-tools; follow up next week","kind":"pitch","status":"sent","due":"next week"}'
```

Over MCP, the assistant calls the tool by name with the same arguments:

```json theme={null}
{
  "method": "tools/call",
  "params": {
    "name": "log_work",
    "arguments": {
      "text": "Emailed hello@example.com, the site's general inbox, about https://example.com/best-tools; follow up next week",
      "kind": "pitch",
      "status": "sent",
      "due": "next week"
    }
  }
}
```

More calls:

* Plan several pieces of work at once: to-dos are items in planned: `{"move":"plan","brand":"<brd_ id>","items":[{"kind":"pitch","target":"https://example.com/best-tools","due":"2026-11-20"},{"kind":"page_written","topic":"pricing comparison","owner":"Dana"}]}`
* Update an item: a second session or another agent writing the same brand, kind and target updates it too: `{"item":"itm_…","status":"replied","text":"The editor wants a quote from the CEO"}`
* The older call, which works as before: a pitch sent to a page: `{"kind":"pitched","page":"https://example.com/best-tools","brand":"<brd_ id>","note":"Emailed the editor"}`

The reply has `data`, `context`, `next`, `page` and `meta`; follow `next` for the calls that come after. A refused call returns `{ code, message, fix }`: see the [error table](/docs/mcp-reference.md#errors).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.