Misc MCP Server — Tools Index

Current deployed tool catalogue for Misc 2.0.0 on gravlax. Authenticated discovery confirmed hello, pg_query, check, webdav, email_send, email_list, email_read, email_list_folders and six Outlook tools.

Architecture and deployment: misc-server

hello

Returns the string "hello". Placeholder tool — demonstrates the server is working and connected. No arguments. Points to main misc-server documentation.

pg_query

Executes one SQL statement against the OwnTracks database on gravlax. Optional login defaults to owntracks_ro; owntracks_rw enables writes and owntracks_adm adds CREATE and permitted ALTER operations. PostgreSQL enforces privileges. Returns JSON row arrays or command status. Use an explicit LIMIT; no 500-row cap is enforced.

Deployed architecture: one asyncpg pool per login (min=1, max=3), with failed pool creation logged so unrelated tools remain available. The observed October SELECT-only regression has been repaired; its original cause remains unverified.

Full details and examples: location-db/usage

Schema reference: location-db/schema

Architecture details: location-db/architecture

The server does not retry SQL automatically. The requesting LLM decides whether to retry after inspecting the error. "Please try again" is generic error text, not proof of a stale connection. For a write with an uncertain outcome, check the resulting state before repeating it.

Email Tools (4 tools)

Mail tools read via IMAP at mail.critchley.biz and send by uploading an RFC message to https://webdav.critchley.biz/mail/envoy/new/. Sending does not use SMTP in the inspected pomelo or merged implementation.

Available tools:

Complete documentation, testing workflows, and envoy integration examples: misc-server/email-tools

Adding New Tools

Edit misc_mcp_server.py in /home/john/py/gdata-server/. In _make_tool_server(), add a types.Tool entry to list_tools(), and add a handler branch in call_tool(). Include a notes key in the tool description pointing to documentation.

Restart: sudo systemctl restart misc-mcp-server

Outlook/Hotmail Tools (6 tools)

Read-only OAuth2 tools for the jsr_critchley@hotmail.com mailbox. Use outlook_search to find messages by folder, sender, recipient, subject, body text, date, or unread state; then use outlook_read with the returned folder and stable UID. outlook_folders and outlook_status provide discovery and counts.Also deployed: outlook_list_parts and outlook_read_part. All six tools were confirmed by authenticated MCP discovery.

Complete parameters, examples, UID semantics, security guarantees, authentication, and troubleshooting: misc-server/outlook-mail.

MCP server version

Current deployed MCP server version: 2.0.0, verified through serverInfo.version during authenticated initialization after restart. Version is set in _make_tool_server(): Server('misc', version='2.0.0'). Bump the explicit version with client-visible changes independently of SDK upgrades. A session retaining the old sql-only schema may need connector refresh/reconnection.

WebDAV (deployed)

webdav is deployed in Misc 2.0.0 and retains read/write/list/copy/move/delete, properties and locks. The missing misc_webdav.py dependency was installed on gravlax; live discovery confirmed the tool. Mocked HTTP regression tests passed; no live WebDAV mutation was performed during this deployment. Usage: Misc WebDAV tool.

Deployment, verification and source synchronization record (2026-10-12): Misc reconciliation and deployment record. Current version 2.0.0; GitHub origin/m commit c0b4fec. Gravlax service restarted and verified. Offline tests: 154 passed, 16 version-specific skips.

Monitoring (deployed)

check is deployed in Misc 2.0.0 and was confirmed by authenticated discovery. SQL monitoring uses the read-only pool. Usage: Location database monitoring.

version 7  ·  updated 2026-10-12