Documentation index: llms.txt. Markdown versions available by appending .md.
Istruzione Messina MCP
The public-content MCP connector has two endpoints:
- Public endpoint:
https://istruzionemessina.it/mcp. - Authenticated endpoint:
https://istruzionemessina.it/mcp/connect.
The authenticated endpoint accepts POST using Streamable HTTP and stateless JSON responses. GET streaming is not supported. Send initialize, then notifications/initialized, then tools/list or tools/call. No session ID is needed.
Authentication and limits
The /mcp/connect endpoint requires an API key. Ask the site operator privately for one. Set it in the MCP client's environment as MCP_CONNECT_API_KEY, then send either Authorization: Bearer <key> or x-api-key: <key>. If both are present, Authorization takes precedence. Never put the key in a URL.
The connector reads public content only. It does not expose private data, orders, or administrative functions. The authenticated endpoint allows 60 requests per minute per key. Missing or invalid keys receive 401 JSON. A rate limit receives 429 JSON and Retry-After. Browser OPTIONS preflight does not require a key. Honor Retry-After and do not change networks or accounts to evade limits.
Tools
| Tool | Purpose |
|---|---|
list_public_content | List entries in the public content index. |
search_public_content | Search public content. Requires query. |
analyze_public_page | Read public page text and statistics. Requires path. |
Example request
After initialization, call a tool with JSON-RPC over HTTPS:
curl https://istruzionemessina.it/mcp/connect \
-A 'OpenAI File Downloader, XaiImageApiFetch/1.0' \
-H "Authorization: Bearer $MCP_CONNECT_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-06-18" \
--data '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_public_content","arguments":{"query":"angel number"}}}'
Keep the key in a secure client environment and do not paste a real key into a command, URL, or shared log.