MCP server for ResearchTwin inter-agentic research discovery API
Project description
mcp-server-researchtwin
MCP server for ResearchTwin — inter-agentic research discovery across a federated network of researcher digital twins.
Exposes the ResearchTwin platform API as Model Context Protocol tools, enabling AI agents to discover researchers, explore publications, datasets, repositories, and compute S-Index impact metrics.
Tools
| Tool | Description |
|---|---|
list_researchers |
List all researchers registered on the platform |
get_profile |
Get a researcher's profile with S-Index score |
get_context |
Get comprehensive research context with all data source metrics |
get_papers |
Get publications with citation counts |
get_datasets |
Get datasets with QIC (Quality × Impact × Collaboration) scores |
get_repos |
Get code repositories with QIC scores |
discover |
Search across all researchers for papers, datasets, or repos |
get_network_map |
Get geographic affiliations for all researchers |
Resources
| URI | Description |
|---|---|
researchtwin://about |
Platform information and available tools |
Installation
pip install mcp-server-researchtwin
Or install from source:
git clone https://github.com/martinfrasch/researchtwin.git
cd researchtwin/mcp-server
pip install -e .
Usage
Claude Desktop
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"researchtwin": {
"command": "mcp-server-researchtwin"
}
}
}
Claude Code
Add to your Claude Code MCP settings:
{
"mcpServers": {
"researchtwin": {
"command": "mcp-server-researchtwin"
}
}
}
Custom base URL
To point at a local or self-hosted ResearchTwin instance:
RESEARCHTWIN_URL=http://localhost:8000 mcp-server-researchtwin
Or in Claude Desktop config:
{
"mcpServers": {
"researchtwin": {
"command": "mcp-server-researchtwin",
"env": {
"RESEARCHTWIN_URL": "http://localhost:8000"
}
}
}
}
Example conversations
Once connected, you can ask your AI agent:
- "Who are the researchers on ResearchTwin?"
- "Show me Martin Frasch's publications and S-Index score"
- "Find all datasets related to fetal monitoring"
- "What repositories have the highest QIC scores?"
- "Show me the geographic distribution of the research network"
Requirements
- Python 3.10+
- Network access to
researchtwin.net(or your configured instance)
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mcp_server_researchtwin-0.1.0.tar.gz.
File metadata
- Download URL: mcp_server_researchtwin-0.1.0.tar.gz
- Upload date:
- Size: 4.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6cec0414bd5cc12e288794abf898e53ff127bb69aef81ca1b605c99ec34c69e9
|
|
| MD5 |
7f101ebe77b313854b6e5f9dcd342579
|
|
| BLAKE2b-256 |
f64985fea218314c98a45750a06984139f0c0c69a96184dde28f9918ed2496e3
|
File details
Details for the file mcp_server_researchtwin-0.1.0-py3-none-any.whl.
File metadata
- Download URL: mcp_server_researchtwin-0.1.0-py3-none-any.whl
- Upload date:
- Size: 6.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7f958c4d9c066e286c9f748e3486e48e52a0c5034dd7f3e5e664960525a132ad
|
|
| MD5 |
88bf887c3019db870f4bad87da777e87
|
|
| BLAKE2b-256 |
004f11ec5fcbaf0aa16099bda8f3a7a8c3a332e680616be9371ff8f0ba4d4a89
|