jd-mcp — plan
A personal remote MCP server on mcp.merkelhub.de. One owner. Four tools.
Endpoint
MCP endpoint: https://mcp.merkelhub.de/mcp (Streamable HTTP). It speaks MCP revision 2026-07-28 (stateless, server/discover) and also answers 2025-11-25 and older clients.
Tools
| Tool | Input | Result | What it does |
|---|---|---|---|
memo_write | { text } | { id, created_at } | Saves a text note. |
memo_search | { query, limit? } | { notes: [{ id, text, created_at }] } | Finds notes that contain every word of the query (case-insensitive), newest first. Empty query lists the newest notes. |
upload | { filename?, content_base64 | text | source_url, mime_type? } | { url, id, filename, mime_type, size, sha256 } | Stores a file and returns a link under https://mcp.merkelhub.de/files/… that anyone with the link can open. Limit 25 MB. |
transcribe | { url, language?, prompt? } | { segments: [{ start, end, text }], text, language?, duration? } | Turns speech in an audio file at a URL into timestamped text; start/end in seconds. Uses the OpenAI transcription API (whisper-1). |
Every tool declares an output schema; results come back as structuredContent matching it, plus the same JSON as text.
Sign-in
The server is an OAuth 2.1 protected resource with its own authorization server on the same host.
- Discovery: protected resource metadata at
/.well-known/oauth-protected-resource/mcp(RFC 9728), authorization server metadata at/.well-known/oauth-authorization-server(RFC 8414). A call to/mcpwithout a token gets401with aWWW-Authenticateheader that points to the metadata. - Client registration: Client ID Metadata Documents (an https URL as
client_id) or Dynamic Client Registration at/register. - Flow: authorization code with PKCE (
S256only),resourceindicator (RFC 8707) bound tohttps://mcp.merkelhub.de/mcp,issin the authorization response (RFC 9207). Scope:mcp. - Who gets in: only clients the owner approves. The consent page shows the client and where it returns to; approval needs the owner passphrase. Five wrong tries lock the page for 15 minutes.
- Tokens: opaque bearer tokens, access 1 hour, refresh 30 days with rotation (reuse revokes the grant). Revoke at
/revoke. Tokens are accepted only in theAuthorizationheader and only for this resource.
Data kept
| What | Stored | Who can see it | How long |
|---|---|---|---|
| Notes (memo_write) | Text, id, time, id of the client that wrote it | Any approved client | Until the owner deletes them |
| Uploaded files | File bytes, name, type, size, SHA-256, client id, time | Anyone with the link (links are unguessable but public) | Until the owner deletes them |
| Audio for transcribe | Not stored. Fetched, sent to OpenAI for transcription, then dropped. The transcript is returned, not kept. | OpenAI processes the audio under its API terms | Request duration |
| OAuth | Client registrations; SHA-256 hashes of codes and tokens (never the tokens) | Server only | Codes 10 min, tokens until expiry |
| Logs | Errors only, no request bodies or tokens | Owner | Process log rotation |
Do not upload or note anything confidential: uploaded files are public by link.