🧬 BioNFS MCP Server

NFT-Gated Genomic Data for AI Agents

✅ ONLINE & READY

🤖MCP Endpoints

Model Context Protocol for AI agents like Claude Code

GET /health

GET /auth/info

GET /auth/test?user_signature=YOUR_SIG

POST /mcp

🔐Authentication

Web3 signature authentication (EIP-191)

Step 1: Get Your Signature

Visit auth.genobank.app

Sign message: "I want to proceed"

Step 2: Use Signature

Authorization: Bearer 0xa5141ae...

Or query parameter:

?user_signature=0xa5141ae...

📚MCP Capabilities

Tools (4)

list_accessible_files - List your genomic files
query_variants - Query VCF/SQLite variants
get_file_metadata - Get file details
stream_file - Get presigned S3 URLs

Resources (3)

@bionfs:vcf://0xIPID - VCF files
@bionfs:gene://BRCA1 - Gene search
@bionfs:bioip://0xBioIPID - BioIP assets

💻BioFS CLI - NFT-Gated S3 for Genomic Data

Command-line interface for managing your BioNFT-gated genomic files

📦 Installation

npm install -g @genobank/biofs

🔑 Authentication

biofs login

biofs whoami

biofs logout

📂 File Management

biofs files # List all your BioFiles

biofs files --filter vcf # Filter by file type

biofs files --source story # Filter by source

biofs files --json # Output as JSON

⬇️ Download Files (GDPR-Compliant)

biofs download BIOCID # Download by BioID

biofs download 0xIPID # Download by IP ID

biofs download file.vcf ./local/path # Custom destination

⬆️ Upload & Share

biofs upload mydata.vcf

biofs upload video.mp4 --title "Medical Scan"

⛓️ Tokenize as BioIP NFT

biofs tokenize mydata.vcf \ --title "My Genomic Data" \ --description "WGS analysis results" \ --license non-commercial \ --network mainnet

Options:

--title - Custom NFT title
--description - Custom description (AI if omitted)
--license - commercial | non-commercial
--network - mainnet | testnet
--no-ai - Skip AI classification
--dryrun - Preview without tokenizing
--quiet - No interactive prompts

🔐 Access Control (NFT Permissions)

biofs access list # List your accessible assets

biofs access list 0xIPID # List permittees for asset

biofs access request 0xIPID # Request access

biofs access grant 0xIPID 0xWALLET # Grant access (owner)

biofs access revoke 0xIPID 0xWALLET # Revoke access (owner)

biofs access check 0xIPID # Check your access level

biofs access revoke-consent 0xIPID # GDPR: Withdraw consent

🗂️ Mount as Filesystem

biofs mount /mnt/genomics # FUSE mount all granted files

🧪 Research Jobs (BioOS)

biofs job list # List your research jobs

biofs job submit config.yaml # Submit analysis job

biofs job status JOB_ID # Check job status

💡 Pro Tip: Use --debug flag for detailed logging

biofs --debug tokenize mydata.vcf

🔗Quick Links

📊Example MCP Request

curl -H "Authorization: Bearer YOUR_SIGNATURE" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "list_accessible_files",
      "arguments": {
        "file_type": "vcf",
        "limit": 10
      }
    }
  }' \
  https://mcp.genobank.app/mcp