AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

database-lookup

Queries documented public database APIs with explicit endpoints, filters, pagination, and provenance. Used when a scientific, regulatory, financial, or other database-backed fact must be retrieved reproducibly from a named source rather than inferred from general knowledge.

Original source
K-Dense-AI
License
MIT
Pinned revision
5f2bc0341354fd5590aef76a533ada1e1e5b4e62

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

Ask your assistant

Use Agentic Memory skills to read k-dense-ai--database-lookup at revision 5f2bc0341354fd5590aef76a533ada1e1e5b4e62, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 83

references/biogrid.md

BioGRID API Reference

Base URL

https://webservice.thebiogrid.org/interactions

Authentication

API key REQUIRED. Register free at https://webservice.thebiogrid.org/ to obtain an access key.

  • Pass as query parameter: ?accesskey=YOUR_ACCESS_KEY

Rate Limits

Not formally published. Reasonable usage expected.

Response Format

JSON (with &format=json), tab-delimited (&format=tab2), or XML. Default is tab2.

Key Endpoints

1. Search Interactions by Gene

GET https://webservice.thebiogrid.org/interactions?accesskey={key}&format=json&searchNames=true&geneList={gene_symbol}&taxId={taxon_id}

Example — get TP53 interactions in human:

GET https://webservice.thebiogrid.org/interactions?accesskey=YOUR_KEY&format=json&searchNames=true&geneList=TP53&taxId=9606&max=50

2. Multiple Genes

GET https://webservice.thebiogrid.org/interactions?accesskey={key}&format=json&searchNames=true&geneList=BRCA1|BRCA2&taxId=9606&max=100

Separate gene names with | (pipe).

3. Filter by experimental evidence

GET https://webservice.thebiogrid.org/interactions?accesskey={key}&format=json&searchNames=true&geneList=TP53&taxId=9606&evidenceList=Two-hybrid&includeEvidence=true&max=50

evidenceList is a pipe-separated list of experimental systems, not the words physical or genetic. Without includeEvidence=true, listed systems are excluded. Discover names through /evidence?accesskey={key}&format=json. To select the broad physical/genetic class, filter returned EXPERIMENTAL_SYSTEM_TYPE locally. There is no documented experimentalSystemList query parameter.

5. Search by BioGRID Interaction ID

GET https://webservice.thebiogrid.org/interactions/{interaction_id}?accesskey={key}&format=json

6. Search by PubMed ID

GET https://webservice.thebiogrid.org/interactions?accesskey={key}&format=json&pubmedList=12345678

7. Inter-species Interactions

GET https://webservice.thebiogrid.org/interactions?accesskey={key}&format=json&searchNames=true&geneList=TP53&taxId=9606&interSpeciesExcluded=false

8. Include Interactor Annotations

GET https://webservice.thebiogrid.org/interactions?accesskey={key}&format=json&searchNames=true&geneList=TP53&taxId=9606&includeInteractors=true&max=50

Common Query Parameters

| Parameter | Description | |-----------|-------------| | geneList | Gene symbol(s), pipe-separated | | taxId | NCBI taxonomy ID (9606=human, 10090=mouse, 559292=yeast) | | max | Max results to return (default 10000) | | start | Offset for pagination | | format | json, tab2, extendedTab2, count | | searchNames | true to match official symbols | | selfInteractionsExcluded | true to exclude self-interactions | | evidenceList | Experimental-system names; set includeEvidence=true to include | | throughputTag | low or high |

JSON Response Structure

{
  "12345": {
    "BIOGRID_INTERACTION_ID": 12345,
    "ENTREZ_GENE_A": "7157",
    "ENTREZ_GENE_B": "672",
    "OFFICIAL_SYMBOL_A": "TP53",
    "OFFICIAL_SYMBOL_B": "BRCA1",
    "EXPERIMENTAL_SYSTEM": "Two-hybrid",
    "EXPERIMENTAL_SYSTEM_TYPE": "physical",
    "PUBMED_ID": "9482880",
    "ORGANISM_A": 9606,
    "ORGANISM_B": 9606,
    "THROUGHPUT": "Low Throughput",
    "SCORE": "-"
  }
}

Count-Only Query

GET https://webservice.thebiogrid.org/interactions?accesskey={key}&format=count&searchNames=true&geneList=TP53&taxId=9606

Returns just the integer count.

Notes

  • BioGRID aggregates curated interaction data from literature.
  • Covers physical (protein-protein) and genetic interactions.
  • For bulk data, use BioGRID downloads (tab-delimited files) at https://downloads.thebiogrid.org/.
  • Cross-reference with STRING for combined interaction evidence.

Official contract: https://wiki.thebiogrid.org/doku.php/biogridrest