list_researchers
Browse registered researchers on the ResearchTwin platform to access their profiles, publications, datasets, and repositories for comprehensive academic exploration.
Instructions
List all researchers registered on the ResearchTwin platform.
Returns researcher slugs and display names. Use a slug with other tools to explore a specific researcher's profile, papers, datasets, and repositories.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- The MCP tool handler that executes the list_researchers logic. Calls backend API via _get('/api/researchers'), formats and returns researcher data with slugs and display names.
@mcp.tool(annotations=ToolAnnotations(title="List Researchers", read_only_hint=True)) async def list_researchers() -> str: """List all researchers registered on the ResearchTwin platform. Returns researcher slugs and display names. Use a slug with other tools to explore a specific researcher's profile, papers, datasets, and repositories. """ data = await _get("/api/researchers") researchers = data.get("researchers", []) if not researchers: return "No researchers registered yet." lines = [f"- **{r['display_name']}** (slug: `{r['slug']}`)" for r in researchers] return f"**{len(researchers)} researchers:**\n" + "\n".join(lines) - Helper function _get() that makes async HTTP requests to the ResearchTwin backend API. Used by list_researchers to fetch researcher data.
async def _get(path: str, params: dict | None = None) -> dict: """Make a GET request to the ResearchTwin API.""" async with httpx.AsyncClient(timeout=TIMEOUT) as client: resp = await client.get(f"{BASE_URL}{path}", params=params) resp.raise_for_status() return resp.json() - backend/main.py:270-277 (handler)Backend FastAPI endpoint /api/researchers that provides the data source. Queries researcher slugs and returns list with slug and display_name for each researcher.
@app.get("/api/researchers") def list_researchers(): """Return available researchers with display names.""" result = [] for slug in researchers.list_slugs(): r = researchers.get_researcher(slug) result.append({"slug": slug, "display_name": r["display_name"]}) return {"researchers": result} - backend/models.py:64-68 (schema)Pydantic response model defining the structure of researcher data with slug, display_name, tier, and message fields.
class RegisterResponse(BaseModel): slug: str display_name: str tier: int message: str