Developers

Everything on bokendell.com is available programmatically: a public read-only REST API with a complete OpenAPI 3.1 spec, an MCP server over Streamable HTTP, and Markdown variants of every page. No API key, sign-up, or authentication is required for the public read surface.

Use these endpoints when an agent or script needs this portfolio's data. Prefer the MCP server for interactive agent sessions and the REST API for one-shot reads.

REST API

Base URL https://api.bokendell.com, also proxied on this origin. The OpenAPI 3.1 spec gives every operation a unique operationId. Browse it at the API reference — Scalar, on this origin.

curl https://bokendell.com/openapi.json
curl https://api.bokendell.com/api/v1/projects
curl https://api.bokendell.com/api/v1/posts

MCP server

Streamable HTTP at https://bokendell.com/mcp; the manifest lives at /.well-known/mcp.json. See the tool list or try it live.

{
  "mcpServers": {
    "bokendell-portfolio": {
      "type": "http",
      "url": "https://bokendell.com/mcp"
    }
  }
}

Markdown for agents

Every page negotiates Accept: text/markdown, or append .md to the URL. Start from /llms.txt or /agent.md. The A2A agent card is at /.well-known/agent-card.json.

CLI

Official CLI on npm as bokendell. Read-only, no key. Run it bare for a map of every command; each answer ends with the commands to run next, and every command takes --json. npx bokendell all --json is the whole portfolio in one call.

npx bokendell                     # the map: every command, an example each
npx bokendell projects bagman     # one case study, in full
npx bokendell resume --download   # saves resume.pdf
npx bokendell all --json          # the whole portfolio, for agents
npx bokendell mcp                 # MCP client config

Limits & contact

The API is public, read-only, and unauthenticated — be reasonable with request rates. Questions, bugs, or integration ideas: get in touch.