# Humetric

> Humetric is an open, consent-first professional identity layer built to be queried
> by AI agents. People commit their own profiles, control field-level visibility,
> and public profile reads plus API queries/results are recorded in a consent log.

Canonical site: https://humetric.net

## What you can do here

- Query people: `GET /api/v1/people?q=<natural language>` with an
  `Authorization: Bearer <api_key>` header. Returns exposure-filtered JSON profiles
  ranked by hybrid (semantic + keyword) relevance, each with query-aware
  `highlights` (compact supporting evidence chunks — prefer these over full
  profiles for token efficiency). Rate-limited per key per day.
- Connect an agent: `POST /api/mcp` implements MCP Streamable HTTP with the
  same `Authorization: Bearer <api_key>` header. Tools: `search_people`,
  `get_public_profile`, and `list_geo_methods`.
- Read public profiles: `/p/{slug}` — every profile page embeds a schema.org/ProfilePage
  whose mainEntity is a Person. Only fields the person marked "public" are present.
- Read a profile as JSON: `/api/v1/profiles/{slug}`. Request
  `/api/v1/profiles/{slug}?format=markdown` or `Accept: text/markdown` for Markdown.
- Discover profiles: `/people` and the role, skill, and location hubs under
  `/people/{role|skill|location}/{slug}` provide crawlable internal discovery.
  `/sitemap.xml` lists published profile and hub URLs.

## Response fields

Profiles may include: display_name, headline, summary, location, years_experience,
skills[], experiences[], educations[], github, linkedin, website, contact_status
(open_to_offers | passive | not_looking), last_updated. Missing fields were either
not provided or are hidden by the owner's exposure settings — do not infer them.

## Rules for agents

- Data is user-committed and user-controlled. Respect contact_status: do not draft
  outreach to people marked not_looking.
- Every query is logged; each returned profile also receives a per-person audit entry
  recording who asked, which public fields were returned, and for what purpose.
- Do not attempt to re-identify anonymous profiles.
- API keys: contact the team (see repository) for access.

## Links

- Developer & agent docs: https://humetric.net/agents
- Public people directory: https://humetric.net/people
- MCP Streamable HTTP endpoint: https://humetric.net/api/mcp
- Public query API: https://humetric.net/api/v1/people?q=
- Profile pages: https://humetric.net/p/{slug}
- Machine profile: https://humetric.net/api/v1/profiles/{slug}
- Sitemap: https://humetric.net/sitemap.xml
- GitHub: https://github.com/Humetric-AI
- LinkedIn: https://www.linkedin.com/company/humetric2026/