MDflow

{
  "protocolVersion": "0.3.0",
  "name": "MDflow",
  "description": "Agent-controllable markdown workspace. Folders hold .md documents an AI agent can read, create, update, organize, and share. Control it via the MCP server (preferred) at https://mdflow.cz/api/mcp or the REST API at https://mdflow.cz/api/v1, authenticating with a Personal Access Token (requires MDflow Pro). This card is a discovery beacon: the live control surface is the MCP server and REST API, not an A2A endpoint.",
  "provider": {
    "organization": "MDflow",
    "url": "https://mdflow.cz"
  },
  "version": "1.0.0",
  "documentationUrl": "https://mdflow.cz/docs.md",
  "preferredTransport": "JSONRPC",
  "url": "https://mdflow.cz/api/mcp",
  "additionalInterfaces": [
    {
      "transport": "JSONRPC",
      "url": "https://mdflow.cz/api/mcp"
    },
    {
      "transport": "HTTP+JSON",
      "url": "https://mdflow.cz/api/v1"
    }
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "text/markdown",
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "text/markdown",
    "application/json"
  ],
  "securitySchemes": {
    "personalAccessToken": {
      "type": "http",
      "scheme": "bearer",
      "description": "MDflow Personal Access Token (mdf_...), created at https://mdflow.cz/settings. Requires MDflow Pro. Send as: Authorization: Bearer mdf_..."
    }
  },
  "security": [
    {
      "personalAccessToken": []
    }
  ],
  "skills": [
    {
      "id": "documents",
      "name": "Manage markdown documents",
      "description": "List, read, create, update, move, and delete markdown documents in folders you own.",
      "tags": [
        "markdown",
        "documents",
        "crud"
      ],
      "examples": [
        "Create a document called meeting-notes.md in my Project folder",
        "Update the body of a document"
      ]
    },
    {
      "id": "folders",
      "name": "Organize folders",
      "description": "List, create, and delete folders, and edit folder descriptions, which act as retrieval context for the documents inside.",
      "tags": [
        "folders",
        "organize"
      ]
    },
    {
      "id": "context",
      "name": "Topic-based retrieval",
      "description": "Find the most relevant markdown by ranking folder descriptions first, then titles, then fetching the best-matching document bodies.",
      "tags": [
        "search",
        "retrieval",
        "rag"
      ],
      "examples": [
        "Get context about my API documentation from mdflow"
      ]
    },
    {
      "id": "sharing",
      "name": "Share documents",
      "description": "Turn on public unguessable share links (optionally with comments), or privately share a document with specific people by email.",
      "tags": [
        "sharing",
        "publish"
      ]
    }
  ]
}