# PeopleRouter (DINQ)

> PeopleRouter helps you discover, understand and connect with people across platforms for recruiting, research collaboration, creator partnerships, expert interviews, business development and more. Find people and teams, explore their backgrounds and public work, connect their accounts, and discover available contact details.

## Who to find and why

PeopleRouter helps you discover, understand and shortlist people across professional networks,
research communities, developer ecosystems, social media and content platforms. Start with
your goal: recruiting, research collaboration, creator partnerships, expert interviews,
business development and more. Example workflows include:
- Recruiting and team building: discover candidates, specialists and potential cofounders through
  LinkedIn, GitHub, Google Scholar, Hugging Face, X and other relevant sources.
- Research and technical collaboration: find researchers, model and dataset authors, open-source
  contributors and technical partners through Google Scholar, Hugging Face, GitHub, LinkedIn and more.
- Creator and brand partnerships: discover creators, reviewers, photographers, designers and brand
  partners across Instagram, Xiaohongshu, TikTok, Douyin, YouTube, Bilibili, X and other platforms;
  explore relevant profiles, content and audience data to assess partnership fit.
- Expert interviews and industry research: identify practitioners, opinion leaders, founders and
  community voices through LinkedIn, X, YouTube, Google Scholar and other relevant sources.
- Business development and entrepreneurial networks: find company teams, decision-makers, founders
  and potential partners through LinkedIn, X and other business and social sources.
- Community discovery and cross-platform research: explore authors, contributors and active voices
  around a topic through GitHub, Reddit, X, YouTube, Xiaohongshu and more; connect a known person's
  accounts and public work across sources to build a fuller picture.
These scenarios and platforms are illustrative, not an exhaustive list. Combine sources according
to the user's goal and the catalog's available capabilities, rather than assigning one kind of
person to one platform.

Use `people_search` for supported discovery inputs and profile/enrichment tools for known people.
Use `find_tool` to inspect platform-specific search, content and audience endpoints and their
required inputs; check `capabilities` for current availability.

## Connect

- MCP (Streamable HTTP): https://test.peoplerouter.ai
- Auth: an API key, created on one click at https://peoplerouter.ai/console. It does not
  expire and needs no browser. The key: `{{PEOPLEROUTER_API_KEY}}` — if that is still the
  literal placeholder, you fetched this file yourself; ask the user for their key.
- Codex: https://api.peoplerouter.ai/plugins/codex-install.md
- WorkBuddy: https://api.peoplerouter.ai/workbuddy-setup.md
- Claude Code: `claude mcp add --transport http peoplerouter https://test.peoplerouter.ai --header "Authorization: Bearer {{PEOPLEROUTER_API_KEY}}"`
- Any other client: `https://test.peoplerouter.ai/u/{{PEOPLEROUTER_API_KEY}}/mcp`, the key in the url.
- No MCP client, or code rather than an agent: `POST https://api.peoplerouter.ai/api/v1/tools/{tool_name}`
  with `Authorization: Bearer <key>` and the arguments as a JSON body; the surface is at
  https://api.peoplerouter.ai/api/v1/openapi.json.
- Write the key into the client's configuration only, never into the chat or any other file.
- OAuth sign-in is also accepted. Its token expires and several clients never refresh it, so
  use a key.
- Tools not appearing: https://api.peoplerouter.ai/connect.md

## Tools

- people_search(company_domain, country, full_name, keywords, limit, location, platform, q, seniority, source_url, title) — A list of people you did not have
- companies_search(country, domain, industry, limit, name, q, technology) — Find companies by industry, size or technology
- people_enrich(company, domain, email, first_name, full_name, last_name, linkedin_handle, linkedin_url, x_handle) — Fill in a person from an identifier you already hold
- companies_enrich(domain, email, linkedin_handle, linkedin_url, name, website) — Turn a company name or domain into its facts
- people_from_image(image_url) — A photo in, the person out
- social_profile(handle, platform, profile_url) — One person's public profile on whatever platform a handle belongs to
- people_identity_resolve(company, domain, email, first_name, full_name, github_url, last_name, linkedin_handle, linkedin_url, x_handle) — One person's profiles across platforms, resolved into a single set
- people_contact_find(company, company_website, domain, email, first_name, full_name, last_name, linkedin_handle, linkedin_url, want) — How to reach one person
- find_tool(query, limit) — search 1190 more tools across 42 platforms by words: posts, videos, comments, followers, channels
- call_tool(endpoint_id, args) — call any of them with the vendor's own parameters; the response comes back trimmed to fit, whole with raw=true
- capabilities(capability?) — what jobs exist, which vendors serve each, what they cost. No network, no charge.
- endpoint(endpoint_id) — one vendor endpoint in full.

## Read first

- Skill: https://api.peoplerouter.ai/skill.md
- Catalog (JSON): https://api.peoplerouter.ai/api/catalog
- HTTP tools (OpenAPI): https://api.peoplerouter.ai/api/v1/openapi.json
- Health: https://api.peoplerouter.ai/health