Misc MCP Server — Tools Index

All tools available in the misc MCP connector. Each tool description includes a notes key for detailed documentation.

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.

Architecture: one asyncpg pool per login (min=1, max=3 each), created at process startup. Deployed and restarted on gravlax on 2026-09-18; live MCP checks verified the default and all three logins.

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)

Suite of tools for email management via local mail server (mail.critchley.biz). Support both IMAP (reading) and Brevo SMTP (sending). Designed for testing and integrating envoy orchestrator workflows.

Available tools:

- email_send: Send email to mailbox (to, subject, body, optional headers)- email_list: List emails in folder with headers (folder, search_criteria, max_results)- email_read: Read full email with body and all headers (seq_id, folder)- email_list_folders: List all mailbox folders (no arguments)

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

version 2  ·  updated 2026-09-18