SPB Git

Repository Public Research preview

agent-registry.json 5.8 KB 160 lines json

1{2  "schemaVersion": "1.0",3  "name": "@spboucher/research-ledger-mcp",4  "version": "1.0.1",5  "type": "mcp-server",6  "description": "Offline MCP server keeping a hash-chained, append-only ledger for preregistered research: hypotheses, protocol freeze and amendments, decisions, deviations, gates, runs, spending, results.",7  "license": "MIT",8  "keywords": [9    "preregistration",10    "research",11    "reproducibility",12    "ledger",13    "hash-chain",14    "protocol",15    "audit-trail",16    "transparency",17    "mcp"18  ],19  "compatibility": [20    {21      "client": "claude-code"22    },23    {24      "client": "codex"25    },26    {27      "client": "cursor"28    },29    {30      "client": "generic-mcp"31    }32  ],33  "permissions": [34    "shell",35    "filesystem:read",36    "filesystem:write"37  ],38  "mcp": {39    "transport": "stdio",40    "command": "node",41    "args": [42      "server.mjs"43    ],44    "env": [45      {46        "name": "RESEARCH_LEDGER_ROOT",47        "description": "Project root holding .research/ (default: working directory). Every file path must resolve inside it.",48        "required": false,49        "secret": false50      }51    ],52    "tools": [53      {54        "name": "init_project",55        "description": "Create the ledger for a project, with an optional budget"56      },57      {58        "name": "register_hypothesis",59        "description": "Record a hypothesis with its test and decision rule"60      },61      {62        "name": "freeze_protocol",63        "description": "Hash the protocol files and hypotheses; refuses to freeze twice"64      },65      {66        "name": "verify_protocol",67        "description": "Report which frozen files changed, went missing or were renamed"68      },69      {70        "name": "amend_protocol",71        "description": "New linked protocol version with reason and data-seen flag"72      },73      {74        "name": "mark_data_access",75        "description": "Record when outcome data are first opened"76      },77      {78        "name": "log_decision",79        "description": "Record a decision: options, choice, rationale, timing"80      },81      {82        "name": "log_deviation",83        "description": "Record a departure from the protocol and its impact"84      },85      {86        "name": "open_gate",87        "description": "Open a go / no-go review with its criteria"88      },89      {90        "name": "close_gate",91        "description": "Close a gate as go, no-go or conditional, with evidence"92      },93      {94        "name": "check_rerun",95        "description": "Check whether an identical run is already on record"96      },97      {98        "name": "register_run",99        "description": "Record a run: command, hashes, seed, environment, outputs"100      },101      {102        "name": "record_spend",103        "description": "Record the cost of paid calls"104      },105      {106        "name": "spend_report",107        "description": "Totals by provider, model and purpose; budget remaining"108      },109      {110        "name": "set_budget",111        "description": "Change the spending limit, with the reason"112      },113      {114        "name": "record_result",115        "description": "Record a result; confirmatory status is derived"116      },117      {118        "name": "log_question",119        "description": "Note an open question for later sessions"120      },121      {122        "name": "resolve_question",123        "description": "Record the answer to an open question"124      },125      {126        "name": "status",127        "description": "Everything needed to resume the project"128      },129      {130        "name": "export_report",131        "description": "Transparency report in Markdown and JSON"132      },133      {134        "name": "verify_ledger",135        "description": "Re-compute the hash chain; pinpoint the first broken record"136      }137    ]138  },139  "examples": [140    {141      "title": "Register, freeze, record a result (Claude Code)",142      "client": "claude-code",143      "image": "examples/claude-code.png",144      "alt": "Terminal screenshot of a Claude Code session using research-ledger-mcp: the prompt, the tool or script calls, and the agent's answer.",145      "prompt": "With the research-ledger MCP tools: initialise a project titled 'Class size and reading scores' with a 50 USD budget, register hypothesis H1 from protocol.md (statement, test and decision rule), freeze protocol.md, record that outcome data were accessed, then record the result for H1 as confirmed with estimate -0.21. Finish with the status and tell me whether H1 counts as confirmatory or exploratory, and why.",146      "caption": "A hypothesis is registered and the protocol frozen before outcome data are accessed, so the recorded result is classified as confirmatory. Real session, Claude Code 2.1.322 with Fable 5.2, with version 1.0.0 installed from this registry; inputs are test fixtures.",147      "capturedAt": "2026-11-10"148    },149    {150      "title": "Register, freeze, record a result (Codex)",151      "client": "codex",152      "image": "examples/codex.png",153      "alt": "Terminal screenshot of a Codex session using research-ledger-mcp: the prompt, the tool or script calls, and the agent's answer.",154      "prompt": "With the research-ledger MCP tools: initialise a project titled 'Class size and reading scores' with a 50 USD budget, register hypothesis H1 from protocol.md (statement, test and decision rule), freeze protocol.md, record that outcome data were accessed, then record the result for H1 as confirmed with estimate -0.21. Finish with the status and tell me whether H1 counts as confirmatory or exploratory, and why.",155      "caption": "A hypothesis is registered and the protocol frozen before outcome data are accessed, so the recorded result is classified as confirmatory. Real session, Codex CLI 0.167.1 with GPT-6.1-Sol, with version 1.0.0 installed from this registry; inputs are test fixtures.",156      "capturedAt": "2026-11-10"157    }158  ]159}160
Files main
Menu

Theme