{
  "version": 3,
  "summary": "fil stores files and folders on Filecoin with an npm CLI, and serves Filecoin storage data through a public, read-only REST API and MCP server.",
  "credentials": {
    "fil_session_key": {
      "type": "signature",
      "label": "fil session key",
      "generateUrl": "https://fil-app.hugomrdias.dev/dashboard/session-keys",
      "setup": "Run `fil login`. It makes a session key on the machine and returns a fil-app approval link, which the wallet owner opens to approve the key with their wallet. The CLI finds the approval on chain.\n\nFor CI or a cloud agent, generate, authorize, and export a key on the fil-app session keys page instead, and set `FIL_SESSION_KEY` and `FIL_ROOT_ADDRESS`.\n\nThe key signs storage requests. It cannot move funds, and it expires.",
      "fields": {
        "sessionKey": {
          "secret": true,
          "description": "The session key, as FIL_SESSION_KEY."
        },
        "rootAddress": {
          "secret": false,
          "description": "The wallet address that approved the key, as FIL_ROOT_ADDRESS."
        }
      }
    }
  },
  "surfaces": [
    {
      "slug": "fil-api",
      "name": "fil-api REST API",
      "type": "http",
      "url": "https://fil-api.hugomrdias.dev/",
      "spec": "https://fil-api.hugomrdias.dev/openapi.json",
      "docs": "https://fil-app.hugomrdias.dev/docs/api",
      "basis": {
        "via": "declared",
        "source": "https://fil-app.hugomrdias.dev/.well-known/integrations.json"
      },
      "auth": {
        "status": "none",
        "basis": {
          "via": "declared",
          "source": "https://fil-app.hugomrdias.dev/.well-known/integrations.json"
        }
      }
    },
    {
      "slug": "fil-api-mcp",
      "name": "fil-api MCP server",
      "type": "mcp",
      "url": "https://fil-api.hugomrdias.dev/mcp",
      "transports": [
        "streamable-http"
      ],
      "docs": "https://fil-app.hugomrdias.dev/docs/api#mcp-server",
      "basis": {
        "via": "declared",
        "source": "https://fil-app.hugomrdias.dev/.well-known/integrations.json"
      },
      "auth": {
        "status": "none",
        "basis": {
          "via": "declared",
          "source": "https://fil-app.hugomrdias.dev/.well-known/integrations.json"
        }
      }
    },
    {
      "slug": "fil-cli",
      "name": "fil CLI",
      "type": "cli",
      "command": "fil",
      "packages": [
        {
          "registryType": "npm",
          "identifier": "@hugomrdias/fil",
          "runtimeHint": "npx"
        }
      ],
      "docs": "https://fil-app.hugomrdias.dev/docs/cli",
      "basis": {
        "via": "declared",
        "source": "https://fil-app.hugomrdias.dev/.well-known/integrations.json"
      },
      "auth": {
        "status": "required",
        "entries": [
          {
            "use": [
              {
                "id": "fil_session_key",
                "mechanics": {
                  "source": "cli",
                  "command": "fil login",
                  "env": [
                    "FIL_SESSION_KEY",
                    "FIL_ROOT_ADDRESS"
                  ]
                }
              }
            ],
            "basis": {
              "via": "declared",
              "source": "https://fil-app.hugomrdias.dev/.well-known/integrations.json"
            }
          }
        ]
      }
    }
  ]
}