Skip to main content

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://www.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://www.propaths.net/api/protein/ATXN3
curl 'https://www.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://www.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://www.propaths.net/quick-start · License: MIT

Metadata

Release files for propaths-mcp 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for propaths-mcp 0.1.1
File Size Uploaded Provenance
propaths_mcp-0.1.1.tar.gz 11.9 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for propaths-mcp 0.1.1
File Interpreter ABI Platform
propaths_mcp-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 22.3 kB

Release files / propaths_mcp-0.1.1.tar.gz

Download URL propaths_mcp-0.1.1.tar.gz
Size 11.9 kB
Tags Source
SHA-256 checksum
How to use checksums
8161f14549a22a4f7a58c867fb8fe0d804ed5829fcf49a2f85302035ae131b9b
BLAKE2b-256 checksum
How to use checksums
61ebd46dc4a1d623d2f4aaf0b13cd605432fbfd1fe115f844b9a488521b95253
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.7

Release files / propaths_mcp-0.1.1-py3-none-any.whl

Download URL propaths_mcp-0.1.1-py3-none-any.whl
Size 10.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8fdbef94e3e43bec00ac570b28cffdb8ccfac79296cb2b6ea34883e78a411052
BLAKE2b-256 checksum
How to use checksums
9fa8018dae1d6844ba4a5971cf4b03ac30d7c4c2923988fae24ee5e8296f1157
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.7

Security for propaths-mcp 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page