§ 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 toolGET
/api/toolsList all toolsPOST
/api/mcpMCP JSON-RPC (tools/list, tools/call)POST
/api/graphqlGraphQL query/mutationGET
/api/graphqlGraphQL SDL schemaGET
/api/healthHealth checkGET
/api/readyzReadiness + tool countGET
/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 + activityGET
/llms.txtAI agent discoveryGET
/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.
