{
  "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"]
    }
  ]
}