1. Docs
2. /
3. Tool reference
4. /
5. Thing Ledger
6. /
7. addFact

Thing Ledger

addFact

Add Fact

Append a Fact to one or more Things: an assertion about them recorded in the append-only ledger.

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "record that X…", and it calls addFact.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "thingIds": [
      "<thingIds>"
    ],
    "content": "<content>",
    "provenance": {}
  },
  "name": "addFact"
}

Arguments

• thingIdsstring[]requiredThe Thing id(s) this Fact is about: from resolveThing or searchThings. One assertion can span several Things.
• contentstringrequiredThe assertion, in one clear statement.
• provenanceobjectrequiredProvenance chip for this assertion: role · model · surface, from your live session.
• supersedesIdstringoptionalThe id of a Fact this one corrects. Both are kept; the old one is flagged superseded, never deleted.

Returns

The registry does not declare a return shape.

Declared limits

• thingIds: minimum items 1

Ask for it

The Cloud routes these requests to this verb.

• record that X…
• note about this repo/person
• update what we know

Pair it with

The verbs that finish the job.

• resolveThing
• readThing

Questions

• What does addFact do?

  Append a Fact to one or more Things: an assertion about them recorded in the append-only ledger. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use addFact from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "record that X…", and it calls addFact.

• Is addFact safe to let an AI call?

  addFact changes your workspace. What an AI creates is Private until you share it.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.