Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_server_researchtwin-0.1.1.tar.gz (4.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_server_researchtwin-0.1.1-py3-none-any.whl (6.3 kB view details)

Uploaded Python 3

File details

Details for the file mcp_server_researchtwin-0.1.1.tar.gz.

File metadata

  • Download URL: mcp_server_researchtwin-0.1.1.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

Hashes for mcp_server_researchtwin-0.1.1.tar.gz
Algorithm Hash digest
SHA256 95123ddd97a797ec9f05b77849ee7e403292c92c4faeaf98daa2810f3c874878
MD5 0837011f9c11305303e5324c2f70bb1e
BLAKE2b-256 c72b9468281d48196d388d8507f36338e5eced15b9a1fa33bdb8d6dc9c87cee8

See more details on using hashes here.

File details

Details for the file mcp_server_researchtwin-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_server_researchtwin-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 0504525b083bd3014089279402efe42bc55c8e1ac3e23a12aa49f98cecb21082
MD5 e3ffe9e4d7d449b52e36b00c9d563723
BLAKE2b-256 c4d764aaccea7a5666e9be3cbde1e5104a53d53847768ea15dd21ec926996889

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page