The Folio API and MCP server.

02 / Getting started

Three steps to your first response.

1. 01

   Create an API key

   Open your workspace at /admin and go to Settings > API. The workspace owner mints a key there. The raw key is shown once, so copy it immediately.

2. 02

   Authenticate

   Send the key as a bearer token on every request: Authorization: Bearer pk_live_... . No cookies, no sessions, no OAuth dance.

3. 03

   Make your first request

   Call /api/v1/portfolio to pull your entire published portfolio in one response, then narrow to a single resource as you need it.

curl https://portfolio.wrxstack.com/api/v1/portfolio \
  -H "Authorization: Bearer pk_live_your_key_here"

04 / MCP server

Drop your portfolio into any AI client.

folio-mcp is a Model Context Protocol server that wraps every v1 endpoint as an MCP tool: read tools for your whole portfolio, and create, update, and delete tools for experience, skills, stats, awards, education, and links. Point it at your key and an assistant can answer questions grounded in your real portfolio, and edit it for you when the key has the write scope. It runs over stdio.

cd mcp-server
npm install
npm run build

{
  "mcpServers": {
    "folio": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/folio/mcp-server/dist/index.js"],
      "env": {
        "FOLIO_API_KEY": "pk_live_your_key_here",
        "FOLIO_API_BASE_URL": "https://portfolio.wrxstack.com"
      }
    }
  }
}

{
  "mcpServers": {
    "folio": {
      "command": "npx",
      "args": ["-y", "folio-mcp"],
      "env": {
        "FOLIO_API_KEY": "pk_live_your_key_here",
        "FOLIO_API_BASE_URL": "https://portfolio.wrxstack.com"
      }
    }
  }
}

{
  "mcpServers": {
    "folio": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/folio/mcp-server/dist/index.js"],
      "env": {
        "FOLIO_API_KEY": "pk_live_your_key_here",
        "FOLIO_API_BASE_URL": "https://portfolio.wrxstack.com"
      }
    }
  }
}

{
  "mcpServers": {
    "folio": {
      "command": "npx",
      "args": ["-y", "folio-mcp"],
      "env": {
        "FOLIO_API_KEY": "pk_live_your_key_here",
        "FOLIO_API_BASE_URL": "https://portfolio.wrxstack.com"
      }
    }
  }
}

06 / Conventions

One envelope, predictable errors.

{
  "apiVersion": "v1",
  "tenant": { "slug": "your-workspace", "name": "Your Name" },
  "pagination": { "total": 12, "limit": 20, "offset": 0, "hasMore": false },
  "data": [
    { "slug": "shipped-the-redesign", "title": "Shipped the redesign", "summary": "..." }
  ]
}

{
  "error": {
    "code": "unauthorized",
    "message": "The provided API key is not valid."
  }
}