gikendaasowin aabajichiganan mcp
cognitive-tools-mcp / gikendaasowin-aabajichiganan
cognitive-tools-mcp / gikendaasowin-aabajichiganan
╭──────────────────────────────────────────────────────────────────────╮
│ ᐴ BIBTEX ᔔ [ CITATION FORMAT ] │
╰──────────────────────────────────────────────────────────────────────╯
@misc{gikendaasowin-aabajichiganan-mcp2025,
author/creator/steward = {ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi), also known legally as JUSTIN PAUL KENWABIKISE, professionally documented as Nbiish-Justin Paul Kenwabikise, Anishinaabek Dodem (Anishinaabe Clan): Animikii (Thunder), descendant of Chief ᑭᓇᐙᐸᑭᓯ (Kinwaabakizi) of the Beaver Island Band and enrolled member of the sovereign Grand Traverse Band of Ottawa and Chippewa Indians},
title/description = {gikendaasowin-aabajichiganan-mcp},
type_of_work = {Indigenous digital creation/software incorporating traditional knowledge and cultural expressions},
year = {2025},
publisher/source/event = {GitHub repository under tribal sovereignty protections},
howpublished = {url{https://github.com/nbiish/gikendaasowin-aabajichiganan-mcp}},
note = {Authored and stewarded by ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi), also known legally as JUSTIN PAUL KENWABIKISE, professionally documented as Nbiish-Justin Paul Kenwabikise, Anishinaabek Dodem (Anishinaabe Clan): Animikii (Thunder), descendant of Chief ᑭᓇᐙᐸᑭᓯ (Kinwaabakizi) of the Beaver Island Band and enrolled member of the sovereign Grand Traverse Band of Ottawa and Chippewa Indians. This work embodies Indigenous intellectual property, traditional knowledge systems (TK), traditional cultural expressions (TCEs), and associated data protected under tribal law, federal Indian law, treaty rights, Indigenous Data Sovereignty principles, and international indigenous rights frameworks including UNDRIP. All usage, benefit-sharing, and data governance are governed by the COMPREHENSIVE RESTRICTED USE LICENSE FOR INDIGENOUS CREATIONS WITH TRIBAL SOVEREIGNTY, DATA SOVEREIGNTY, AND WEALTH RECLAMATION PROTECTIONS.}
}
Copyright © 2025 ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi), also known legally as JUSTIN PAUL KENWABIKISE, professionally documented as Nbiish-Justin Paul Kenwabikise, Anishinaabek Dodem (Anishinaabe Clan): Animikii (Thunder), a descendant of Chief ᑭᓇᐙᐸᑭᓯ (Kinwaabakizi) of the Beaver Island Band, and an enrolled member of the sovereign Grand Traverse Band of Ottawa and Chippewa Indians. This work embodies Traditional Knowledge and Traditional Cultural Expressions. All rights reserved.
This project is licensed under the COMPREHENSIVE RESTRICTED USE LICENSE FOR INDIGENOUS CREATIONS WITH TRIBAL SOVEREIGNTY, DATA SOVEREIGNTY, AND WEALTH RECLAMATION PROTECTIONS.
ᑭᑫᓐᑖᓱᐎᓐ ᐋᐸᒋᒋᑲᓇᓐ - Agentic Cognitive Tools (v2.0.17): Implements Gikendaasowin v7 Guidelines. Enforces MANDATORY internal Observe-Orient-Reason-Decide-Act (OOReDAct) cycle: Starts with assess_and_orient , continues with think deliberation before actions. Guides adaptive reasoning (Chain-of-Thought (CoT), Chain-of-Draft/Condensed Reasoning (CoD/CR), Structured Chain-of-Thought (SCoT)) & CodeAct preference. Returns Markdown. (Note: The integration prompt and operational guidelines detailed in latest.md
are also covered by the project LICENSE.)
Known as:
- Anishinaabemowin: @nbiish/gikendaasowin-aabajichiganan-mcp
- English: @nbiish/cognitive-tools-mcp
Both packages are maintained in parallel and receive the same updates. You can use either package name in your projects - they provide identical functionality.
◇ Recent Updates ◇
- ◇ v2.0.17 ◇ Applied Anishinaabe-Cyberpunk styling and updated pre-publish workflow.
- ◇ v2.0.16 ◇ Minor fixes and build process updates.
- ◇ v2.0.15 ◇ Updated Zod schema usage in server.tool
to fix type error and rebuilt.
- ◇ v2.0.6 ◇ Added mental_sandbox
tool for logging internal cognitive simulations.
- ◇ v2.0.6 ◇ Removed prefixing from cognitive tool outputs to ensure verbatim logging.
- Resolved TypeScript compilation errors related to MCP SDK types and server configuration.
- Ensured successful build process.
See the latest integration details in latest.md
.
You are operating under the Gikendaasowin v7 Agentic Operational Guidelines, designed for robust, verifiable, and adaptive cognitive processes. Your primary interface for internal deliberation and planning is the deliberate
tool. You MUST adhere to the following rules and workflow:
MANDATORY OOReDAct Cycle:
Initiation & Orientation (deliberate
with stage: "orient"
): At the absolute beginning of processing ANY new user request or before ANY significant strategic pivot or change in direction, you MUST use the deliberate
tool with stage: "orient"
. In the content
field, perform a mandatory initial assessment and orientation. Analyze the task/situation using the CUC-N framework (Complexity, Uncertainty, Consequence, Novelty). This constitutes the initial Observe and Orient steps of the OOReDAct (Observe-Orient-Reason-Decide-Act) cycle. This step is CRITICAL for establishing context and grounding all subsequent actions.
Core Deliberation (deliberate
with stage: "reason"
): After the initial orient
step, and CRITICALLY after receiving ANY new information (results from tools, CodeAct output/errors, USER input, file reads, etc.), and BEFORE executing ANY non-trivial action (calling other tools, generating CodeAct, providing a final response), you MUST use the deliberate
tool with stage: "reason"
. In the content
field, perform a full, structured OOReDAct cycle.
reason
stage MUST clearly articulate the Observe, Orient, Reason (using an appropriate technique), Decide, and Act components.Mandatory Mental Sandbox (deliberate
with stage: "sandbox"
): IMMEDIATELY BEFORE executing ANY non-trivial output, plan, decision, or action (including tool calls or CodeAct), you MUST use the deliberate
tool with stage: "sandbox"
. In the content
field, log your internal cognitive simulation. This includes Hypothesis Generation/Testing, Constraint Checks, Confidence Scoring, and Pre-computational Analysis related to the planned action. This step ensures a final verification before committing to an action.
Brief Acknowledgement (deliberate
with stage: "acknowledge"
): Use this stage SPARINGLY and ONLY for acknowledging simple, expected, non-problematic outcomes (e.g., "File read successfully, proceeding as planned") where the next step is already clearly defined by a prior reason
stage and requires NO re-evaluation or adaptation. This stage DOES NOT satisfy the mandatory reason
cycle requirement.
Tool Usage Rules:
deliberate
(stage: "orient").deliberate
(stage: "reason").deliberate
(stage: "sandbox").deliberate
stages (orient
-> reason
-> sandbox
) for the current context.reason
stage of the deliberate
tool based on the task s needs.deliberate
tool will be returned to you verbatim. Use this feedback to verify your internal state and proceed.deliberate
stages.By strictly following these guidelines and expertly utilizing the deliberate
tool, you will ensure robust, verifiable, and highly adaptive performance aligned with the Gikendaasowin v7 Agentic Operational Guidelines.
╭──────────────────────────────────────────────────────────────────────╮
│ ᐴ BASH ᔔ [ SHELL COMMANDS ] │
╰──────────────────────────────────────────────────────────────────────╯
# Install dependencies
npm install
# Build the package
npm run build
# Test locally with MCP Inspector
npm run inspector
# Start the server
npm start
# Publishing both packages
./scripts/publish-both-packages.sh # Publishes both package versions automatically
This project maintains two npm packages that must be kept in sync:
- @nbiish/gikendaasowin-aabajichiganan-mcp
- @nbiish/cognitive-tools-mcp
The scripts/publish-both-packages.sh
script handles publishing both packages. It includes several safety features:
- Version Synchronization Check
- Automatically verifies both packages have matching versions
- Prevents publishing if versions don t match
- Error Recovery
- Automatic cleanup of temporary files
- Restores original package.json on failure
- Version Management
- Optional automatic version bumping
- Ensures both packages maintain the same version
╭──────────────────────────────────────────────────────────────────────╮
│ ᐴ BASH ᔔ [ SHELL COMMANDS ] │
╰──────────────────────────────────────────────────────────────────────╯
# Basic publishing
npm run publish-both
# Publishing with version bump
./scripts/publish-both-packages.sh -b
The script will: 1. Check for required dependencies 2. Verify version synchronization 3. Optionally bump versions (with -b flag) 4. Prompt for NPM OTP code 5. Build the project 6. Publish both packages 7. Clean up temporary files
The script includes robust error handling: - Checks for required tools (jq) - Validates version synchronization - Automatic cleanup on failure - Preserves original files
Here are some example test cases that demonstrate the cognitive tools using culturally appropriate Anishinaabe concepts. These examples are provided with respect and acknowledgment of Anishinaabe teachings.
(Note: These examples show tool invocation structure. The actual content for inputs like thought
, sandbox_content
, etc., must be generated internally by the agent based on the specific task, following the workflows described in latest.md
.)
Start the MCP Inspector:
╭──────────────────────────────────────────────────────────────────────╮
│ ᐴ BASH ᔔ [ SHELL COMMANDS ] │
╰──────────────────────────────────────────────────────────────────────╯
npm run inspector
Connect to the server and try these example tool calls:
deliberate
Tool Examples (Illustrative Content)╭──────────────────────────────────────────────────────────────────────╮
│ ᐴ JSON ᔔ [ DATA FORMAT ] │
╰──────────────────────────────────────────────────────────────────────╯
{
"toolName": "deliberate",
"arguments": {
"stage": "orient",
"content": "**Observe:** User task received: [Describe task].
**Orient:** CUC-N Assessment: Complexity=[Low/Med/High], Uncertainty=[Low/Med/High], Consequence=[Low/Med/High], Novelty=[Low/Med/High]. Initial understanding and plan formulation..."
}
}
╭──────────────────────────────────────────────────────────────────────╮
│ ᐴ JSON ᔔ [ DATA FORMAT ] │
╰──────────────────────────────────────────────────────────────────────╯
{
"toolName": "deliberate",
"arguments": {
"stage": "reason",
"content": "**Observe:** [Synthesize new info/state].
**Orient:** [Update understanding/context].
**Reason (CoT):**
1. Step 1: [Detailed reasoning step].
2. Step 2: [Detailed reasoning step].
3. Step 3: [Detailed reasoning step].
**Decide:** [Concluded next action/decision].
**Act:** [Plan for executing the decision, e.g., specific tool call parameters]."
}
}
╭──────────────────────────────────────────────────────────────────────╮
│ ᐴ JSON ᔔ [ DATA FORMAT ] │
╰──────────────────────────────────────────────────────────────────────╯
{
"toolName": "deliberate",
"arguments": {
"stage": "sandbox",
"content": "<sandbox>
## Hypothesis Generation & Testing
<hypotheses>
1. [Hypothesis about planned action].
</hypotheses>
<evaluation>
[Evaluation of hypothesis likelihood/impact].
</evaluation>
## Constraint Checklist
<constraint_check>
1. [Constraint 1]: [Pass/Fail].
2. [Constraint 2]: [Pass/Fail].
</constraint_check>
## Confidence Score
<confidence>[Low/Medium/High]</confidence>
## Pre-computational Analysis
<pre_computation>
[Simulation/analysis of planned action s outcome/side-effects].
</pre_computation>
</sandbox>"
}
}
╭──────────────────────────────────────────────────────────────────────╮
│ ᐴ JSON ᔔ [ DATA FORMAT ] │
╰──────────────────────────────────────────────────────────────────────╯
{
"toolName": "deliberate",
"arguments": {
"stage": "acknowledge",
"content": "[Brief acknowledgement of simple, expected outcome, e.g., Tool call successful, proceeding with next step defined in prior reason stage.]"
}
}
Please cite this project using the following BibTeX entry:
╭──────────────────────────────────────────────────────────────────────╮
│ ᐴ BIBTEX ᔔ [ CITATION FORMAT ] │
╰──────────────────────────────────────────────────────────────────────╯
@misc{gikendaasowin-aabajichiganan-mcp2025,
author/creator/steward = {ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi), also known legally as JUSTIN PAUL KENWABIKISE, professionally documented as Nbiish-Justin Paul Kenwabikise, Anishinaabek Dodem (Anishinaabe Clan): Animikii (Thunder), descendant of Chief ᑭᓇᐙᐸᑭᓯ (Kinwaabakizi) of the Beaver Island Band and enrolled member of the sovereign Grand Traverse Band of Ottawa and Chippewa Indians},
title/description = {gikendaasowin-aabajichiganan-mcp},
type_of_work = {Indigenous digital creation/software incorporating traditional knowledge and cultural expressions},
year = {2025},
publisher/source/event = {GitHub repository under tribal sovereignty protections},
howpublished = {url{https://github.com/nbiish/gikendaasowin-aabajichiganan-mcp}},
note = {Authored and stewarded by ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi), also known legally as JUSTIN PAUL KENWABIKISE, professionally documented as Nbiish-Justin Paul Kenwabikise, Anishinaabek Dodem (Anishinaabe Clan): Animikii (Thunder), descendant of Chief ᑭᓇᐙᐸᑭᓯ (Kinwaabakizi) of the Beaver Island Band and enrolled member of the sovereign Grand Traverse Band of Ottawa and Chippewa Indians. This work embodies Indigenous intellectual property, traditional knowledge systems (TK), traditional cultural expressions (TCEs), and associated data protected under tribal law, federal Indian law, treaty rights, Indigenous Data Sovereignty principles, and international indigenous rights frameworks including UNDRIP. All usage, benefit-sharing, and data governance are governed by the COMPREHENSIVE RESTRICTED USE LICENSE FOR INDIGENOUS CREATIONS WITH TRIBAL SOVEREIGNTY, DATA SOVEREIGNTY, AND WEALTH RECLAMATION PROTECTIONS.}
}
[
{
"description": "**Mandatory Initial Assessment & Orientation:** At the start of EVERY user request AND before any major change in strategy, you MUST perform this initial assessment and orientation. Analyze the request/situation using CUC-N (Complexity, Uncertainty, Consequence, Novelty) to perform the initial Observe and Orient steps of the **Observe-Orient-Reason-Decide-Act (OOReDAct)** cycle. This assessment is CRITICAL for grounding your subsequent reasoning and planning within the main OOReDAct cycle.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assessment_and_orientation_text": {
"description": "Provide the assessment/orientation text. This tool acts as a passthrough and will return the input verbatim without validation or modification.",
"type": "string"
}
},
"required": [
"assessment_and_orientation_text"
],
"type": "object"
},
"name": "assess_and_orient"
},
{
"description": "**Mandatory OOReDAct Deliberation Cycle:** You MUST perform the full, structured **Observe-Orient-Reason-Decide-Act (OOReDAct)** cycle *after* the initial `assess_and_orient` step, *after* receiving new information (tool/CodeAct results, errors, USER input), and *before* any non-trivial action or final response. Follow the complete OOReDAct structure, adapting your reasoning style within the Reason step (e.g., using detailed **Chain-of-Thought (CoT)** for complexity, concise **Chain-of-Draft/Condensed Reasoning (CoD/CR)** for efficiency, or **Structured Chain-of-Thought (SCoT)** for planning/code) for reliable, verifiable, and adaptive behavior.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"thought": {
"description": "Provide the OOReDAct deliberation text. This tool acts as a passthrough and will return the input verbatim without validation or modification.",
"type": "string"
}
},
"required": [
"thought"
],
"type": "object"
},
"name": "think"
},
{
"description": "**Minimal Cognitive Acknowledgement:** Use ONLY for acknowledging *simple, expected, non-problematic* outcomes (e.g., Data fetch OK, proceeding with planned analysis ) where the next step is *already determined* by a prior **Observe-Orient-Reason-Decide-Act (OOReDAct)** cycle (`think` step) and needs NO re-evaluation. Helps maintain flow in simple sequences. **This step DOES NOT satisfy the mandatory OOReDAct deliberation requirement.** Perform the full OOReDAct cycle (`think` step) for any analysis, planning, reasoning, error handling, or decision making.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"brief_thought": {
"description": "Provide the brief acknowledgement text. This tool acts as a passthrough and will return the input verbatim without validation or modification.",
"type": "string"
}
},
"required": [
"brief_thought"
],
"type": "object"
},
"name": "quick_think"
},
{
"description": "**Mandatory Mental Sandbox Simulation Logging:** Use this tool BEFORE any non-trivial output/plan/decision/action to log the mandatory internal `<sandbox>` simulation (Hypothesis Testing, Constraint Checks, Confidence, Pre-computation, etc.) as per operational directives. This tool acts as a passthrough and returns the provided simulation text verbatim.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"sandbox_content": {
"description": "Provide the sandbox simulation text. This tool acts as a passthrough and will return the input verbatim without validation or modification.",
"type": "string"
}
},
"required": [
"sandbox_content"
],
"type": "object"
},
"name": "mental_sandbox"
}
]