From db90d2d822c4ac92ff03f2201a5e5d8f2b356385 Mon Sep 17 00:00:00 2001 From: pratiksha badheka Date: Wed, 9 Sep 2026 05:55:15 -0700 Subject: [PATCH 1/3] docs(education): add MCP server to glossary Why: the glossary defines Agent and Skill but never MCP server, even though skills rely on MCP servers to reach external tools like GitHub, Slack, and Gmail. Adds a plain-English definition consistent with the existing glossary style, placed after "Skill" since MCP is what a skill uses to act on the outside world. --- .markdownlint.json | 4 +++- docs/education/README.md | 7 +++++++ 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/.markdownlint.json b/.markdownlint.json index 5447c37ce..1ed822087 100644 --- a/.markdownlint.json +++ b/.markdownlint.json @@ -4,13 +4,15 @@ "default": true, "MD004": false, - "MD007": false, + "MD005": true, + "MD007": true, "MD013": false, "MD018": false, "MD022": false, "MD024": { "siblings_only": true }, "MD028": false, "MD029": false, + "MD030": true, "MD031": false, "MD032": false, "MD033": false, diff --git a/docs/education/README.md b/docs/education/README.md index 443a56171..25e9abff8 100644 --- a/docs/education/README.md +++ b/docs/education/README.md @@ -59,6 +59,13 @@ New to AI, or to these words? Here is what they mean in Magpie: - **Prompt**: the written instructions you give the model. - **Skill**: a text file that tells the agent how to do one job, with instructions and examples. In Magpie, writing skills is the main work. +- **MCP server**: a small running program that connects an agent to one +external service — like GitHub, Slack, or Gmail — using a shared set of +rules (the Model Context Protocol, or MCP) instead of custom one-off code +for each service. The agent acts as a *client*: it sends the MCP server +requests like "list open issues" or "post this message," and the server +carries that action out against the real service. Agents find the right +MCP server through a config file the runtime reads at startup. - **Deterministic and probabilistic**: normal code is *deterministic*, so the same input always gives the same result. An agent is *probabilistic*, so the same input can give slightly different results each time. From 65079b07562713f683a9e05da13dd2d35891a0c0 Mon Sep 17 00:00:00 2001 From: pratiksha badheka Date: Wed, 9 Sep 2026 06:15:01 -0700 Subject: [PATCH 2/3] docs(education):add 2 space in doc paraghraph why:make it proper style --- docs/education/README.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/education/README.md b/docs/education/README.md index 25e9abff8..596f90ba0 100644 --- a/docs/education/README.md +++ b/docs/education/README.md @@ -60,12 +60,12 @@ New to AI, or to these words? Here is what they mean in Magpie: - **Skill**: a text file that tells the agent how to do one job, with instructions and examples. In Magpie, writing skills is the main work. - **MCP server**: a small running program that connects an agent to one -external service — like GitHub, Slack, or Gmail — using a shared set of -rules (the Model Context Protocol, or MCP) instead of custom one-off code -for each service. The agent acts as a *client*: it sends the MCP server -requests like "list open issues" or "post this message," and the server -carries that action out against the real service. Agents find the right -MCP server through a config file the runtime reads at startup. + external service — like GitHub, Slack, or Gmail — using a shared set of + rules (the Model Context Protocol, or MCP) instead of custom one-off code + for each service. The agent acts as a *client*: it sends the MCP server + requests like "list open issues" or "post this message," and the server + carries that action out against the real service. Agents find the right + MCP server through a config file the runtime reads at startup. - **Deterministic and probabilistic**: normal code is *deterministic*, so the same input always gives the same result. An agent is *probabilistic*, so the same input can give slightly different results each time. From c5e9e0f08028075b8a168dfcd0e4e64ff1543611 Mon Sep 17 00:00:00 2001 From: pratiksha badheka Date: Wed, 9 Sep 2026 06:24:13 -0700 Subject: [PATCH 3/3] chore(markdownlint.json):revert accidenlty markdown lintfile edit why: the file was accidently commited so revert it and commit with no functional change --- .markdownlint.json | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/.markdownlint.json b/.markdownlint.json index 1ed822087..5447c37ce 100644 --- a/.markdownlint.json +++ b/.markdownlint.json @@ -4,15 +4,13 @@ "default": true, "MD004": false, - "MD005": true, - "MD007": true, + "MD007": false, "MD013": false, "MD018": false, "MD022": false, "MD024": { "siblings_only": true }, "MD028": false, "MD029": false, - "MD030": true, "MD031": false, "MD032": false, "MD033": false,