TypeScript SDK

npm install @biocontext7/sdk

import { BioContext7Client } from "@biocontext7/sdk";
 
const client = new BioContext7Client({
  baseUrl: "http://localhost:3000",
});
 
// Search for tools
const results = await client.search("RNA-seq alignment");
for (const tool of results.tools) {
  console.log(`${tool.name}: ${tool.description}`);
}

import { BioContext7Client } from "@biocontext7/sdk";
 
const client = new BioContext7Client({
  baseUrl: "http://localhost:3000",
  apiKey: process.env.BC7_API_KEY, // optional
  timeout: 30000, // optional, in ms
});

const results = await client.search("alignment", {
  operation: "operation:0292",
  topic: "topic:3308",
  limit: 10,
});
 
// results.tools: Tool[]
// results.total: number

const tool = await client.getTool("star");
// tool.name, tool.description, tool.operations, tool.inputs, tool.outputs

const suggestion = await client.suggestPipeline(
  "RNA-seq differential expression"
);
// suggestion.steps: PipelineStep[]

const pipeline = await client.createPipeline(
  "RNA-seq from FASTQ to counts",
  { target: "nextflow" }
);
 
if (pipeline.success) {
  console.log(pipeline.files["main.nf"]);
}

const edam = await client.lookupEdam("sequence alignment");
// edam.uri: string
// edam.term: string

interface Tool {
  id: string;
  name: string;
  description: string;
  version?: string;
  operations: EdamTerm[];
  topics: EdamTerm[];
  inputs: DataType[];
  outputs: DataType[];
  homepage?: string;
  containers?: ContainerInfo;
}
 
interface EdamTerm {
  uri: string;
  term: string;
}
 
interface SearchResult {
  tools: Tool[];
  total: number;
  query: string;
}
 
interface PipelineResult {
  success: boolean;
  target: string;
  files: Record<string, string>;
  tools_discovered: number;
  lsp_iterations: number;
  stub_test_passed: boolean;
}

import { biocontext7Tools } from "@biocontext7/tools-ai-sdk";
import { generateText } from "ai";
import { anthropic } from "@ai-sdk/anthropic";
 
const result = await generateText({
  model: anthropic("claude-sonnet-4-5-20250929"),
  tools: biocontext7Tools(),
  prompt: "Find tools for protein structure prediction",
});