Documentation
Everything an agent needs to read the job market
People, companies and live job postings, plus contact unlock, over one REST API and one MCP server. Start with the quickstart if you want it working in five minutes, or the API reference if you already know the shape.
Connect it to what you already use
Four skills that teach any assistant the endpoints and the two-step shape, and have it read field names and operators from GET /contract when it runs. They work in any agent, with MCP or without it.
The assistant now knows both calls and reads the field names from the live contract, so it writes the request itself instead of guessing at a field.
Search biotech companies with 50 to 500 employees and show me what comes back.
All four skillsnpx skills add MetixAI-Official/metix-skills
# Four skills: people search, company search,
# job search, and one that spans all three when
# a question needs more than one of them.
# Same key as everything else here. Set it in
# the shell you run the agent from:
export METIX_KEY="metix_xxxxxxxxxxxx"Register the MCP server over streamable HTTP. Create a key first: the same one works for MCP, for the skills, and for the REST API.
Twelve tools appear in the agent's tool list: nine for data, plus contract, version and key status. You never name them: ask for what you want and it picks.
Find ML engineers in San Francisco, then read the records behind the ids.
Claude setupclaude mcp add --scope user --transport http metix-ai-platform \
https://mira-api.metix.ai/mcp \
--header "Authorization: Bearer $METIX_KEY"
claude mcp list
# metix-ai-platform: https://mira-api.metix.ai/mcp (HTTP) - Connected
# Older clients speak legacy SSE instead. Point
# those at the same host on /sse, with the same
# Authorization header.The same server, registered with Codex. The key stays in your environment instead of being written into the config file, and the skills on the first tab install for Codex as well.
Same twelve tools, same key. Codex sandboxes shell commands without network access by default, which is fine for MCP and blocks a raw curl until you allow it.
Which companies posted data engineer roles in the US this month?
Codex setupcodex mcp add metix-ai-platform \
--url https://mira-api.metix.ai/mcp \
--bearer-token-env-var METIX_KEY
codex mcp get metix-ai-platform
# transport: streamable_http
# bearer_token_env_var: METIX_KEY
# Read at call time, so it never lands in the file.
# The Skills tab covers Codex too: its installer
# writes .agents/skills, which Codex reads.Paste one message into a new Muse chat. Muse connects itself, sends you a free sign-up link if you have no key yet, and asks for the key in its secure prompt, never in the chat.
Ask in plain words. When the web could also answer, start with "Use Metix:" so Muse reads the record rather than searching.
Use Metix: which companies are hiring machine learning engineers in New York this week?
Muse setupAdd my Metix connector:
https://mira-api.metix.ai/mcp
- Setup: standard MCP over streamable HTTP. Every request needs the header Authorization: Bearer <my Metix key>. Ask me for the key through your secure credential prompt; never ask for it in chat and never print it. Send Accept: application/json, text/event-stream on every request. Keep the Mcp-Session-Id returned by initialize and send it on every later call.
- Key: if I don't have a Metix key yet, first send me this link to create one, free with 100 API Credits and no card: https://platform.metix.ai/start/muse. Wait until I say I have it before you ask for it.
- Skill: save one so any question about people, job postings or companies goes through Metix tools first. Call metix_get_contract before the first search and follow it if it disagrees with this note. Searches return ids; read records with the matching get tool, at most 100 ids per call. Keep size at 5 or less unless I ask for more.
Once you are in, list the tool names you got, call metix_get_key_status, then answer this with them:
find three open machine learning engineer postings in San Francisco and tell me the company and the posted salary range for each.One request against the live API. It answers with ids, which is what a working search looks like.
You get ids back, never records. Send up to 100 of them to the matching detail route, and choose the fields you want with _source.
Quickstartcurl -s -X POST "https://mira-api.metix.ai/v1/people-search" \
-H "Authorization: Bearer $METIX_KEY" \
-H "Content-Type: application/json" \
-d '{"text": "ML engineers in San Francisco", "size": 25}'
# {"code": 200, "msg": "ok", "data": {"profile_ids": [
# "UHyKQXeFCLaGeBwgjwisBg", "YhlkBSsJWv7zeGUJMaymMw" ]}}
# Ids only. Records come from the detail route.Plain requests. There is no SDK to install, so there is no SDK version to keep up with.
Two calls, always in that order: search for ids, then read the records behind them. Ids bill far cheaper than records, so search wider than you plan to read.
Quickstartimport os, requests
r = requests.post("https://mira-api.metix.ai/v1/people-search",
headers={"Authorization": f"Bearer {os.environ['METIX_KEY']}"},
json={"text": "ML engineers in San Francisco", "size": 25})
ids = r.json()["data"]["profile_ids"]
# Ids, not records. Send up to 100 of them to
# POST /entity/v1/profiles/detail-by-id
print(ids)Plain fetch. There is no SDK to install, so there is no SDK version to keep up with.
Two calls, always in that order: search for ids, then read the records behind them. Ids bill far cheaper than records, so search wider than you plan to read.
Quickstartconst r = await fetch("https://mira-api.metix.ai/v1/people-search", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.METIX_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ text: "ML engineers in San Francisco", size: 25 }),
});
// Ids, not records. Send up to 100 to the detail route.
const { profile_ids } = (await r.json()).data;Three datasets
People, jobs, and companies. Each one is searched with the same Query Spec grammar and read through its own detail route, so learning one dataset teaches you the other two.
People
Search + detailSearch professional profiles by role, skills, employer, education, location, and seniority, then read the records you keep.
Jobs
Search + detailSearch active openings by role, function, company, location, pay, and posting date as a live demand signal.
Companies
Search + detailSearch organizations by industry, size, headquarters, and funding, and attach that context to people and job results.
Agents and MCP
Agent accessReach the same datasets and contact unlock from an MCP client or an agent skill, under the same key and the same API Credit rules.
One capability sits outside the three, because it is not searched. Contact takes people you already found and returns a personal email, a work email or a phone number for them, charged per value returned rather than per call.
How a request works
Every dataset works the same way, and it is worth knowing before you write any code: search hands back encrypted string IDs, and a second call turns the IDs you keep into records. There is no single call that does both.
- Step
- 1
- Call
- Search the dataset with a Query Spec tree
- What comes back
- Encrypted string IDs, plus a cursor while more pages remain
- Step
- 2
- Call
- Send up to 100 of those IDs to the detail route
- What comes back
- Full public records, and the IDs that could not be resolved
- Step
- 3
- Call
- Join across datasets
- What comes back
- Company context for a job, or the people inside a company
Search results are IDs
One data foundation, three access surfaces
- Surface
- Metix AI skills
- Use it when
- An agent needs reusable multi-step search and analysis instructions
- Start here
- /docs/skills
- Surface
- MCP
- Use it when
- A compatible client should reach the same data conversationally
- Start here
- /docs/mcp
- Surface
- REST API
- Use it when
- A product needs deterministic requests and JSON responses
- Start here
- /docs/quickstart
The MCP setup page lists every tool by name, with the REST route each one calls.