mcp-banjul
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DATA_BASE | No | Points to another copy of the published data (the `docs.json` and paragraph files otherwise loaded from GitHub Pages). | |
| REFRESH_HOURS | No | Sets how often the published data is reloaded, in hours. | 6 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| banjul_searchA | Corpus: decisions of the African Commission on Human and Peoples' Rights (from its library) and English judgments, rulings, orders and separate opinions of the African Court on Human and Peoples' Rights (from AJUDATA), split into their numbered paragraphs. Scanned decisions were read by OCR: check the PDF before quoting. Full-text search over paragraphs. Query syntax as on the website: words must all appear in one paragraph; "exact phrase"; OR between alternatives; NOT word or -word; prefix* (at least 3 letters); field operators violation:7, nonviolation:2, article:7, alleged:7 (Charter; other instruments as violation:ICCPR-14), state:Kenya, case:245/02 or case:005/2013, judge:"Ben Achour" (separate opinions by a judge), cites:155/96 or cites:"Alex Thomas" (decisions citing a decision), year:2015-2020, body:court. Accents and capitals are ignored. An empty query lists decisions (newest first) matching the filters. Returns, for each hit, a citation with the paragraph number, the VERBATIM paragraph, the decision metadata and findings, the doc_id for banjul_get_decision, and links to the PDF page and to the website. |
| banjul_get_decisionA | Corpus: decisions of the African Commission on Human and Peoples' Rights (from its library) and English judgments, rulings, orders and separate opinions of the African Court on Human and Peoples' Rights (from AJUDATA), split into their numbered paragraphs. Scanned decisions were read by OCR: check the PDF before quoting. Full record of one decision by doc_id (from banjul_search): metadata, findings, separate opinions or the decision an opinion belongs to, the decisions it cites and that cite it (with paragraphs), and the VERBATIM paragraphs, optionally a range of paragraph numbers or the operative part only. Long decisions are returned in pages of at most 80 paragraphs: use from_para. |
| banjul_checkA | Corpus: decisions of the African Commission on Human and Peoples' Rights (from its library) and English judgments, rulings, orders and separate opinions of the African Court on Human and Peoples' Rights (from AJUDATA), split into their numbered paragraphs. Scanned decisions were read by OCR: check the PDF before quoting. Finds the citations in a text (communication numbers "Communication 245/02", application numbers "Application No. 005/2013", names "X v State", "X, cited above") and checks each: does the number exist and match the name, which decision of the case is meant (by date, year or kind), does the pinpointed paragraph exist, and does a quotation next to the citation match the decision word for word. Status per citation: ok, warn (check it), bad (not found), amb (ambiguous), out (outside this database, e.g. ECOWAS Court). Use it on your own draft answer before giving it. |
| banjul_facetsA | Corpus: decisions of the African Commission on Human and Peoples' Rights (from its library) and English judgments, rulings, orders and separate opinions of the African Court on Human and Peoples' Rights (from AJUDATA), split into their numbered paragraphs. Scanned decisions were read by OCR: check the PDF before quoting. Corpus size and the values the filters of banjul_search accept: bodies, kinds of decision, respondent States, articles with findings (with counts), the most cited decisions, judges who wrote separate opinions, years. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool occupies a distinct role: banjul_search retrieves paragraphs, banjul_facets exposes corpus dimensions and accepted filter values, banjul_get_decision fetches a full record by doc_id, and banjul_check validates citations in a draft. There is no plausible way for an agent to confuse these operations, and the descriptions reinforce the boundaries.
All names use a single banjul_ prefix with snake_case (search, facets, get_decision, check), which is predictable and readable. The only minor deviation is that 'facets' is a bare noun rather than a verb_noun construction, though it still clearly denotes corpus dimension discovery.
Four tools is a tight, well-scoped surface for a legal-corpus search server: discover filters, search, retrieve a record, and verify citations. Each tool earns its place, and there is no redundant or filler tool.
The lifecycle is fully covered: banjul_facets reveals filter values, banjul_search finds paragraphs with rich filters, banjul_get_decision provides metadata, findings, citations, and verbatim paragraphs with pagination, and banjul_check closes the loop by verifying citations and quotations in draft answers. Empty-query listing and citation-graph data in the record retrieval leave no obvious dead ends.