{
  "openapi": "3.1.0",
  "info": {
    "title": "Natural Lending Co public read-only API",
    "version": "1.0.0",
    "description": "Read-only funding information for AI assistants and apps. No authentication. No private data is accepted or stored. Cannot submit applications. This is general information, not an approval, an offer or a promise of terms, amounts or timing. Natural Lending Co works with its lenders, and every funding decision is made by the lender.",
    "contact": {
      "name": "Natural Lending Co",
      "url": "https://naturallendingco.com",
      "email": "robbie@naturallendingco.com"
    }
  },
  "servers": [
    {
      "url": "https://mcp.naturallendingco.com"
    }
  ],
  "paths": {
    "/api/v1/about": {
      "get": {
        "operationId": "aboutNlc",
        "summary": "About Natural Lending Co",
        "responses": {
          "200": {
            "description": "Company facts"
          }
        }
      }
    },
    "/api/v1/programs": {
      "get": {
        "operationId": "listPrograms",
        "summary": "List funding programs",
        "responses": {
          "200": {
            "description": "Programs"
          }
        }
      }
    },
    "/api/v1/programs/{id}": {
      "get": {
        "operationId": "getProgram",
        "summary": "One funding program",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "business-line-of-credit",
                "working-capital",
                "syndicated-line-of-credit",
                "revenue-based-line-of-credit",
                "equipment-financing",
                "invoice-factoring",
                "sba-loans",
                "real-estate-investment-loans",
                "startup-funding",
                "business-heloc",
                "business-credit-improvement",
                "payment-processing"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Program"
          },
          "404": {
            "description": "Unknown id"
          }
        }
      }
    },
    "/api/v1/check-fit": {
      "post": {
        "operationId": "checkFit",
        "summary": "Which programs may fit (ranges only, read-only, nothing stored)",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "time_in_business",
                  "monthly_revenue",
                  "credit_score_range",
                  "need"
                ],
                "additionalProperties": false,
                "properties": {
                  "time_in_business": {
                    "type": "string",
                    "enum": [
                      "pre_launch",
                      "under_6_months",
                      "6_to_12_months",
                      "1_to_2_years",
                      "2_plus_years"
                    ]
                  },
                  "monthly_revenue": {
                    "type": "string",
                    "enum": [
                      "none",
                      "under_10k",
                      "10k_to_25k",
                      "25k_to_50k",
                      "50k_to_100k",
                      "over_100k"
                    ]
                  },
                  "credit_score_range": {
                    "type": "string",
                    "enum": [
                      "under_600",
                      "600_649",
                      "650_699",
                      "700_749",
                      "750_plus",
                      "not_sure"
                    ]
                  },
                  "need": {
                    "type": "string",
                    "enum": [
                      "working_capital",
                      "credit_line",
                      "equipment",
                      "unpaid_invoices",
                      "real_estate_investment",
                      "startup",
                      "sba_or_long_term",
                      "improve_credit",
                      "card_processing",
                      "not_sure"
                    ]
                  },
                  "business_type": {
                    "type": "string",
                    "enum": [
                      "service",
                      "trades_contractor",
                      "trucking_logistics",
                      "retail_ecommerce",
                      "restaurant_hospitality",
                      "healthcare",
                      "real_estate_investor",
                      "other"
                    ]
                  },
                  "has_unpaid_invoices": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Fit results"
          },
          "400": {
            "description": "Invalid or private input"
          }
        }
      }
    },
    "/api/v1/how-it-works": {
      "get": {
        "operationId": "howItWorks",
        "summary": "Steps from applying to a decision",
        "responses": {
          "200": {
            "description": "Steps"
          }
        }
      }
    },
    "/api/v1/documents": {
      "get": {
        "operationId": "documentsChecklist",
        "summary": "What to have ready",
        "responses": {
          "200": {
            "description": "Checklist"
          }
        }
      }
    },
    "/api/v1/faq": {
      "get": {
        "operationId": "faq",
        "summary": "Search the FAQ",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 120
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Answers"
          }
        }
      }
    },
    "/api/v1/guides": {
      "get": {
        "operationId": "freeGuides",
        "summary": "Free guides and tools",
        "responses": {
          "200": {
            "description": "Guides"
          }
        }
      }
    },
    "/api/v1/contact": {
      "get": {
        "operationId": "contactAndApply",
        "summary": "Apply link, phone, hours, booking",
        "responses": {
          "200": {
            "description": "Contact"
          }
        }
      }
    },
    "/api/v1/verify": {
      "get": {
        "operationId": "verifyOperator",
        "summary": "Checkable facts about the operator",
        "responses": {
          "200": {
            "description": "Operator facts"
          }
        }
      }
    }
  }
}