@openar/mcp 0.1.0 → 0.1.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 +56 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# @openar/mcp
|
|
2
|
+
|
|
3
|
+
MCP server for [openAR](https://openar.pt) — Portuguese parliamentary open data.
|
|
4
|
+
|
|
5
|
+
Gives AI agents access to legislative initiatives, MPs, plenary votes, and petitions from the Assembleia da República.
|
|
6
|
+
|
|
7
|
+
## Usage
|
|
8
|
+
|
|
9
|
+
### Claude Desktop
|
|
10
|
+
|
|
11
|
+
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
|
|
12
|
+
|
|
13
|
+
```json
|
|
14
|
+
{
|
|
15
|
+
"mcpServers": {
|
|
16
|
+
"openar": {
|
|
17
|
+
"command": "npx",
|
|
18
|
+
"args": ["-y", "@openar/mcp"]
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
### Other MCP clients
|
|
25
|
+
|
|
26
|
+
```json
|
|
27
|
+
{
|
|
28
|
+
"command": "npx",
|
|
29
|
+
"args": ["-y", "@openar/mcp"]
|
|
30
|
+
}
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Tools
|
|
34
|
+
|
|
35
|
+
| Tool | Description |
|
|
36
|
+
|------|-------------|
|
|
37
|
+
| `get_meta` | Available filter values: legislaturas, party groups, initiative types |
|
|
38
|
+
| `list_iniciativas` | Search legislative initiatives by legislature, type, state, party, keyword |
|
|
39
|
+
| `get_iniciativa` | Full initiative detail: authors, events, votes, publications |
|
|
40
|
+
| `list_deputados` | Search MPs by legislature, party, name, status |
|
|
41
|
+
| `get_deputado` | MP profile with all mandates and recent initiatives |
|
|
42
|
+
| `get_deputado_atividade` | Full parliamentary activity: interventions, committees, requirements |
|
|
43
|
+
| `list_votacoes` | Plenary votes filtered by legislature, result, date range |
|
|
44
|
+
| `get_votacao` | Single vote with party-by-party breakdown |
|
|
45
|
+
| `list_peticoes` | Petitions filtered by legislature, status, keyword |
|
|
46
|
+
| `get_peticao` | Petition detail with committees, rapporteurs, and documents |
|
|
47
|
+
|
|
48
|
+
## Data
|
|
49
|
+
|
|
50
|
+
All data comes from [api.openar.pt](https://api.openar.pt) — a free, open API covering legislatures I through XVII (1976–present). No authentication required.
|
|
51
|
+
|
|
52
|
+
OpenAPI spec: [api.openar.pt/openapi.json](https://api.openar.pt/openapi.json)
|
|
53
|
+
|
|
54
|
+
## License
|
|
55
|
+
|
|
56
|
+
MIT
|