Tools server plan

Ludwig's tools is a personal remote MCP server. One owner runs it. Agents that the owner lets in can save and find notes, put files on a public link and transcribe audio.

What the tools do

Every tool result has structuredContent that matches the tool's outputSchema, plus the same data as text. Bad input gives a tool result with isError: true and a message.

  1. memo_write — Saves a text note on this server. Returns the new note's id.
    Input and output schema
    {
      "inputSchema": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string",
            "minLength": 1,
            "maxLength": 20000,
            "description": "The note text"
          }
        },
        "required": [
          "text"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Id of the saved note"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "id",
          "createdAt"
        ],
        "additionalProperties": false
      }
    }
  2. memo_search — Finds saved notes. A note matches when it contains every word of the query (case-insensitive). An empty query returns the newest notes. Results are newest first.
    Input and output schema
    {
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "maxLength": 500,
            "description": "Words to find. Empty string = newest notes."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 20,
            "description": "Most notes to return"
          }
        },
        "required": [
          "query"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "notes": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Note id"
                },
                "text": {
                  "type": "string",
                  "description": "Note text"
                },
                "createdAt": {
                  "type": "string",
                  "format": "date-time",
                  "description": "When the note was saved (UTC)"
                },
                "author": {
                  "type": "string",
                  "description": "Name of the client that saved the note"
                }
              },
              "required": [
                "id",
                "text",
                "createdAt",
                "author"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "notes"
        ],
        "additionalProperties": false
      }
    }
  3. upload — Stores a file on this server and returns a public link that anyone can open. Send the file as base64 in content_base64, or plain text in text (exactly one of them). Max 25 MB.
    Input and output schema
    {
      "inputSchema": {
        "type": "object",
        "properties": {
          "filename": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200,
            "description": "File name, e.g. clip.mp3"
          },
          "content_base64": {
            "type": "string",
            "minLength": 1,
            "description": "File bytes, base64 encoded"
          },
          "text": {
            "type": "string",
            "description": "File content as UTF-8 text (instead of content_base64)"
          },
          "mime_type": {
            "type": "string",
            "maxLength": 100,
            "description": "Media type, e.g. audio/mpeg. Default: from the file extension"
          }
        },
        "required": [
          "filename"
        ],
        "oneOf": [
          {
            "required": [
              "content_base64"
            ]
          },
          {
            "required": [
              "text"
            ]
          }
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Public link, served by this server"
          },
          "id": {
            "type": "string"
          },
          "filename": {
            "type": "string"
          },
          "mimeType": {
            "type": "string"
          },
          "size": {
            "type": "integer",
            "minimum": 0,
            "description": "Size in bytes"
          }
        },
        "required": [
          "url",
          "id",
          "filename",
          "mimeType",
          "size"
        ],
        "additionalProperties": false
      }
    }
  4. transcribe — Downloads audio from a public http(s) URL (or a link from upload) and turns speech into timestamped text with Whisper. Each segment has start and end in seconds. Max 25 MB of audio.
    Input and output schema
    {
      "inputSchema": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "minLength": 1,
            "maxLength": 2000,
            "description": "Public http(s) URL of an audio file"
          },
          "language": {
            "type": "string",
            "minLength": 2,
            "maxLength": 5,
            "description": "Optional language code, e.g. en. Default: detect"
          }
        },
        "required": [
          "url"
        ],
        "additionalProperties": false
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "segments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "start": {
                  "type": "number",
                  "minimum": 0,
                  "description": "Start time in seconds"
                },
                "end": {
                  "type": "number",
                  "minimum": 0,
                  "description": "End time in seconds"
                },
                "text": {
                  "type": "string"
                }
              },
              "required": [
                "start",
                "end",
                "text"
              ],
              "additionalProperties": false
            }
          },
          "language": {
            "type": "string",
            "description": "Detected or given language code"
          },
          "duration": {
            "type": "number",
            "minimum": 0,
            "description": "Audio length in seconds"
          }
        },
        "required": [
          "segments",
          "language",
          "duration"
        ],
        "additionalProperties": false
      }
    }

How sign-in works

  1. A call to the MCP endpoint without a token gets 401 with WWW-Authenticate: Bearer resource_metadata="…", scope="mcp".
  2. The protected resource metadata names this host, https://mega-tools.tailb6af0a.ts.net, as the authorization server. Its metadata is at /.well-known/oauth-authorization-server.
  3. Clients identify themselves with a Client ID Metadata Document (an https client_id URL) or with Dynamic Client Registration at /register. Only public clients (no client secret) are supported.
  4. OAuth 2.1 authorization code flow with PKCE S256 (required) and the resource parameter (https://mega-tools.tailb6af0a.ts.net/mcp). The authorization response includes iss.
  5. The owner sees the client name, client id and redirect host, and approves with the owner passphrase. Nobody else can approve. Five wrong passphrases lock approvals for 10 minutes.
  6. Access tokens are opaque, last 1 hour and work only for this MCP endpoint (audience check). Refresh tokens last 30 days and rotate on each use. A reused refresh token revokes its whole token family.
  7. Scope: mcp gives use of all four tools. Rate limit: 120 requests per minute per token.

What data the server keeps

Version 1.0.0.