Remove proprietary Alpha Theory terms from MCP docs and tests

Clean up references to AT-internal products (rapi-mcp, pyRapi,
alpha-knowledge-mcp, alpha-collector-mcp, alpha-gateway-mcp,
internal-alpha-theory-mcp, moneyball, hermes_at, atds_research),
employee names, internal file paths, and Data API project references
from the MCP integration guide and unit test Javadoc/comments.

Replace with generic, vendor-neutral language appropriate for an
Apache open source project.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: robertlazarski

modules/openapi/src/test/java/org/apache/axis2/openapi/McpAxis2PayloadTest.java

@@ -52,10 +52,9 @@
 /**
  * Tests focused on the Axis2 JSON-RPC payload format documented in the MCP catalog.
  *
- * <h2>Background — the pyRapi challenge</h2>
+ * <h2>Background</h2>
  *
- * <p>The Python {@code pyRapi} library (and its MCP successor {@code rapi-mcp}) demonstrate
- * that MCP clients calling Axis2 services must wrap their request body in the Axis2 JSON-RPC
+ * <p>MCP clients calling Axis2 services must wrap their request body in the Axis2 JSON-RPC
  * envelope:
  * <pre>
  *   {"operationName":[{"arg0":{&lt;params&gt;}}]}
@@ -68,19 +67,15 @@
  *   <li>Each tool in the MCP catalog carries an {@code x-axis2-payloadTemplate} that is valid
  *       JSON in the correct Axis2 envelope format.</li>
  *   <li>The template is parseable and structurally correct (array of one {@code arg0} object).</li>
- *   <li>The loginService template matches the known working pyRapi format.</li>
+ *   <li>The loginService template matches the documented login payload format.</li>
  *   <li>Auth annotations ({@code x-requiresAuth}) correctly distinguish the public token
- *       endpoint from protected services — mirrors the two-phase auth flow in pyRapi/auth.py
- *       and rapi-mcp/server/rapi/api.py.</li>
+ *       endpoint from protected services — verifying the two-phase auth flow.</li>
  *   <li>The catalog {@code _meta} block gives MCP clients all transport conventions without
  *       requiring out-of-band documentation.</li>
  * </ul>
  *
- * <h2>Relationship to rapi-mcp (Python)</h2>
- * <p>The Python {@code rapi-mcp} server uses Bearer tokens and a flat REST payload — but that
- * server is a proxy that translates MCP tool calls into Axis2 JSON-RPC calls.  These tests
- * verify that the Java Axis2 MCP catalog provides enough information for MCP clients to make
- * the same translation themselves without an intermediary proxy.
+ * <p>These tests verify that the Axis2 MCP catalog provides enough information for MCP clients
+ * to construct correct JSON-RPC payloads without an intermediary proxy.
  */
 public class McpAxis2PayloadTest extends TestCase {
 
@@ -193,7 +188,7 @@ public void testPayloadTemplateArg0IsEmptyObject() throws Exception {
     /**
      * loginService/doLogin is the authentication entry point.
      *
-     * <p>In pyRapi the login call is:
+     * <p>The expected login payload format is:
      * <pre>
      *   {"doLogin":[{"arg0":{"email":"user@example.com","credentials":"pass"}}]}
      * </pre>
@@ -207,7 +202,7 @@ public void testLoginServicePayloadTemplateHasDoLoginKey() throws Exception {
                 parsed.has("doLogin"));
     }
 
-    public void testLoginServicePayloadTemplateCompatibleWithPyRapiFormat() throws Exception {
+    public void testLoginServicePayloadTemplateCompatibleWithExpectedFormat() throws Exception {
         addService("loginService", "doLogin");
         String template = getFirstTool("doLogin").path("x-axis2-payloadTemplate").asText();
         JsonNode parsed = MAPPER.readTree(template);
@@ -235,7 +230,7 @@ public void testLoginServiceNotRequiresAuth() throws Exception {
      * Phase 1: call loginService (no auth) → get token.
      * Phase 2: call protected service with Bearer token.
      *
-     * <p>This mirrors the flow in pyRapi/auth.py and rapi-mcp/server/rapi/api.py.
+     * <p>This verifies the standard Axis2 two-phase Bearer token authentication pattern.
      */
     public void testTwoPhaseAuthFlowDocumentedInCatalog() throws Exception {
         // Register both the token endpoint and a protected service
@@ -299,7 +294,7 @@ public void testMetaAxis2FormatHintContainsArg0() throws Exception {
     /**
      * The {@code _meta.authHeader} must document the Bearer scheme so MCP
      * clients know how to attach the token obtained from loginService.
-     * Mirrors the header set in rapi-mcp's RAPIClient._make_request().
+     * MCP clients use this to attach the token obtained from loginService.
      */
     public void testMetaAuthHeaderDocumentsBearerScheme() throws Exception {
         JsonNode meta = MAPPER.readTree(generator.generateMcpCatalogJson(mockRequest))

modules/openapi/src/test/java/org/apache/axis2/openapi/McpCatalogGeneratorTest.java

@@ -314,8 +314,8 @@ public void testGenerateMcpCatalogWithNullRequestDoesNotThrow() throws Exception
     /**
      * The catalog root must carry a {@code _meta} object so MCP clients know
      * the Axis2 JSON-RPC transport contract without reading separate docs.
-     * Mirrors the pattern in rapi-mcp (Python) where API conventions are
-     * embedded in the tool catalog for client self-sufficiency.
+     * API conventions are embedded in the tool catalog so MCP clients are
+     * self-sufficient without requiring separate documentation.
      */
     public void testCatalogHasMetaObject() throws Exception {
         JsonNode root = MAPPER.readTree(generator.generateMcpCatalogJson(mockRequest));
@@ -361,8 +361,8 @@ public void testMetaHasTokenEndpoint() throws Exception {
      * know to wrap bare JSON params in the Axis2 JSON-RPC envelope:
      * {@code {"operationName":[{"arg0":{...}}]}}.
      *
-     * <p>This is the primary challenge from pyRapi: MCP clients calling Axis2
-     * services must use this wrapping format or the call fails silently.
+     * <p>MCP clients calling Axis2 services must use this wrapping format or
+     * the call fails silently.
      */
     public void testToolHasPayloadTemplateField() throws Exception {
         addService("TestService", "testOp");
@@ -433,8 +433,7 @@ public void testPayloadTemplatesDistinctAcrossOperations() throws Exception {
 
     /**
      * Non-login services must declare {@code x-requiresAuth: true} so MCP
-     * clients know to acquire a Bearer token via loginService first — matching
-     * the auth flow pyRapi implements in pyrapi/auth.py.
+     * clients know to acquire a Bearer token via loginService first.
      */
     public void testNonLoginServiceRequiresAuth() throws Exception {
         addService("testws", "doTestws");
@@ -476,7 +475,7 @@ public void testBigDataServiceRequiresAuth() throws Exception {
     /**
      * Tools must carry MCP 2025 {@code annotations} for client-side safety
      * hints (readOnlyHint, destructiveHint, idempotentHint, openWorldHint).
-     * Matches the annotations pattern in internal-alpha-theory-mcp.
+     * Follows the MCP 2025-03-26 specification for tool annotations.
      */
     public void testToolHasAnnotationsField() throws Exception {
         addService("TestService", "testOp");
@@ -571,18 +570,18 @@ public void testTickerResolveEndpointAbsentWhenNotConfigured() throws Exception
      * This is the primary way to make tool descriptions useful to LLMs.
      */
     public void testOperationLevelMcpDescriptionOverridesDefault() throws Exception {
-        AxisService svc = new AxisService("GetAssetCalculationsService");
+        AxisService svc = new AxisService("CalculationService");
         AxisOperation op = new InOutAxisOperation();
-        op.setName(QName.valueOf("getAssetCalculations"));
+        op.setName(QName.valueOf("getCalculations"));
         op.addParameter(new org.apache.axis2.description.Parameter(
                 "mcpDescription",
-                "Get calculated portfolio metrics (OPS, PWR, Kelly) for assets in a fund."));
+                "Get calculated metrics for items in a dataset."));
         svc.addOperation(op);
         axisConfig.addService(svc);
 
         JsonNode tool = getCatalogTools().get(0);
         assertEquals("Operation-level mcpDescription must be used as tool description",
-                "Get calculated portfolio metrics (OPS, PWR, Kelly) for assets in a fund.",
+                "Get calculated metrics for items in a dataset.",
                 tool.path("description").asText());
     }
 
@@ -642,14 +641,14 @@ public void testDescriptionFallsBackToAutoGeneratedWhenNoMcpDescriptionParam() t
     /**
      * When a service sets {@code mcpReadOnly=true}, the catalog must publish
      * {@code readOnlyHint: true} for all its operations.  Read-only services
-     * (GetAsset*, Search*) should set this so MCP hosts can safely auto-approve
-     * them without human confirmation.
+     * should set this so MCP hosts can safely auto-approve them without human
+     * confirmation.
      */
     public void testServiceLevelMcpReadOnlySetsTrueOnAnnotation() throws Exception {
-        AxisService svc = new AxisService("GetAssetCalculationsService");
+        AxisService svc = new AxisService("ReadOnlyDataService");
         svc.addParameter(new org.apache.axis2.description.Parameter("mcpReadOnly", "true"));
         AxisOperation op = new InOutAxisOperation();
-        op.setName(QName.valueOf("getAssetCalculations"));
+        op.setName(QName.valueOf("getData"));
         svc.addOperation(op);
         axisConfig.addService(svc);