io.github.rarasAI/raras

–Likes are community signals, not a measured score.

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Author	io.github.rarasAI
Access	remote
Publisher key required	No
Measured state	Deep-tested
L1 liveness	alive
L1 latency	2710 ms
Last measured	2026-10-24

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "raras": {
      "url": "https://raras.org/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (20)

search_diseases
Full-text search em 10.468 doenças raras. Suporta filtros SUS/trials.
Parameters:
- query (required) — string
- limit — integer
- filter_has_sus_coverage — boolean
- filter_has_active_trials — boolean
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
get_disease_detail
Fenótipos HPO, genes, SUS, trials, descrição clínica em PT.
Parameters:
- orphaCode (required) — string
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
find_diseases_by_phenotypes
Match por IDs HPO. Use para diagnóstico diferencial.
Parameters:
- hpo_ids (required) — array
- limit — integer
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
search_phenotypes read-only
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).
Parameters:
- query (required) — string
- limit — integer
Hints: read-only yes · destructive not declared · idempotent not declared · open-world no
get_sus_coverage
CEAF, SIGTAP, PNTN, nível de integração.
Parameters:
- orphaCode (required) — string
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
find_reference_centers
Centros por doença e/ou UF, com CNES.
Parameters:
- limit — integer
- state — string
- orphaCode — string
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
find_active_trials
Trials ativos com filtro Brazil.
Parameters:
- orphaCode (required) — string
- limit — integer
- in_brazil_only — boolean
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
find_similar_diseases
Vector similarity via embeddings SOTA.
Parameters:
- orphaCode (required) — string
- limit — integer
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
find_phenotypically_similar read-only
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).
Parameters:
- orphaCode (required) — string
- limit — integer
Hints: read-only yes · destructive not declared · idempotent not declared · open-world no
get_graph_stats
Contagens e métricas do dataset.
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
search_papers_semantic
Busca vetorial sobre 424k papers do PubMed. Use caso clínico, pergunta ou conjunto de sintomas.
Parameters:
- query (required) — string
- limit — integer
- min_score — number
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
find_papers_for_disease
Literatura relacionada a uma doença via embeddings (:SEMANTIC_MATCH, fallback vetorial).
Parameters:
- orphaCode (required) — string
- limit — integer
- min_score — number
Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared
analyze_clinical_case read-only
Caso clínico → doenças candidatas + literatura relevante em 1 chamada. Apenas informativo, nunca diagnóstico.
Parameters:
- case_description (required) — string
- papers_limit — integer
- diseases_limit — integer
Hints: read-only yes · destructive not declared · idempotent not declared · open-world no
get_schema read-only
Node labels, relationship types e property keys do grafo. Use antes de cypher_query.
Hints: read-only yes · destructive not declared · idempotent not declared · open-world no
explain_relation read-only
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.
Parameters:
- query (required) — string
- hpo_ids — array
- max_hops
Hints: read-only yes · destructive not declared · idempotent not declared · open-world no
get_literature_relations read-only
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.
Parameters:
- orphaCode (required) — string
- predicate — string
Hints: read-only yes · destructive not declared · idempotent not declared · open-world no
get_hypotheses read-only
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).
Parameters:
- orphaCode (required) — string
Hints: read-only yes · destructive not declared · idempotent not declared · open-world no
get_research_log read-only
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.
Parameters:
- orphaCode (required) — string
Hints: read-only yes · destructive not declared · idempotent not declared · open-world no
get_recent_updates read-only
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).
Parameters:
- days — integer
- limit — integer
Hints: read-only yes · destructive not declared · idempotent not declared · open-world no
get_evidence read-only
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".
Parameters:
- orphaCode (required) — string
Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.