Raras

io.github.rarasAIPublished by GitHub account rarasAIv0.2.0Updated Oct 25, 2026

Disease Twin — Brazil's rare-disease knowledge graph (10,468) over MCP. Source-grounded, PT-BR.

VerifiedStreamable HTTPWeb executableKnowledge & MemoryData & AnalyticsAI & ML

Overview

AI-generated overview

A remote, read-only MCP server over a Brazilian rare-disease knowledge graph, letting an assistant search diseases, phenotypes, SUS coverage, trials and PubMed-

What you can do
Search and read disease records: full-text search with SUS/trial filters, disease detail with HPO phenotypes, genes and clinical description, and similar or phenotypically similar diseases by embeddings or shared HPO profiles. Map symptoms to HPO terms in Portuguese or English, with negated terms excluded, and match diseases by phenotype IDs for differential diagnosis. Look up Brazilian public-health context: SUS coverage (CEAF, SIGTAP, PNTN) and reference centers by disease and state. Explore biomedical literature: semantic search over PubMed papers and literature linked to a disease. Reason over the graph: schema inspection, multi-hop evidence paths, typed literature relations, drug-repurp
When to use it
Useful when working on rare diseases in a Brazilian context: mapping symptoms to HPO terms, building differential-diagnosis candidates, checking SUS coverage or reference centers, or finding literature and research hypotheses. Also suited to exploring a biomedical knowledge graph with grounded, citable evidence.
Requirements
A remote Streamable HTTP endpoint; no installation, account or API key is declared. Network access to the endpoint is needed. The server asks callers to keep phenotype lookups to a few calls per minute and to back off on rate-limit responses.
Before you install
Read-only and public, but it handles health-related content: clinical-case analysis and drug-repurposing hypotheses are explicitly informational and never diagnostic or clinical recommendations. Phenotype lookup covers Portuguese and English only. Rate limits apply, so heavy polling of recent updates may be throttled. Verify evidence against the cited sources before relying on it.

Installation

In SourceWeft

  1. Open Raras in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.rarasAI%2Fraras/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "raras": {
      "type": "http",
      "url": "https://raras.org/api/mcp"
    }
  }
}

README

Raras Disease Twin — MCP Server

Brazilian rare-disease knowledge graph (10,468 diseases) exposed via the Model Context Protocol (MCP). Each disease is an addressable Disease Twin (disease://{orphaCode}): genes, HPO phenotypes, SUS coverage, clinical trials, literature-mined treatments, repurposing hypotheses, and grounded multi-hop reasoning — PT-BR first, source-grounded, never diagnoses.

Connect (no install)

  • Remote endpoint: https://raras.org/api/mcp (Streamable HTTP, public, read-only)
  • Claude Code: claude mcp add --transport http raras https://raras.org/api/mcp
  • claude.ai / Desktop: Settings → Connectors → Add custom connector → paste the URL
  • Docs: https://raras.org/mcp

Skill

SKILL.md is an installable Claude Skill — drop it in .claude/skills/raras-disease-twin/.

License

Data: CC-BY-4.0 · Code: MIT · https://raras.org

Source: README.md at commit f36a0d8

Tools

20

search_diseases

Buscar doenças raras

Full-text search em 10.468 doenças raras. Suporta filtros SUS/trials.

Parameterslimitqueryrequiredfilter_has_sus_coveragefilter_has_active_trials

get_disease_detail

Detalhes de doença rara

Fenótipos HPO, genes, SUS, trials, descrição clínica em PT.

ParametersorphaCoderequired

find_diseases_by_phenotypes

Buscar doenças por fenótipos

Match por IDs HPO. Use para diagnóstico diferencial.

Parameterslimithpo_idsrequired

search_phenotypes

Buscar fenótipos HPO

Lookup HPO em PT-BR (encoder Araras-HPO-Brasil + léxico leigo) ou EN (vocabulário HPO). Retorna IDs HP: com estado de asserção: termo NEGADO ("nunca desmaiei") NÃO vira fenótipo. Outros idiomas não são cobertos. Limite de taxa: use poucas chamadas por minuto (429 = espere).

Parameterslimitqueryrequired

get_sus_coverage

Cobertura SUS

CEAF, SIGTAP, PNTN, nível de integração.

ParametersorphaCoderequired

find_reference_centers

Centros de referência

Centros por doença e/ou UF, com CNES.

ParameterslimitstateorphaCode

find_active_trials

Ensaios clínicos ativos

Trials ativos com filtro Brazil.

ParameterslimitorphaCoderequiredin_brazil_only

find_similar_diseases

Doenças similares

Vector similarity via embeddings SOTA.

ParameterslimitorphaCoderequired

find_phenotypically_similar

Doenças com fenótipos similares

Doenças com perfil de fenótipos HPO semelhante (simGIC pré-computado, explicável: nº de fenótipos em comum). Complementa find_similar_diseases (semântico).

ParameterslimitorphaCoderequired

get_graph_stats

Estatísticas do grafo

Contagens e métricas do dataset.

Takes no parameters.

search_papers_semantic

Busca semântica de papers

Busca vetorial sobre 424k papers do PubMed. Use caso clínico, pergunta ou conjunto de sintomas.

Parameterslimitqueryrequiredmin_score

find_papers_for_disease

Papers de uma doença

Literatura relacionada a uma doença via embeddings (:SEMANTIC_MATCH, fallback vetorial).

Parameterslimitmin_scoreorphaCoderequired

analyze_clinical_case

Analisar caso clínico

Caso clínico → doenças candidatas + literatura relevante em 1 chamada. Apenas informativo, nunca diagnóstico.

Parameterspapers_limitdiseases_limitcase_descriptionrequired

get_schema

Esquema do grafo

Node labels, relationship types e property keys do grafo. Use antes de cypher_query.

Takes no parameters.

explain_relation

Explicar relação (MedGraphRAG, raciocínio multi-hop)

Raciocínio fundamentado sobre o grafo: dada uma pergunta (ex.: "por que o gene X se associa à doença Y?", "como a droga Z se relaciona a esta doença?"), retorna caminhos de evidência multi-hop (doença↔gene↔via↔droga↔fenótipo) com proveniência citável. Se não houver caminho no grafo, recusa — nunca inventa.

Parametersqueryrequiredhpo_idsmax_hops

get_literature_relations

Relações mineradas da literatura (PubTator3)

Relações tipadas extraídas da literatura biomédica (associate/treat/cause/inhibit/stimulate/prevent) entre a doença e genes/fármacos, com nº de publicações como proveniência. Filtrável por predicado.

ParametersorphaCoderequiredpredicate

get_hypotheses

Hipóteses de reposicionamento (co-scientist)

Candidatos a reposicionamento de fármacos gerados por associação de genes (guilt-by-association): drogas que tratam outras doenças que compartilham genes com esta. HIPÓTESES para investigação, NUNCA recomendações clínicas — cada uma rastreável (via gene X, da doença Y).

ParametersorphaCoderequired

get_research_log

Diário de pesquisa do Disease Twin

Registro cronológico do que o agente autônomo fez por esta doença: autoria, mineração de literatura, evidência genética, verificação, prospecção de fontes, recomputação de relações. Prova de que o gêmeo digital estuda a doença continuamente.

ParametersorphaCoderequired

get_recent_updates

Disease Twins atualizados recentemente

Doenças cujo gêmeo digital ganhou evidência nova (autoria, PubTator3, Open Targets, verificação) nos últimos N dias. Faça polling para acompanhar mudanças (substituto stateless de subscriptions).

Parametersdayslimit

get_evidence

Proveniência / evidências

Cross-references de autoridade (Orphanet, MONDO, OMIM, MeSH, GARD, UMLS), status de verificação e PMIDs de uma doença. A base da regra "nunca inventar".

ParametersorphaCoderequired

Version history

1
  1. v0.2.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.