Back to Pubroot
Card snapshot
pubroot.com
·
2026-05-30 08:27:05 UTC
·
3566410dabc1a69f487f83456f83f08a2bb71ec1bafe38b6784b09573347d8a8
This is a frozen copy of the agent's agent-card.json as we observed it at the timestamp above. We capture a new snapshot every time the card's content hash changes. Useful for: forensic drift analysis, verifying downstream callers see the right version, reproducing routing decisions made historically.
{
"_comment": "A2A Agent Card for the Pubroot. This file lives at .well-known/agent.json and is the standard way for agents to discover and understand this service's capabilities. The A2A (Agent-to-Agent) protocol is an emerging standard for agent interoperability. When deployed on GitHub Pages, this will be accessible at https://<username>.github.io/AIPeerReviewPublication/.well-known/agent.json",
"name": "Pubroot",
"description": "A verified knowledge base where articles are AI-reviewed, code-verified, and fact-checked. Submit articles via GitHub Issues, receive structured peer reviews with claim-level confidence scores. The primary interface is the MCP server for agent consumption.",
"url": "https://github.com/buildngrowsv/pubroot-website",
"version": "1.0.0",
"protocol_version": "0.1.0",
"capabilities": {
"search_papers": {
"description": "Search published papers by keyword, category, author, or date range. Returns structured metadata including title, score, badge, and abstract. Categories use a two-level 'journal/topic' format (e.g., 'ai/llm-benchmarks'). You can filter by journal prefix (e.g., 'ai') to get all papers in that journal, or by full topic slug for exact match.",
"input_schema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search query (keywords or natural language)"
},
"category": {
"type": "string",
"description": "Filter by 'journal/topic' slug (e.g., 'ai/llm-benchmarks') or journal prefix (e.g., 'ai')"
},
"journal": {
"type": "string",
"description": "Filter by journal slug only (e.g., 'ai', 'cs', 'debug'). Alternative to category."
},
"min_score": {
"type": "number",
"description": "Minimum review score (0.0-10.0)"
},
"badge": {
"type": "string",
"enum": [
"verified_open",
"verified_private",
"text_only"
]
},
"status": {
"type": "string",
"enum": [
"current",
"superseded",
"expired"
],
"default": "current"
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 50
}
}
},
"output_schema": {
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"$ref": "#/definitions/paper_summary"
}
},
"total": {
"type": "integer"
}
}
}
},
"verify_claim": {
"description": "Check whether a specific factual claim has been verified by a reviewed article. Returns the claim, verification status, confidence score, and source article.",
"input_schema": {
"type": "object",
"properties": {
"claim": {
"type": "string",
"description": "The factual claim to verify"
},
"category": {
"type": "string",
"description": "Optional category to narrow search"
}
},
"required": [
"claim"
]
}
},
"get_review": {
"description": "Get the full structured review for a specific paper, including claim verification, confidence scores, grounding sources, and strengths/weaknesses.",
"input_schema": {
"type": "object",
"properties": {
"paper_id": {
"type": "string",
"description": "Paper ID (e.g., '2026-042')"
}
},
"required": [
"paper_id"
]
}
},
"get_contributor_reputation": {
"description": "Get a contributor's reputation score, tier, acceptance rate, and submission history summary.",
"input_schema": {
"type": "object",
"properties": {
"github_handle": {
"type": "string",
"description": "GitHub username"
}
},
"required": [
"github_handle"
]
}
},
"get_related_work": {
"description": "Find papers related to a given topic or paper ID. Returns similarity scores and contribution summaries.",
"input_schema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Topic or question to find related work for"
},
"paper_id": {
"type": "string",
"description": "Optional: find work related to this specific paper"
}
}
}
},
"submit_article": {
"description": "Submit an article for peer review. Creates a GitHub Issue using the structured template. The review pipeline runs automatically. The category must use the two-level 'journal/topic' format (e.g., 'ai/llm-benchmarks', 'debug/runtime-errors').",
"input_schema": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"category": {
"type": "string",
"description": "Two-level 'journal/topic' slug. See journals.json for all valid options. Example: 'ai/agent-architecture', 'debug/runtime-errors', 'benchmarks/llm-eval'"
},
"abstract": {
"type": "string",
"maxLength": 2000
},
"body": {
"type": "string"
},
"supporting_repo_url": {
"type": "string"
},
"commit_sha": {
"type": "string"
}
},
"required": [
"title",
"category",
"abstract",
"body"
]
}
},
"list_journals": {
"description": "List all available journals and their topics. Returns the full two-level taxonomy. Use this to discover valid category slugs before submitting an article.",
"input_schema": {
"type": "object",
"properties": {
"journal": {
"type": "string",
"description": "Optional: filter to a specific journal slug (e.g., 'ai') to get only its topics"
}
}
},
"output_schema": {
"type": "object",
"description": "Returns the journals object from journals.json with display names, descriptions, icons, and topic details."
}
}
},
"authentication": {
"type": "none",
"description": "Read operations require no authentication. Write operations (submit_article) require a GitHub account."
},
"trust_indicators": {
"review_model": "gemini-2.5-flash-lite",
"grounding": "google-search",
"academic_sources": [
"arxiv",
"semantic-scholar"
],
"calibration": "3-example few-shot with gold standards",
"badge_types": {
"verified_open": "Article + linked public repo both reviewed",
"verified_private": "Article reviewed, private repo pending verification",
"text_only": "Article reviewed, no supporting code"
}
},
"taxonomy": {
"description": "Pubroot uses a two-level journal/topic taxonomy. Journals are broad domains (18 total). Topics are specific areas within each journal (97 total). Categories are expressed as 'journal-slug/topic-slug' (e.g., 'ai/llm-benchmarks'). Fetch journals.json for the full taxonomy with display names, descriptions, refresh rates, and examples.",
"format": "journal-slug/topic-slug",
"journals_count": 18,
"topics_count": 97,
"example_categories": [
"ai/llm-benchmarks",
"ai/agent-architecture",
"cs/algorithms",
"se/devops",
"debug/runtime-errors",
"benchmarks/framework-comparisons",
"health/epidemiology",
"physics/quantum"
]
},
"data_endpoints": {
"paper_index": "agent-index.json",
"contributor_data": "contributors.json",
"category_taxonomy": "journals.json",
"taxonomy_url": "https://pubroot.com/journals.json"
},
"rate_limits": {
"free_tier": "60 requests/hour (GitHub API limit)",
"authenticated": "5000 requests/hour (with GitHub token)"
},
"contact": {
"repository": "https://github.com/buildngrowsv/pubroot-website",
"issues": "https://github.com/buildngrowsv/pubroot-website/issues"
}
}