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

Download files

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

Source Distribution

propaths_mcp-0.1.1.tar.gz (11.9 kB view details)

Uploaded Source

Built Distribution

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

propaths_mcp-0.1.1-py3-none-any.whl (10.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: propaths_mcp-0.1.1.tar.gz
  • Upload date:
  • Size: 11.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.7

File hashes

Hashes for propaths_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 8161f14549a22a4f7a58c867fb8fe0d804ed5829fcf49a2f85302035ae131b9b
MD5 2da3c98a48bb3f9b841f0f9bd0d4148a
BLAKE2b-256 61ebd46dc4a1d623d2f4aaf0b13cd605432fbfd1fe115f844b9a488521b95253

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for propaths_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8fdbef94e3e43bec00ac570b28cffdb8ccfac79296cb2b6ea34883e78a411052
MD5 7bf079f63e1268b18c9740d85842d040
BLAKE2b-256 9fa8018dae1d6844ba4a5971cf4b03ac30d7c4c2923988fae24ee5e8296f1157

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 files

0.1.0

2 files

Supported by

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