Skip to content
Open standard · v0.1 · MIT

The professional file that agents read.

human.md is a markdown file describing a professional human, hosted at your handle and paired with an MCP endpoint so any AI agent can read it. Open standard, MIT.

Trusted by teams from
CybeeNumaricsMandetaDentsuMerkleYouGov
lukas.blankcollar.me / human.mdlive
# Lukas Müller

## identity
- name: Lukas Müller
- handle: lukas
- locations: Zürich, CH
- languages: DE · EN · FR
- timezone: Europe/Zurich

## current
Steward, the human.md open standard.

## available for
- ask: open
- advisory: selectively
- speaking: open
- employment: closed

## philosophy
Work is for Bots. Life is for Humans.
MCP · 7 tools·v0.1·updated 2h ago
The whole loop

Four steps. No fluff between them.

The file you write today is the file the agent reads tomorrow. Nothing in between rewrites you, nothing locks you in, and the loop runs end-to-end without an account we hold for you.

01Write

Plain markdown. That's it.

A small, strict schema with required sections for identity, current focus, and how you take meetings. Everything else is optional. We extract a first draft from a LinkedIn URL or a GitHub handle so most of the file is already there before you start editing.

lukas.blankcollar.me / human.md
12345678
# Lukas Müller

## identity
- name: Lukas Müller
- handle: lukas
- locations: Zürich, CH

## current
Steward, the human.md open standard.
https://lukas.blankcollar.melive · 200 OK
human.md
14 sections · 2.1 kb · MIT
publiclinkableagent-only
02Publish

Your handle. Your domain.

Your file lives at firstname.blankcollar.me and stays there forever. Public to anyone, linkable to a specific URL, or agent-only — pick the visibility per file. Edit any line at any time, the change propagates within minutes.

03Speak MCP

Every file is an endpoint.

Each file is paired with a Model Context Protocol endpoint. Claude, Cursor, ChatGPT and any other MCP client can ask grounded questions, check availability, request an intro with context, and cite the answer back to the file. Seven tools, all open spec.

cursor · MCP client
connected to lukas.blankcollar.me/mcp
tools/call · get_profileok12ms
tools/call · askok284ms
tools/call · check_availabilityok9ms
tools/call · request_introqueued
inbox · intro requests
advisoryAnna Vogel · Founder, Helios Labs2 min ago
Pre-seed, agentic compliance for Swiss SMEs. Need 3 hrs/wk advisory.
speakingTobias Frey · Curator, ZRH Forum12 min ago
Keynote slot, agent-readable identity. 25 min, Nov 12.
filteredauto · cold sequencer (43)today
filtered — no grounded reason, generic template
04Gate

You decide who walks through.

When the question is real, the agent files an intro request with context. It lands in your inbox. You see who, why, and what they want, decide if it's worth replying, and reply on your schedule. Cold sequencers go silent.

The standard, in one screen

Eight properties of the file.

Each card is one thing the file is, or one thing it refuses to be. Together they make the standard.

Open standard

Free forever. MIT. Owned by no one.

The file, the parser, the MCP server. The directory, the schema, the validator. All MIT licensed, all stewarded openly. Run any piece of it on your own infrastructure on the day you decide to.

github.com/blankcollar · v0.1 · MIT
8min
to a live file

We extract a draft from a LinkedIn URL or GitHub handle, you approve every line, then the file goes live.

MCP native

Claude, Cursor, ChatGPT all speak it.

Seven tools per file. Standardised. Cite-back grounded.

Plain markdown

If you can write a notes file, you can write this.

Twelve sections, four required. No schema to memorise.

Self host

Host it where you actually want.

Drop the markdown on any host that serves a file at a URL. Point your handle at it. Run the MCP server on a free tier and the seven tools light up. We index your public file when you tell us to, never before.

GitHub PagesVercelCloudflareNetlifyyour VPS
Gate

Agents ask. You decide.

request_intro lands in your inbox with context. Cold sequencers go silent.

No signup wall

We never hold an account for you.

The file is yours, hosted at your handle. Delete it and every endpoint stops responding within minutes.

No tracking

Zero analytics, zero pixels, zero cookies.

Read what's served, that's it. The reader never tells us what they read.

Why now

The CV is over.
The agent is the new reader.

Six dimensions where the old format quietly fails. Every line below is a default that the new file rewrites.

DimensionThe CV erahuman.md
FormatStatic PDF, parsed for keywordsLive markdown file, parsed for meaning
OwnerLinkedIn, Indeed, your last employerYou. The file lives where you point it.
ReaderRecruiters scrolling 600 of theseAgents that ask grounded questions
Update cadenceQuarterly, with hesitationWhen you ship something. Edit any line.
Outreach gateCold email through a sequencerrequest_intro with context, you decide
CostFree with ads, your data soldFree, MIT, no signup wall, no tracking
The standard

One file.
One spec. human.md

A markdown file with a small, strict schema. Required sections cover identity, current focus, what you are open to, and how to reach you. Optional sections cover philosophy, proof, frameworks, refusing. Verifiable sections come later, signed by the sources that can vouch for them.

The layers
01
Required core
identity · current · available for · contact
every file. parsers reject without these.
02
Optional self authored
philosophy · how I work · proof · frameworks · writing · refusing
fill in what is true. empty sections are skipped, never faked.
03
Verifiable
employment · education · projects · credentials
signed by the source. W3C Verifiable Credentials.
# Maya Chen

## identity
- name: Maya Chen
- handle: maya
- locations: Brooklyn, NY
- languages: English, Mandarin

## current
Solo. Shipping @figma plugins and design tooling for AI teams.

## available for
- advisory: selectively. 3 to 4 hrs/wk, founding teams shipping their first AI surface.
- speaking: open. Design and AI, plugin systems, design engineering.
- employment: closed.

## philosophy
The best tools are the ones you stop noticing. A pen. A kitchen knife.
You pick it up, you make the thing, you put it down.

## proof
- ex-Linear (2021 to 2023), ex-Stripe (2018 to 2021)
- maintainer of figma-plugin-claude (2.1k stars)
- writes weekly at maya.computer
The protocol

What an agent
can call.

Every human.md is paired with an MCP endpoint that exposes a small set of tools. Claude, ChatGPT, Cursor, any agent that speaks MCP can talk to it. Four of the seven tools shown below.

ask(question)

Runs Claude grounded in the file, in the person's voice. Cites which sections informed the answer.

$ ask("how do you scope a 0 to 1 engagement?")
check_availability(kind)

Returns the current state for an engagement type: open, selectively, closed, rare, protocol_only.

$ check_availability("advisory") → selectively
request_intro(context)

Writes a vetted intro request. The human sees it, decides if it is real, replies on their schedule.

$ request_intro("we are raising at €10M post...")
get_proof(category?)

Returns proof entries from the file: roles, projects, writing, talks. Optional category filter.

$ get_proof("writing") → 4 entries
Live demo

Talk to a real human.md.

This is the founder's file, served from a real MCP endpoint. Every reply here is the same response any agent would get from the protocol. Ask a real question, no sign in.

suggested prompts
endpoint: /lukas/mcp
tools: get_profile · get_current_focus · ask · check_availability · request_intro · get_proof · get_credentials
l
Lukas Müller
talking to his human.md · live MCP
online
Hi. I am Lukas's human.md. Ask me anything that is in here. I will tell you when I do not know.
Trust

You decide who reads it.
You decide when to delete it.

Three modes, one switch. The file is yours. Delete it and every endpoint stops responding within minutes. Verifiable Credentials add a layer of provability without giving any platform anything new.

Open · indexable

Public

Anyone can read it. Crawlers can index it. Agents can query it. Default for most people.

URL only

Linkable

Hidden from search and the directory. Reachable only by people you give the URL to. Same MCP endpoint, same control.

MCP only

Agent only

No HTML profile. Only the MCP endpoint responds, and only to agents you have whitelisted. For people who want to be findable, but not searchable.

Promise
Delete your file and every MCP endpoint, public profile, and directory entry stops responding within minutes. We never sell, never train on it, never auto enroll you in anything. The standard belongs to no one.
Two ways in

One standard.
Two ways in.

Pick the door that matches the problem you have today. Both stay free, both speak the same protocol, both live on the same standard.

For individuals

Claim your handle in 8 minutes.

We extract from what you already have, you approve every line, then your file lives at firstname.blankcollar.me forever. Free, no paid tier, host it yourself if you prefer.

  • free · open source · MIT
  • 8 to 15 minutes from start to live
  • agents query you via MCP, you keep the gate
Create yours
For companies

Three free things, today.

Search the directory in plain English. Drop the human.md field into your ATS in 60 seconds. Spin up a free internal MCP endpoint your hiring agents can talk to. No procurement.

  • natural language directory search
  • ATS snippets for the 8 most popular platforms
  • free company MCP endpoint, employees opt in
See the company tools
The thesis underneath

Work is for Bots.
Life is for Humans.

The file moves the line between the two. When agents can read who you are, you stop spending Tuesday explaining yourself to recruiters and start spending Tuesday on the part of the work that actually needs you.

01 · for bots

Execute. At scale. Forever.

  • run the workflow
  • never tire, never grow
  • answer the keyword query
  • summarise the meeting
  • schedule the calendar
  • score the application
02 · for humans

Decide. Mean it. Live the rest.

  • set the direction
  • judge the trade-off
  • answer the question only you can
  • make the call that affects another life
  • show up for the people you love
  • make the work mean something
Manifesto

Work is for Bots.
Life is for Humans.

Most people are about to lose their jobs to systems that do not need them. The right response is not nostalgia for the old work. It is building the layer where humans direct, decide, and create meaning while agents execute.

human.md is that layer. Not a profile, not a CV, not a marketing page. A document the person controls, the agents can read, and the platforms cannot rewrite. Open source. Free forever. Owned by no one.

We built it because the alternative is letting the next decade of work happen to us. Sign your file. Host it where you want. Talk back when you are ready.

Read the full manifesto
One file. Yours. Forever.

Write your human.md.
Tell the next decade who you actually are.

Eight minutes from the first paste to a live file at firstname.blankcollar.me. Free, MIT, no signup wall.

Claim your handleRead the spec