Documentation index: llms.txt. Markdown versions available by appending .md.

Istruzione Messina MCP

The public-content MCP connector has two endpoints:

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

ToolPurpose
list_public_contentList entries in the public content index.
search_public_contentSearch public content. Requires query.
analyze_public_pageRead 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.