Schema First — personal MCP tools

A remote MCP server owned by Dawid, built for MEGA.dev S02E03. Endpoint: /mcp. Protocols: 2026-07-28 and 2025-11-25.

Plan and purpose

One home for a shared notebook, public file uploads, and local audio transcription. Every successful tool result is structured JSON matching its declared output schema.

Sign-in and authorization

OAuth authorization code with PKCE S256. Clients discover protected-resource metadata and this authorization server. Client metadata documents and dynamic registration are supported. Registration alone grants no access. On each consent page, the owner checks the client identity, redirect hostname, and requested scope, then enters their owner password and explicitly approves. The mcp scope allows all four tools and access to the same shared notebook. Do not approve clients you do not trust with all existing notes. Access tokens last one hour; rotating refresh tokens last seven days. Tokens are bound to this MCP endpoint and are never forwarded to other services.

Tools

memo_write

Save a plain-text note in the owner's shared notebook. Authorized clients can search it later. Notes persist until the owner deletes them.

Input and output schemas
{
  "inputSchema": {
    "type": "object",
    "properties": {
      "text": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100000
      }
    },
    "required": [
      "text"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "minLength": 1
      }
    },
    "required": [
      "id"
    ],
    "additionalProperties": false
  }
}

memo_search

Find notes in the owner's shared notebook by case-insensitive literal substring, newest first. An empty query lists notes. Returns at most the newest 100 matches.

Input and output schemas
{
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "maxLength": 1000
      }
    },
    "required": [
      "query"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "notes": {
        "type": "array",
        "maxItems": 100,
        "items": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "text": {
              "type": "string"
            },
            "created_at": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "text",
            "created_at"
          ],
          "additionalProperties": false
        }
      }
    },
    "required": [
      "notes"
    ],
    "additionalProperties": false
  }
}

upload

Publish a file on this server. Provide a filename and base64-encoded file bytes (maximum decoded size 10 MiB). The returned URL is public: anyone holding the link can download the bytes until the owner deletes the file. Do not upload secrets.

Input and output schemas
{
  "inputSchema": {
    "type": "object",
    "properties": {
      "filename": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      },
      "content_base64": {
        "type": "string",
        "minLength": 0,
        "maxLength": 13981016
      },
      "mime_type": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100,
        "default": "application/octet-stream"
      }
    },
    "required": [
      "filename",
      "content_base64"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "url": {
        "type": "string",
        "format": "uri",
        "pattern": "^https://"
      }
    },
    "required": [
      "url"
    ],
    "additionalProperties": false
  }
}

transcribe

Fetch audio from a public HTTPS URL and transcribe spoken words into timestamped segments. start is measured in seconds from the beginning. Private-network URLs are forbidden. Backend and retention policy are documented on the plan page.

Input and output schemas
{
  "inputSchema": {
    "type": "object",
    "properties": {
      "url": {
        "type": "string",
        "format": "uri",
        "pattern": "^https://",
        "maxLength": 4096
      }
    },
    "required": [
      "url"
    ],
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "segments": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "start": {
              "type": "number",
              "minimum": 0
            },
            "text": {
              "type": "string"
            }
          },
          "required": [
            "start",
            "text"
          ],
          "additionalProperties": false
        }
      }
    },
    "required": [
      "segments"
    ],
    "additionalProperties": false
  }
}

Data and retention

Machine-readable tool schemas · MCP specification