English Français العربية

io.github.dgonzap30/claims-mcp

Official registry AI and agents

A claims memory for agents: assert beliefs, let them decay, surface contradictions.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package claims-mcp
Claude Code 
claude mcp add claims-mcp -- bunx -y claims-mcp@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "claims-mcp": {
            "command": "bunx",
            "args": [
                "-y",
                "claims-mcp@0.1.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. claims-mcp
  2. Model
  3. MCP tools
  4. Use
  5. Development
  6. Provenance
  7. Author
  8. Licence

claims-mcp

A small memory for agents that treats what it knows as claims that age. You assert a claim about an entity ("acme is priority #1", "the launch is on track"), each claim decays on a half-life set by how volatile it is, and the server tells you which claims have gone stale and which contradict each other.

It is a stdio MCP server plus a CLI over one local SQLite file. No network, no accounts.

Runtime: Bun. v0 uses bun:sqlite, so it runs on Bun ≥ 1.1, not plain Node. A Node build (node:sqlite) is a possible follow-up.

Model

FieldMeaning
entityWhat the claim is about (free text key).
kindpriority (may carry assertedRank), status, fact, relationship.
volatilitystable (half-life 365d), slow (30d), volatile (7d).
confidence0..1 at last confirmation. Effective confidence halves every half-life since lastConfirmed, floored at 0.05.
stateactive, stale, contradicted, retired. Only active claims are checked.

A claim's identity is (entity, kind, claim): asserting it again updates it rather than duplicating.

MCP tools

ToolDoes
claim_addAssert or update a claim.
claim_searchCase-insensitive substring search over claim text and entity.
claim_confirmRe-confirm now: resets decay, reactivates, optionally sets confidence.
claim_retractRetire a claim.
claims_contradictionsConflicts among active claims: duplicate-rank (two entities claim the same priority rank), status-conflict (several active status claims for one entity). Pass observed weekly ranks to also get rank-drop: an asserted-priority entity that every signal ranks worse than rank + 2 for 3 valid periods.
claims_decayedActive claims past a staleness threshold (default 0.5), stalest first.

Resource: claims://all (every claim as JSON).

observed is { "signals": [{ "<entity>": [rank_now, rank_1_period_ago, ...] }, ...], "validPeriods": [true, ...] }. You supply the observations (commit counts, time spent, anything you can rank); the server does not collect them.

Use

bun install

Add to an MCP client (Claude Code shown):

claude mcp add claims -- bun /path/to/claims-mcp/src/mcp.ts

The database lives at ~/.claims-mcp/claims.db; override with --db <path> or CLAIMS_MCP_DB.

CLI:

bun src/cli.ts add acme priority slow 0.8 "acme comes first" --rank 1
bun src/cli.ts search comes
bun src/cli.ts stale 0.5
bun src/cli.ts contradictions
bun src/cli.ts confirm <id>
bun src/cli.ts retract <id>

Development

bun test          # 19 tests, synthetic claims only
bun run typecheck
bun run audit     # publish gate: home paths, private names, secret patterns

Set AUDIT_TERMS="name1|name2" to add your own private names to the audit.

Provenance

Not a straight extraction. The decay curve and the rank-drop rule are ported from a personal agent memory (rank-drop now takes caller-supplied observations); the duplicate-rank and status-conflict rules are new claim-vs-claim logic written for this package. It shares no code, data or storage with the original.

Author

Built by Diego González Zapiain at Lojik Labs. Listed on the official MCP Registry as io.github.dgonzap30/claims-mcp.

Licence

MIT

Frequently asked questions

What is io.github.dgonzap30/claims-mcp?

A claims memory for agents: assert beliefs, let them decay, surface contradictions.

How do I install io.github.dgonzap30/claims-mcp?

It runs on your machine. In Claude Code: claude mcp add claims-mcp -- bunx -y claims-mcp@0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.dgonzap30/claims-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.dgonzap30/claims-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.dgonzap30/claims-mcp?

It is published by dgonzap30. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.