propaths-mcp
An MCP server that exposes the ProPaths
verified protein-interactome as read-only tools for AI agents. It is a thin
client over the public ProPaths API (https://propaths.net), so every tool
returns exactly the API's JSON. No account, no API key.
ProPaths reads a protein's primary literature and returns a verified graph of typed, directed, mechanistic interactions plus a pathway ontology. One protein (ATXN3) is fully mapped today.
Quickstart (Claude Desktop / any MCP client)
Add this to your MCP client config. uvx fetches and runs the server; nothing
to clone or install.
{
"mcpServers": {
"propaths": {
"command": "uvx",
"args": ["propaths-mcp"]
}
}
}
Then ask, e.g., "search ProPaths for SCA3 and summarize its strongest
mechanistic interaction." The agent will call search_proteins then
get_protein, and drill in with get_interaction.
Prefer the raw API? It is public and keyless:
curl https://propaths.net/api/protein/ATXN3
curl 'https://propaths.net/api/search?q=SCA3'
Tools
| Tool | What it does |
|---|---|
search_proteins(q, limit=20) |
Find a protein by symbol, alias, or name (start here) |
get_protein(symbol) |
Compact interactome overview (the main entry point) |
get_interaction(interaction_id, query=None) |
One interaction's full mechanism + evidence |
get_interaction_between(a, b) |
The interaction(s) between two proteins, in one call |
list_interactions(symbol, kind=, type=, pathway=, min_evidence=, sort=, limit=) |
Filtered/sorted headline rows |
list_interaction_types() |
The controlled vocabulary (edge kinds, types, directions) + counts |
get_pathway(pathway_id) |
A pathway node with its lineage and member interactions |
get_pathway_tree() |
The full pathway scaffold (resolves pathway ids to names) |
get_highlights() |
The best-evidenced interactions |
export_network(symbol, format="tsv") |
Export a protein's network as TSV / SIF / GraphML (Cytoscape, networkx) |
describe_schema() |
The graph vocabulary + how to use the tools (offline) |
Also exposed as MCP resources (propaths://schema, propaths://interaction-types,
propaths://pathways/tree, and the propaths://protein/{symbol} template) and
prompts (profile-protein, strongest-evidence, explain-pathway).
All tools are read-only and idempotent.
Configuration
| Env var | Default | Purpose |
|---|---|---|
PROPATHS_API_URL |
https://propaths.net |
API base URL. Point at http://localhost:8000 to run against a local API. |
Run without uvx
pip install propaths-mcp
propaths-mcp # runs the stdio server
# or: python -m propaths_mcp
Before it is published, you can run straight from the repo:
uvx --from git+https://github.com/Tahsin-Kazi/propaths-mcp propaths-mcp
Notes
- Read-only and public; reads are rate-limited per client. Write/enrichment access and a hosted MCP are gated. Get in touch.
- Errors are graceful: a missing protein returns
{"error": "...", "status": 404}; an unreachable API raises with a hint.
Docs: https://propaths.net/quick-start · License: MIT
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 propaths_mcp-0.1.0.tar.gz.
File metadata
- Download URL: propaths_mcp-0.1.0.tar.gz
- Upload date:
- Size: 11.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.9.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
135508bfec885b82a4f9bc34eacb2769a00180c0b6ecf08acaaf4ec371335fa7
|
|
| MD5 |
8bf3352b00cf9cc460996f0d35a28c57
|
|
| BLAKE2b-256 |
8555990c5ad5fea1411b227a0a43835c2266a7e6ab51f1c180f9332adcd50466
|
File details
Details for the file propaths_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: propaths_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 10.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.9.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5e597c9dd6cb1e03bad352b4f1cd3bd6fbd81948828d3b75f40d0934489ef5ac
|
|
| MD5 |
86b9fbe088395527aae8d1416a131cdf
|
|
| BLAKE2b-256 |
6d98679dd8e6e3ee6a9479b20b584c66d1fe23e0f7e665606705f8bcc09c51bd
|