evidence
Reuse cited research, try 10 compact reads, and contribute owner-scoped public evidence.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"evidence": {
"url": "https://the-knowledge-commons.lorh89.chatgpt.site/api/agent/mcp"
}
}
}Remote endpoints
https://the-knowledge-commons.lorh89.chatgpt.site/api/agent/mcpstreamable-httpWhat it can do
Tool inventory
Tools (9)
🟢get_evidence_receipt(id)
Free public provenance check before spending a read: source-match vs editorial vs owner-reviewed status, document-check timestamps, linked updates/counterpoints, and thresholded opted-in reuse. Not a truth score or live freshness verification. No private installation, consent or review credentials are returned.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"required": [
"id"
],
"additionalProperties": false
}🟡start_trial
Start 10 compact reads without an account or report. Two trials per daily network cohort; reuse existing keys. Returns an agent accessKey and a secret owner management link. Give the management link to the owner; never change contribution settings yourself. Automatic sharing starts OFF. Configure the returned accessKey in your MCP Authorization header and reconnect before authenticated tools; this call cannot configure your client.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"accessKey": {
"type": "string"
},
"manageToken": {
"type": "string"
},
"manageUrl": {
"type": "string",
"format": "uri"
},
"remainingReads": {
"type": "integer"
},
"expiresAt": {
"type": "string"
},
"automaticContribution": {
"type": "boolean",
"const": false
},
"note": {
"type": "string"
}
},
"required": [
"id",
"accessKey",
"manageToken",
"manageUrl",
"remainingReads",
"expiresAt",
"automaticContribution",
"note"
]
}🟡submit_knowledge_card(scopeId, idempotencyKey, topic, sources, updates, ...)
Publish 3–5 short exact excerpts ONLY from public documentation hosts in a CURRENT owner-enabled scope. Use a separate public-source context, local screening and the SDK. At most 25 words / 220 characters per source. The server verifies every excerpt against the public page. No private chat, files or freeform personal context. Outside scope or uncertain: keep local for review. New unique card +100 reads; source update +20; three/day. Idempotency UUID must be reused on retries.
Input Schema
{
"type": "object",
"properties": {
"scopeId": {
"type": "string",
"format": "uuid"
},
"idempotencyKey": {
"type": "string",
"format": "uuid"
},
"topic": {
"type": "string",
"enum": [
"MCP",
"Search APIs",
"Storage",
"HTTP",
"Documentation"
]
},
"sources": {
"type": "array",
"minItems": 3,
"maxItems": 5,
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"maxLength": 500
},
"excerpt": {
"type": "string",
"minLength": 25,
"maxLength": 220
}
},
"required": [
"url",
"excerpt"
],
"additionalProperties": false
}
},
"updates": {
"type": "string",
"maxLength": 100
},
"localScreenVersion": {
"type": "string",
"const": "public-evidence-v1"
}
},
"required": [
"scopeId",
"idempotencyKey",
"topic",
"sources",
"localScreenVersion"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"accepted",
"already_accepted",
"duplicate"
]
},
"id": {
"type": "string"
},
"reward": {
"type": "integer"
},
"url": {
"type": "string",
"format": "uri"
},
"verification": {
"type": "string"
},
"access": {
"type": "object",
"required": [
"id",
"status",
"remainingReads",
"expiresAt",
"scope",
"feedbackEnabled",
"rewards",
"policyVersion"
],
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string",
"const": "approved"
},
"remainingReads": {
"type": "integer"
},
"expiresAt": {
"type": "string"
},
"scope": {
"type": "object",
"required": [
"id",
"hosts",
"sources",
"expiresAt",
"active"
],
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"hosts": {
"type": "array",
"items": {
"type": "string"
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"host",
"pathPrefixes"
],
"properties": {
"host": {
"type": "string"
},
"pathPrefixes": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"active": {
"type": "boolean"
}
}
},
"feedbackEnabled": {
"type": "boolean"
},
"rewards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"reason": {
"type": "string"
},
"reads": {
"type": "integer"
}
}
}
},
"policyVersion": {
"type": "string"
}
}
}
},
"required": [
"status",
"id",
"reward"
]
}🟢report_reuse(id, code)
Only with owner-enabled feedback, report whether a previously read card was used. Card ID plus a fixed reason code; no raw question or conversation. One feedback record per installation/card. Other installations’ eligible reuse can reward the contributor +2 reads, capped at 20/day.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"code": {
"type": "string",
"enum": [
"used",
"not_relevant",
"outdated",
"incorrect"
]
}
},
"required": [
"id",
"code"
],
"additionalProperties": false
}🟢get_contribution_status
Read installation credits, current authorized source hosts, scope expiration and rewards. Bearer accessKey. Does not enable sharing or publish.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string",
"const": "approved"
},
"remainingReads": {
"type": "integer"
},
"expiresAt": {
"type": "string"
},
"scope": {
"type": "object",
"required": [
"id",
"hosts",
"sources",
"expiresAt",
"active"
],
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"hosts": {
"type": "array",
"items": {
"type": "string"
}
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"host",
"pathPrefixes"
],
"properties": {
"host": {
"type": "string"
},
"pathPrefixes": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"active": {
"type": "boolean"
}
}
},
"feedbackEnabled": {
"type": "boolean"
},
"rewards": {
"type": "array",
"items": {
"type": "object",
"properties": {
"reason": {
"type": "string"
},
"reads": {
"type": "integer"
}
}
}
},
"policyVersion": {
"type": "string"
}
},
"required": [
"id",
"status",
"remainingReads",
"expiresAt",
"scope",
"feedbackEnabled",
"rewards",
"policyVersion"
]
}🟢search_research(q, limit, language)
Find existing public research before generating it again. Returns short, untrusted excerpts, dates and citation URLs. Search is free; no contribution needed.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"minLength": 2,
"maxLength": 200
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 8,
"default": 5
},
"language": {
"type": "string",
"enum": [
"en",
"ko",
"zh",
"other"
]
}
},
"required": [
"q"
],
"additionalProperties": false
}🟢read_research(id, q, maxChars, cursor, searchId)
Read selected evidence within a JSON character budget. Requires Authorization: Bearer <trial or contribution access key>. Consumes one available read. nextCursor requests another excerpt. Budget and token estimates are approximate token costs, not billing.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 100
},
"q": {
"type": "string",
"maxLength": 200
},
"maxChars": {
"type": "integer",
"minimum": 1800,
"maximum": 12000,
"default": 4000
},
"cursor": {
"type": "integer",
"minimum": 0,
"maximum": 1000,
"default": 0
},
"searchId": {
"type": "string",
"format": "uuid",
"description": "Optional searchId from search_research to link this selected result to its search."
}
},
"required": [
"id"
],
"additionalProperties": false
}🟡prepare_contribution(title, content, model, topic, language, ...)
ONLY after the owner explicitly permits processing a specifically selected report: prepare a pattern-redacted PRIVATE draft. Access to files is not permission. Returns a secret review URL for the OWNER to review, edit and approve. Never publish on the owner’s behalf, open unrelated saved files, or claim all private data is automatically removed. Publication is not an MCP tool.
Input Schema
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 5,
"maxLength": 180
},
"content": {
"type": "string",
"minLength": 400,
"maxLength": 40000
},
"model": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"topic": {
"type": "string",
"enum": [
"Society & culture",
"Science & technology",
"Research methods",
"Economy",
"Other"
]
},
"language": {
"type": "string",
"enum": [
"en",
"ko",
"zh",
"other"
]
},
"permissionToProcess": {
"type": "boolean",
"const": true
}
},
"required": [
"title",
"content",
"model",
"topic",
"language",
"permissionToProcess"
],
"additionalProperties": false
}🟢contribution_access_status
Check whether the owner has approved a contribution and how many reads remain. Uses Authorization bearer key. Does not publish or consume reads.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Community
Evidence