§ quickstart

Quickstart

Every tool is registered once and exposed three ways — REST, MCP and GraphQL — all generated from the same registry. Authenticate with a Bearer token, pay per request with credits.

curl -X POST https://boracode.ai/api/tools/pii_check \
  -H "Authorization: Bearer bai_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Patient John Doe, email john@example.com, MRN 12345"}'
§ all tools

Tool Registry (0)

§ authentication

Authentication

All requests require a Bearer token. Get one from the admin dashboard.

Authorization: Bearer bai_xxxxxxxxxxxxx
§ billing

Billing

Base LLM call1 credit / 1k tokensz.ai GLM-4.7-flash
PII strip / HL7 redact+2 credits / requestAll methods + profiles
Image analysis10 credits / image + tokensModal GPU (MedGemma 4B IT + LLaVA fallback)
Scan interpretation25 credits / scan + tokensModal GPU (MedGemma 4B IT + LLaVA fallback)
Cache hit (deterministic tools)1 credit flatpii_check, hl7_redact
§ endpoints

API Endpoints

POST/api/tools/{name}Execute a tool
GET/api/toolsList all tools
POST/api/mcpMCP JSON-RPC (tools/list, tools/call)
POST/api/graphqlGraphQL query/mutation
GET/api/graphqlGraphQL SDL schema
GET/api/healthHealth check
GET/api/readyzReadiness + tool count
GET/api/usageUsage summary (Bearer auth)
POST/api/admin/keysCreate API key (admin)
DELETE/api/admin/keysRevoke API key (admin)
GET/api/admin/verifyVerify admin token (no side effects)
POST/api/admin/creditsAdd credits (admin)
GET/api/admin/statsAdmin stats + activity
GET/llms.txtAI agent discovery
GET/llms-full.txtFull API reference for agents
§ oracle apex

Oracle APEX SDK

PL/SQL package with typed wrappers for all 0 tools. Install once, call from any APEX page or Dynamic Action.

-- 1. Install (run as SCANLAB_LIS or SYS)
@packages/apex/boringai_sdk.sql

-- 2. Configure
INSERT INTO gen_system_parameters (code, string_value)
VALUES ('BORINGAI_URL', 'https://boracode.ai');
INSERT INTO gen_system_parameters (code, string_value)
VALUES ('BORINGAI_KEY', 'bai_your_key');
COMMIT;

-- 3. Use from any APEX page
SELECT scanlab_lis.boringai.strip_pii(:P1_TEXT) FROM dual;
SELECT scanlab_lis.boringai.redact_hl7(:P1_HL7_MSG) FROM dual;
SELECT scanlab_lis.boringai.draft_report('breast', :P1_FINDINGS) FROM dual;
SELECT scanlab_lis.boringai.simplify(:P1_REPORT) FROM dual;
SELECT scanlab_lis.boringai.clinical_ner(:P1_NOTE, 'disease,drug') FROM dual;
SELECT scanlab_lis.boringai.check_interactions('warfarin,ibuprofen') FROM dual;
SELECT scanlab_lis.boringai.lookup_icd10(:P1_NOTE, 3) FROM dual;
SELECT scanlab_lis.boringai.interpret_labs(:P1_LABS) FROM dual;
SELECT scanlab_lis.boringai.translate_medical(:P1_TEXT, 'sw') FROM dual;
SELECT scanlab_lis.boringai.analyze_image(:P1_IMAGE_B64) FROM dual;
SELECT scanlab_lis.boringai.interpret_scan(:P1_SCAN_B64, 'chest_xray') FROM dual;
SELECT scanlab_lis.boringai.batch('pii_check', '[{"text":"a"}]') FROM dual;
SELECT scanlab_lis.boringai.list_tools FROM dual;
SELECT scanlab_lis.boringai.get_usage FROM dual;
§ mcp server

MCP Server

The boringai MCP endpoint exposes all 0 tools to any MCP-compatible client (Claude Desktop, Cursor, etc.).

{
  "mcpServers": {
    "boringai": {
      "url": "https://boracode.ai/api/mcp",
      "headers": { "Authorization": "Bearer bai_YOUR_KEY" }
    }
  }
}
§ graphql

GraphQL

Each tool is also exposed as a GraphQL mutation. Inspect the full schema:

curl https://boracode.ai/api/graphql
§ ai agents

AI Agent Discovery

boringai publishes llms.txt and llms-full.txt for AI agents to auto-discover the API.

A wide horizon at dusk: layered hills in muted plum and ochre above a lake that holds the last light, a family of crested cranes at the water's edge, an acacia in silhouette and a single bright star above the ridge.