Add MCP Server for Slate Documentation

[nick-at-finix]

Hey team!

I've been using the Kill Bill docs extensively for some time now, and think it would be awesome if you added an MCP (Model Context Protocol) server for the Slate documentation. This would let AI assistants like Claude directly access and search through your docs.

What's an MCP server?
It's basically a standardized way for AI tools to connect to data sources. Instead of AI assistants having to scrape web pages or rely on outdated training data, they could query your docs directly through a proper API.

Why this would be useful:

• Developers could ask their AI assistant questions about Kill Bill and get accurate, up-to-date answers pulled straight from your docs
• No more outdated info from LLM training data
• Makes your docs more accessible to the growing number of people using AI coding assistants
• Allows AI assistants to piece together custom flows for testing purposes

Our team uses an MCP server for our own API documentation, and has had great success with building some powerful automation for various tasks from it.

Possible Implementation:
The MCP TypeScript SDK (https://github.com/modelcontextprotocol/typescript-sdk) makes this pretty straightforward. You'd essentially create a server that exposes your Slate docs content through the MCP protocol.

Note about Slate:
I checked and Slate itself doesn't have built-in MCP support as far as I can tell (it's focused on static site generation), so this would need to be a custom MCP server that reads from your Slate markdown files or the generated site.

[pierre]

@nick-at-finix try https://apidocs-mcp.killbill.io and let me know if it works!

[nick-at-finix]

@pierre it works great!!

[nick-at-finix]

From Claude Code:

❯ Can you put together a full, working example of creating all the resources and everything I need for using an Aviate wallet for a usage based subscription? Just show me a script with all the minimal curls     
 and a one line comment above each telling what it does

Response:

⏺ Based on the Kill Bill documentation, here's a complete working script for setting up an Aviate wallet with a usage-based subscription:                                                                            
                                                                                                                                                                                                                     
  #!/bin/bash                                                                                                                                                                                                        
                 
  # Configuration                                                                                                                                                                                                    
  KB_URL="http://127.0.0.1:8080/"                                                                                                                                                                                     
  KB_USER="admin:password"
  KB_API_KEY="bob"
  KB_API_SECRET="lazar"

  # Step 1: Get JWT token for Aviate plugin authentication
  ID_TOKEN=$(curl -s -X POST \
      -H 'Content-Type: application/json' \
      -u "${KB_USER}" \
      -H "X-killbill-apiKey: ${KB_API_KEY}" \
      -H "X-killbill-apisecret: ${KB_API_SECRET}" \
      "${KB_URL}/plugins/aviate-plugin/v1/auth" | jq -r '.token')

  # Step 2: Create a customer account
  ACCOUNT_ID=$(curl -s -X POST \
      -u "${KB_USER}" \
      -H "X-Killbill-ApiKey: ${KB_API_KEY}" \
      -H "X-Killbill-ApiSecret: ${KB_API_SECRET}" \
      -H "Content-Type: application/json" \
      -H "X-Killbill-CreatedBy: demo" \
      -d '{"name": "John Doe", "email": "john@example.com", "currency": "USD"}' \
      "${KB_URL}/1.0/kb/accounts" | jq -r '.accountId')

  # Step 3: Create a billing meter for tracking usage
  curl -X POST \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer ${ID_TOKEN}" \
      -H "X-killbill-apiKey: ${KB_API_KEY}" \
      -H "X-killbill-apisecret: ${KB_API_SECRET}" \
      -d '[{
        "name": "api-calls",
        "code": "api-calls",
        "eventKey": "api_request",
        "eventFilters": [],
        "aggregationType": "SUM"
      }]' \
      "${KB_URL}/plugins/aviate-plugin/v1/metering/billingMeters"

  # Step 4: Create usage-based product and plan
  curl -X POST \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer ${ID_TOKEN}" \
      -H "X-killbill-apiKey: ${KB_API_KEY}" \
      -H "X-killbill-apisecret: ${KB_API_SECRET}" \
      -d '{
        "plans": [{
          "name": "usage-based-monthly",
          "prettyName": "Usage Based Monthly",
          "recurringBillingMode": "IN_ADVANCE",
          "pricelistName": "DEFAULT",
          "productName": "API-Service",
          "phases": [{
            "prettyName": "Evergreen Phase",
            "type": "EVERGREEN",
            "durationUnit": "UNLIMITED",
            "durationLength": -1,
            "recurringPrices": {
              "billingPeriod": "MONTHLY",
              "prices": [{"currency": "USD", "value": "0"}]
            },
            "usages": [{
              "usageName": "api-usage",
              "usageType": "CONSUMABLE",
              "prettyName": "API Usage",
              "billingPeriod": "MONTHLY",
              "tierBlockPolicy": "ALL_TIERS",
              "tiers": [{
                "tierNumber": 1,
                "blocks": [{
                  "billingMeterCode": "api-calls",
                  "size": 1,
                  "max": -1,
                  "prices": [{"currency": "USD", "value": "0.01"}]
                }]
              }]
            }]
          }]
        }],
        "products": [{
          "name": "API-Service",
          "category": "BASE"
        }]
      }' \
      "${KB_URL}/plugins/aviate-plugin/v1/catalog/inputData"

  # Step 5: Create a wallet with initial credits and auto top-off
  WALLET_ID=$(curl -s -X POST \
      -H "Authorization: Bearer ${ID_TOKEN}" \
      -H "X-Killbill-ApiKey: ${KB_API_KEY}" \
      -H "X-Killbill-ApiSecret: ${KB_API_SECRET}" \
      -H "Content-Type: application/json" \
      -d "{
        \"kbAccountId\": \"${ACCOUNT_ID}\",
        \"currency\": \"USD\",
        \"initCredit\": {
          \"creditType\": \"CREDIT_FREE\",
          \"amount\": \"50.00\",
          \"expDate\": \"2026-12-31T00:00:00Z\"
        },
        \"topOff\": {
          \"topOffType\": \"TOP_OFF_TARGET\",
          \"lowWatermark\": \"10.00\",
          \"amount\": \"30.00\",
          \"expDurationUnit\": \"MONTHS\",
          \"expDurationLength\": 3
        }
      }" \
      "${KB_URL}/plugins/aviate-plugin/v1/wallet" | jq -r '.wallet.walletId')

  # Step 6: Create a subscription for the usage-based plan
  SUBSCRIPTION_ID=$(curl -s -X POST \
      -u "${KB_USER}" \
      -H "X-Killbill-ApiKey: ${KB_API_KEY}" \
      -H "X-Killbill-ApiSecret: ${KB_API_SECRET}" \
      -H "Content-Type: application/json" \
      -H "X-Killbill-CreatedBy: demo" \
      -d "{
        \"accountId\": \"${ACCOUNT_ID}\",
        \"planName\": \"usage-based-monthly\",
        \"productName\": \"API-Service\",
        \"productCategory\": \"BASE\",
        \"billingPeriod\": \"MONTHLY\",
        \"priceList\": \"DEFAULT\"
      }" \
      "${KB_URL}/1.0/kb/subscriptions" | jq -r '.subscriptionId')

  # Step 7: Submit usage events (simulating 100 API calls)
  curl -X POST \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer ${ID_TOKEN}" \
      -H "X-killbill-apiKey: ${KB_API_KEY}" \
      -H "X-killbill-apisecret: ${KB_API_SECRET}" \
      -d "[{
        \"billingMeterCode\": \"api-calls\",
        \"subscriptionId\": \"${SUBSCRIPTION_ID}\",
        \"trackingId\": \"$(uuidgen)\",
        \"timestamp\": \"$(date -u +%Y-%m-%dT%H:%M:%S)\",
        \"value\": 100
      }]" \
      "${KB_URL}/plugins/aviate-plugin/v1/metering/billing/${ACCOUNT_ID}"

  echo "Setup complete!"
  echo "Account ID: ${ACCOUNT_ID}"
  echo "Wallet ID: ${WALLET_ID}"
  echo "Subscription ID: ${SUBSCRIPTION_ID}"

  This script creates:
  - Account: A customer account in USD currency
  - Billing Meter: Tracks "api-calls" usage
  - Usage-Based Plan: $0.01 per API call, billed monthly
  - Wallet: Starts with $50 free credits, auto-refills to $30 when balance drops below $10
  - Subscription: Activates the usage-based plan
  - Usage Event: Records 100 API calls ($1.00 of usage)

  The wallet will automatically deduct charges from the prepaid balance when invoices are generated.