Skip to content
famasi.ai

Provider Tools

Provider Tools

When you’re authenticated as a provider, you get access to 24 operations across 9 categories for managing your pharmacy, patients, orders, and analytics.

Authentication

Terminal window
# Link your provider account
npx @famasi/agents@latest link provider --provider-id YOUR_PROVIDER_ID


# This creates .famasi/provider-link.json with your provider context

Customer Management

Terminal window
# List all customers
fetchCustomers({ page: 1, search: "John" })


# Create new customer
addProviderCustomer({
  name: "John Doe",
  phone: "+2348012345678",
  email: "john@example.com"
})


# View customer details
viewProviderCustomerDetails({ customerId: "CUST-123" })


# Add customer to plan
addCustomerPlan({ customerId: "CUST-123", planId: "PLAN-456" })

Orders

Terminal window
# List all orders
getAllProviderOrder({ page: 1, status: "pending" })


# Create new order
createNewProviderOrderController({
  customerId: "CUST-123",
  pharmacyId: "PH-456",
  items: [{ medicationId: "MED-789", quantity: 2 }]
})

Formulary & Products

Terminal window
# Search formulary
fetchFormularyForProvider({
  query: "Amoxicillin 500mg",
  branchId: "BR-123"
})

Analytics

Terminal window
# Get platform analytics
getProviderAnalytics({
  startDate: "2026-01-01",
  endDate: "2026-04-30"
})


# Get order analytics
getProviderOrderAnalytics({
  period: "month"
})


# Get order stats
getProviderOrderStats()

Wallet & Transactions

Terminal window
# Check wallet balance
getProviderWalletBalance()


# View transaction history
getProviderTransactionHistory({
  page: 1,
  limit: 20
})


# Get virtual accounts
getAllProviderVirtualAccounts()

User Management

Terminal window
# Create provider user
createProviderUser({
  name: "Dr. Sarah",
  email: "sarah@pharmacy.com",
  role: "admin"
})


# List user profiles
getProviderProfiles()

Provider Management

Terminal window
# Edit provider info
editProviderInfo({
  name: "GreenCross Pharmacy",
  contact: "+2348012345678"
})


# Upload logo
uploadProviderLogo({ file: "logo.png" })


# Update payment type
updatePaymentType({ type: "bank_transfer" })


# Set low balance threshold
setLowWalletThreshold({ threshold: 10000 })


# Toggle auto-debit
toggleAutoDebit({ enabled: true })

Tool details

Each tool has its own documentation:

Next steps