# 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, Crunchbase, 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://mcp.peoplerouter.ai
- Auth: OAuth sign-in. The endpoint answers 401 with resource metadata; the client discovers the DINQ authorization server, registers itself, opens a browser, the user signs in once. Agents setting this up: add, start the login, tell the user when the browser opens, then call `capabilities()`.
- Claude Code: `claude mcp add --transport http peoplerouter https://mcp.peoplerouter.ai && claude mcp login peoplerouter`
- Codex: `codex mcp add peoplerouter --url https://mcp.peoplerouter.ai && codex mcp login peoplerouter`
- Gemini: `gemini mcp add --transport http peoplerouter https://mcp.peoplerouter.ai`
- Unattended agents and SDKs only: `Authorization: Bearer <DINQ_API_KEY>`; clients that cannot send headers use https://mcp.peoplerouter.ai/u/<DINQ_API_KEY>/mcp

## Tools

- people_search(company_domain, company_name, country, full_name, keywords, limit, location, 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, github_url, last_name, linkedin_handle, linkedin_url, scholar_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, huggingface_url, last_name, linkedin_handle, linkedin_url, scholar_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 1513 more tools across 57 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 whole
- 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://peoplerouter.ai/skill.md
- Catalog (JSON): https://peoplerouter.ai/api/catalog
- Health: https://peoplerouter.ai/health