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://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

propaths_mcp-0.1.0.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.0-py3-none-any.whl (10.3 kB view details)

Uploaded Python 3

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

Hashes for propaths_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 135508bfec885b82a4f9bc34eacb2769a00180c0b6ecf08acaaf4ec371335fa7
MD5 8bf3352b00cf9cc460996f0d35a28c57
BLAKE2b-256 8555990c5ad5fea1411b227a0a43835c2266a7e6ab51f1c180f9332adcd50466

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for propaths_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5e597c9dd6cb1e03bad352b4f1cd3bd6fbd81948828d3b75f40d0934489ef5ac
MD5 86b9fbe088395527aae8d1416a131cdf
BLAKE2b-256 6d98679dd8e6e3ee6a9479b20b584c66d1fe23e0f7e665606705f8bcc09c51bd

See more details on using hashes here.

Release history Release notifications | RSS feed

0.1.1

2 files

This release

0.1.0 This release

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