Skip to content

Commit 97d21cc

Browse files
aborrusoclaude
aborruso
and
claude
committed
docs: add privacy policy and submission examples for Anthropic directory
- PRIVACY.md: minimal privacy policy (server collects no data) - README.md: add Privacy Policy section - manifest.json: add privacy_policies array - docs/submission-examples.md: 3 tested working examples Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 7e51255 commit 97d21cc

4 files changed

Lines changed: 193 additions & 0 deletions

File tree

‎PRIVACY.md‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# Privacy Policy
2+
3+
**Last updated: 2026-03-07**
4+
5+
## Overview
6+
7+
CKAN MCP Server is a read-only, stateless tool that connects AI assistants to public CKAN open data portals. It does not collect, store, or transmit any personal data.
8+
9+
## Data Collection
10+
11+
This server collects **no personal data**. Specifically:
12+
13+
- No user information is collected or stored
14+
- No conversation content is logged or retained
15+
- No analytics or telemetry are sent
16+
- No cookies or tracking mechanisms are used
17+
18+
## How It Works
19+
20+
When you use this server, it forwards your queries directly to the public API of the CKAN portal you specify (e.g., `dati.gov.it`, `data.gov`). The server acts as a transparent proxy — it does not store, analyze, or process query results beyond returning them to your AI client.
21+
22+
All data accessed through this server is **publicly available** on the respective CKAN portals. No authentication credentials are required or handled.
23+
24+
## Third-Party Services
25+
26+
Queries are sent to the CKAN portal you configure (e.g., `https://dati.gov.it`, `https://catalog.data.gov`). Those portals have their own privacy policies and terms of use.
27+
28+
## Open Source
29+
30+
This server is fully open source. You can review the complete source code at:
31+
https://github.com/ondata/ckan-mcp-server
32+
33+
## Contact
34+
35+
For questions about this privacy policy, open an issue at:
36+
https://github.com/ondata/ckan-mcp-server/issues

‎README.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -817,6 +817,14 @@ For issues or questions, [open an issue on GitHub](https://github.com/ondata/cka
817817

818818
---
819819

820+
## Privacy Policy
821+
822+
This server collects no personal data. It is read-only and stateless — queries are forwarded directly to the public CKAN API you specify, and no data is stored or logged.
823+
824+
See the full [Privacy Policy](https://github.com/ondata/ckan-mcp-server/blob/main/PRIVACY.md).
825+
826+
---
827+
820828
## 🔗 Useful Links
821829

822830
- [CKAN](https://ckan.org/) — the open-source platform behind most public open data portals

‎docs/submission-examples.md‎

Lines changed: 144 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,144 @@
1+
# Submission Examples
2+
3+
Three working examples for the Anthropic Connectors Directory submission form.
4+
Each example shows a natural language prompt, which tool Claude invokes, and the actual output.
5+
6+
---
7+
8+
## Example 1 — Journalist searching for open data on a topic
9+
10+
**Persona**: Journalist or citizen wanting to find relevant datasets without knowing the portal structure.
11+
12+
**User prompt**:
13+
> What open data about air quality is available on Italy's national open data portal?
14+
15+
**Tool invoked**: `ckan_find_relevant_datasets`
16+
17+
**Arguments**:
18+
```json
19+
{
20+
"server_url": "https://www.dati.gov.it/opendata",
21+
"query": "air quality pollution monitoring",
22+
"limit": 5
23+
}
24+
```
25+
26+
**Output** (excerpt):
27+
28+
```
29+
# Relevant CKAN Datasets
30+
31+
Server: https://www.dati.gov.it/opendata
32+
Query: air quality pollution monitoring
33+
34+
| Rank | Dataset | Score | Title | Org | Tags |
35+
|------|--------------------------------------------|-------|--------------------------------------------------|-----------------|-----------------------------------|
36+
| 1 | impianti-industriali-soggetti-ad-aia | 3 | Impianti industriali soggetti ad AIA | GeoDati - RNDT | air, air-pollution, air-quality |
37+
| 2 | qualita-dellaria-campioni-inquinanti-dataset | 3 | Qualità dell'Aria Campioni inquinanti - Dataset | GeoDati - RNDT | air-quality, aqd |
38+
```
39+
40+
**Why it's useful**: No CKAN knowledge required. Claude translates a natural language topic into a ranked search across titles, descriptions, tags, and organizations.
41+
42+
---
43+
44+
## Example 2 — Policy analyst exploring a national portal
45+
46+
**Persona**: Public servant, researcher, or journalist wanting a quick overview of what a portal contains.
47+
48+
**User prompt**:
49+
> Give me an overview of Italy's national open data portal — how many datasets, main categories, most common formats, most active organizations.
50+
51+
**Tool invoked**: `ckan_catalog_stats`
52+
53+
**Arguments**:
54+
```json
55+
{
56+
"server_url": "https://www.dati.gov.it/opendata"
57+
}
58+
```
59+
60+
**Output** (excerpt):
61+
62+
```
63+
# CKAN Portal Statistics
64+
65+
Server: https://www.dati.gov.it/opendata
66+
Total datasets: 69,476
67+
68+
## Categories
69+
- governo: 35,502
70+
- societa: 9,072
71+
- ambiente: 8,971
72+
- economia: 6,778
73+
- regioni: 4,929
74+
75+
## Formats
76+
- CSV: 44,208
77+
- JSON: 14,973
78+
- ZIP: 11,578
79+
- XML: 11,563
80+
81+
## Top Organizations
82+
- regione-toscana: 12,735
83+
- geodati-gov-it-rndt: 8,686
84+
- regione-veneto: 6,568
85+
```
86+
87+
**Why it's useful**: A single prompt gives a complete, structured overview of a portal — useful for deciding where to invest research time or assessing a portal's openness.
88+
89+
---
90+
91+
## Example 3 — Data analyst querying tabular data directly
92+
93+
**Persona**: Data analyst or developer who wants to inspect actual records from a dataset without downloading files.
94+
95+
**User prompt**:
96+
> Show me the latest municipal ordinances published by the City of Messina.
97+
98+
**Tool invoked**: `ckan_datastore_search`
99+
100+
**Arguments**:
101+
```json
102+
{
103+
"server_url": "https://dati.comune.messina.it",
104+
"resource_id": "17301b8b-2a5b-425f-80b0-5b75bb1793e9",
105+
"limit": 5
106+
}
107+
```
108+
109+
**Output** (excerpt):
110+
111+
```
112+
# DataStore Query Results
113+
114+
Server: https://dati.comune.messina.it
115+
Total Records: 2,066 | Returned: 5
116+
117+
## Fields
118+
- numero (numeric), data_pubblicazione (timestamp), inizio_validita (text),
119+
fine_validita (text), aree (text), tipo (text), sintesi (text)
120+
121+
## Records
122+
123+
| numero | data_pubblicazione | aree | tipo | sintesi |
124+
|--------|---------------------|-------------------------------|-------------------------------|--------------------------|
125+
| 382 | 2026-03-06 | Via Garibaldi; Viale Boccetta | lavori; divieto_sosta | Richiesta ordinanza ... |
126+
| 381 | 2026-03-06 | Via Maddalena; Viale S.Martino| lavori; divieto_sosta | Occupazione temporane... |
127+
| 380 | 2026-03-06 | Viale Europa; Via G. Pilli | lavori; divieto_transito | Reti Infrastruttura D... |
128+
129+
More results available: use offset: 5 for next page.
130+
```
131+
132+
**Why it's useful**: Claude can query tabular data from any CKAN DataStore resource with SQL-like filtering, pagination, and field selection — turning a portal into a live database accessible through natural language.
133+
134+
---
135+
136+
## Summary
137+
138+
| Example | Portal | Tool | Persona |
139+
|---------|--------|------|---------|
140+
| 1 — Find datasets by topic | dati.gov.it (IT) | `ckan_find_relevant_datasets` | Journalist / citizen |
141+
| 2 — Portal overview | dati.gov.it (IT) | `ckan_catalog_stats` | Policy analyst / researcher |
142+
| 3 — Query tabular data | dati.comune.messina.it (IT) | `ckan_datastore_search` | Data analyst / developer |
143+
144+
All examples tested against live CKAN portals on 2026-03-07.

‎manifest.json‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,11 @@
1515
},
1616
"license": "MIT",
1717
"keywords": ["ckan", "open-data", "data-portal"],
18+
"privacy_policies": [
19+
{
20+
"url": "https://github.com/ondata/ckan-mcp-server/blob/main/PRIVACY.md"
21+
}
22+
],
1823
"icon": "icon.png",
1924
"server": {
2025
"type": "node",

0 commit comments

Comments
 (0)