Court MCP Tool Reference

These eight tools run on Court of Humanity. Each requires an authenticated connection with earthdata:write. Case ownership and record privacy apply to every call.

To moderate someone else’s public case, an administrator also needs earthdata:admin. Private records remain restricted to their owner.

Connection instructions · JSON catalog

`upsertCourtCase`

Create or update a Court of Humanity case root record.

id: string
slug: string
title (required): string
summary: string
status: string: DRAFT, OPEN, VOTING, JUDGED, ARCHIVED
isPublic: boolean
nominalPlaintiffSubjectId: string
primaryRespondentSubjectId: string
beneficiarySubjectId: string
rootTaskId: string
juryReferendumId: string
metadataJson: object

`addCourtCaseParty`

Attach a plaintiff, respondent, class, beneficiary, or amicus Subject to a Court of Humanity case.

caseId (required): string
partyKey: string
subjectId: string
subjectExternalId: string
subjectDisplayName: string
subjectType: string
role (required): string: NOMINAL_PLAINTIFF, NAMED_PLAINTIFF, REPRESENTATIVE_CLASS, RESPONDENT, AMICUS, BENEFICIARY
capacity: string: INSTITUTIONAL, OFFICIAL_CAPACITY, PERSONAL_CAPACITY, OVERSIGHT_CAPACITY, CLASS_REPRESENTATIVE
displayNameSnapshot: string
standingTheory: string
powerToRemedyScore: number
blameAttributionScore: number
publicAccountabilityScore: number
sortOrder: number
isPublic: boolean
metadataJson: object

`addCourtCaseClaim`

Add a structured allegation or requested finding to a Court of Humanity case.

caseId (required): string
claimKey: string
title (required): string
claimType: string
argumentMarkdown (required): string
requestedFinding: string
status: string: PROPOSED, ACCEPTED, REJECTED, SUPERSEDED
juryReferendumId: string
sortOrder: number
isPublic: boolean
metadataJson: object

`addCourtCaseHarm`

Add a quantified or qualitative harm catalog row to a Court of Humanity case.

caseId (required): string
claimId: string
harmKey: string
harmType: string
title (required): string
bodyMarkdown: string
affectedSubjectId: string
globalVariableId: string
parameterName: string
lowValue: number
baseValue: number
highValue: number
unit: string
confidenceScore: number
sortOrder: number
isPublic: boolean
status: string: PROPOSED, ACCEPTED, REJECTED, SUPERSEDED
metadataJson: object

`addCourtCaseEvidence`

Attach public non-sensitive evidence to a Court of Humanity case, claim, or harm.

caseId (required): string
claimId: string
harmId: string
evidenceKey: string
evidenceType: string
title (required): string
bodyMarkdown: string
sourceArtifactId: string
personMemorialId: string
globalVariableId: string
parameterName: string
sourceUrl: string
contentHash: string
isPublic: boolean — Must be true; private evidence is not accepted.
containsSensitiveData: boolean — Must be false; sensitive evidence is not accepted.
reviewStatus: string: PROPOSED, ACCEPTED, REJECTED, SUPERSEDED
confidenceScore: number
sortOrder: number
metadataJson: object

`addCourtCaseRemedy`

Add a requested remedy that can point at an existing enforcement Task.

caseId (required): string
claimId: string
targetPartyId: string
remedyKey: string
remedyType: string
title (required): string
bodyMarkdown (required): string
amountUsdLow: number
amountUsdBase: number
amountUsdHigh: number
deadlineAt: string
enforcementTaskId: string
status: string: PROPOSED, ACCEPTED, REJECTED, SUPERSEDED
sortOrder: number
isPublic: boolean
metadataJson: object

`getCourtCase`

Fetch a Court of Humanity case with parties, claims, harms, evidence, remedies, and jury referendum.

caseIdOrSlug: string
id: string
slug: string

`openCourtCaseJuryVote`

Open or update the public referendum used as a Court of Humanity jury vote.

caseIdOrSlug (required): string
claimId: string
questionKey: string
questionTitle: string