senado-br-mcp 3.3.0 → 3.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -94,6 +94,18 @@ list/corpus tools: without D1 they fall back to a live scrape of the ~5 REST hig
94
94
  `meta.fonte` / `possivelDesatualizacao`; the detail tools (`obter_*`) are identical. Logs go to
95
95
  **stderr** — stdout carries only the JSON-RPC protocol stream.
96
96
 
97
+ ## Agent Skill (optional)
98
+
99
+ This repo bundles a Claude [Agent Skill](https://platform.claude.com/docs/en/docs/agents-and-tools/agent-skills/overview)
100
+ at [`.claude/skills/senado-br/`](.claude/skills/senado-br/SKILL.md) that teaches Claude **when** to reach for
101
+ this server and **how** to use its 66 tools well — a themed tool map, common question→tool playbooks, the
102
+ provenance contract, and gotchas (dates, the `codigoMateria` bridge, e-Cidadania's open-set listing, pagination).
103
+ It points back to the server's own `senado://catalogo` / `senado://guia` resources rather than duplicating them.
104
+
105
+ Claude Code auto-discovers it when you work in this repo. To use it elsewhere, copy
106
+ `.claude/skills/senado-br/` into your `~/.claude/skills/`, or zip the folder and upload it in claude.ai
107
+ (Settings → Features). The skill assumes the `senado-br` MCP server is connected (hosted or via npx).
108
+
97
109
  ## Architecture
98
110
 
99
111
  - **Runtime:** Cloudflare Workers (ESM)
package/README.pt-BR.md CHANGED
@@ -93,6 +93,19 @@ as ferramentas de lista/corpus do e-Cidadania: sem D1, elas caem no scraping ao
93
93
  REST, sinalizado por `meta.fonte` / `possivelDesatualizacao`; as de detalhe (`obter_*`) são idênticas.
94
94
  Os logs vão para o **stderr** — o stdout carrega apenas o fluxo do protocolo JSON-RPC.
95
95
 
96
+ ## Agent Skill (opcional)
97
+
98
+ Este repositório inclui uma [Agent Skill](https://platform.claude.com/docs/en/docs/agents-and-tools/agent-skills/overview)
99
+ do Claude em [`.claude/skills/senado-br/`](.claude/skills/senado-br/SKILL.md) que ensina o Claude **quando**
100
+ recorrer a este servidor e **como** usar bem as 66 ferramentas — um mapa de ferramentas por tema, playbooks de
101
+ pergunta→ferramenta, o contrato de proveniência e os gotchas (datas, a ponte `codigoMateria`, a listagem
102
+ só-abertas do e-Cidadania, paginação). Ela aponta para os recursos `senado://catalogo` / `senado://guia` do
103
+ próprio servidor em vez de duplicá-los.
104
+
105
+ O Claude Code a descobre automaticamente ao trabalhar neste repositório. Para usá-la em outro lugar, copie
106
+ `.claude/skills/senado-br/` para o seu `~/.claude/skills/`, ou compacte a pasta e faça upload no claude.ai
107
+ (Configurações → Recursos). A skill pressupõe o servidor MCP `senado-br` conectado (hospedado ou via npx).
108
+
96
109
  ## Arquitetura
97
110
 
98
111
  - **Runtime:** Cloudflare Workers (ESM)
package/dist/version.js CHANGED
@@ -1,2 +1,2 @@
1
1
  /** Single source of truth for the server version (kept in sync with package.json). */
2
- export const VERSION = "3.3.0";
2
+ export const VERSION = "3.3.1";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "senado-br-mcp",
3
- "version": "3.3.0",
3
+ "version": "3.3.1",
4
4
  "description": "MCP server for Brazilian Senate open data — runs hosted on Cloudflare Workers or locally via npx (stdio)",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -29,12 +29,12 @@
29
29
  },
30
30
  "dependencies": {
31
31
  "@modelcontextprotocol/sdk": "^1.26.0",
32
- "agents": "^0.5.0",
33
32
  "zod": "^3.23.0"
34
33
  },
35
34
  "devDependencies": {
36
35
  "@cloudflare/workers-types": "^4.20250214.0",
37
36
  "@types/node": "^25.9.3",
37
+ "agents": "^0.5.0",
38
38
  "exceljs": "^4.4.0",
39
39
  "tsx": "^4.19.2",
40
40
  "typescript": "^5.7.0",