README.md

Mcp

Overview

Model Context Protocol endpoint.

Available Operations

• mcpGet - Open MCP SSE stream
• mcpPost - Send MCP JSON-RPC message
• mcpDelete - Delete MCP session

mcpGet

Open a dedicated Server-Sent Events stream for MCP notifications

Example Usage

package hello.world;

import com.stackone.stackone_client_java.StackOne;
import com.stackone.stackone_client_java.models.components.SchemeBasic;
import com.stackone.stackone_client_java.models.errors.*;
import com.stackone.stackone_client_java.models.operations.StackoneMcpGetResponse;
import com.stackone.stackone_client_java.models.operations.StackoneMcpGetSecurity;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws Exception {

        StackOne sdk = StackOne.builder()
            .build();

        StackoneMcpGetResponse res = sdk.mcp().mcpGet()
                .security(StackoneMcpGetSecurity.builder()
                    .basic(SchemeBasic.builder()
                        .username("")
                        .password("")
                        .build())
                    .build())
                .xAccountId("<id>")
                .mcpSessionId("<id>")
                .call();

        // handle response
    }
}

Parameters

Parameter	Type	Required	Description
security	com.stackone.stackone_client_java.models.operations.StackoneMcpGetSecurity	✔️	The security requirements to use for the request.
xAccountId	Optional<String>	➖	Account secure id for the target provider account (optional if x-account-id query parameter is provided)
xAccountIdQueryParameter	Optional<Object>	➖	Account secure id (alternative to x-account-id header)
mcpSessionId	String	✔️	Session id

Response

StackoneMcpGetResponse

Errors

Error Type	Status Code	Content Type
models/errors/BadRequestResponse	400	application/json
models/errors/UnauthorizedResponse	401	application/json
models/errors/ForbiddenResponse	403	application/json
models/errors/NotFoundResponse	404	application/json
models/errors/RequestTimedOutResponse	408	application/json
models/errors/ConflictResponse	409	application/json
models/errors/UnprocessableEntityResponse	422	application/json
models/errors/TooManyRequestsResponse	429	application/json
models/errors/InternalServerErrorResponse	500	application/json
models/errors/NotImplementedResponse	501	application/json
models/errors/BadGatewayResponse	502	application/json
models/errors/SDKError	4XX, 5XX	*/*

mcpPost

Send JSON-RPC request to the MCP server over HTTP streaming transport

Example Usage: initialize

package hello.world;

import com.stackone.stackone_client_java.StackOne;
import com.stackone.stackone_client_java.models.components.*;
import com.stackone.stackone_client_java.models.errors.*;
import com.stackone.stackone_client_java.models.operations.StackoneMcpPostResponse;
import com.stackone.stackone_client_java.models.operations.StackoneMcpPostSecurity;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws Exception {

        StackOne sdk = StackOne.builder()
            .build();

        StackoneMcpPostResponse res = sdk.mcp().mcpPost()
                .security(StackoneMcpPostSecurity.builder()
                    .basic(SchemeBasic.builder()
                        .username("")
                        .password("")
                        .build())
                    .build())
                .xAccountId("<id>")
                .jsonRpcMessageDto(JsonRpcMessageDto.builder()
                    .jsonrpc("2.0")
                    .method("initialize")
                    .params(Params.builder()
                        .build())
                    .id(Id.builder()
                        .build())
                    .build())
                .call();

        // handle response
    }
}

Example Usage: toolsCall

package hello.world;

import com.stackone.stackone_client_java.StackOne;
import com.stackone.stackone_client_java.models.components.*;
import com.stackone.stackone_client_java.models.errors.*;
import com.stackone.stackone_client_java.models.operations.StackoneMcpPostResponse;
import com.stackone.stackone_client_java.models.operations.StackoneMcpPostSecurity;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws Exception {

        StackOne sdk = StackOne.builder()
            .build();

        StackoneMcpPostResponse res = sdk.mcp().mcpPost()
                .security(StackoneMcpPostSecurity.builder()
                    .basic(SchemeBasic.builder()
                        .username("")
                        .password("")
                        .build())
                    .build())
                .xAccountId("<id>")
                .jsonRpcMessageDto(JsonRpcMessageDto.builder()
                    .jsonrpc("2.0")
                    .method("tools/call")
                    .params(Params.builder()
                        .build())
                    .id(Id.builder()
                        .build())
                    .build())
                .call();

        // handle response
    }
}

Example Usage: toolsList

package hello.world;

import com.stackone.stackone_client_java.StackOne;
import com.stackone.stackone_client_java.models.components.*;
import com.stackone.stackone_client_java.models.errors.*;
import com.stackone.stackone_client_java.models.operations.StackoneMcpPostResponse;
import com.stackone.stackone_client_java.models.operations.StackoneMcpPostSecurity;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws Exception {

        StackOne sdk = StackOne.builder()
            .build();

        StackoneMcpPostResponse res = sdk.mcp().mcpPost()
                .security(StackoneMcpPostSecurity.builder()
                    .basic(SchemeBasic.builder()
                        .username("")
                        .password("")
                        .build())
                    .build())
                .xAccountId("<id>")
                .jsonRpcMessageDto(JsonRpcMessageDto.builder()
                    .jsonrpc("2.0")
                    .method("tools/list")
                    .params(Params.builder()
                        .build())
                    .id(Id.builder()
                        .build())
                    .build())
                .call();

        // handle response
    }
}

Parameters

Parameter	Type	Required	Description
security	com.stackone.stackone_client_java.models.operations.StackoneMcpPostSecurity	✔️	The security requirements to use for the request.
xAccountId	Optional<String>	➖	Account secure id for the target provider account (optional if x-account-id query parameter is provided)
xAccountIdQueryParameter	Optional<Object>	➖	Account secure id (alternative to x-account-id header)
mcpSessionId	Optional<String>	➖	Session id; omit for initialize, include for subsequent calls
jsonRpcMessageDto	JsonRpcMessageDto	✔️	JSON-RPC 2.0 message

Response

StackoneMcpPostResponse

Errors

Error Type	Status Code	Content Type
models/errors/BadRequestResponse	400	application/json
models/errors/UnauthorizedResponse	401	application/json
models/errors/ForbiddenResponse	403	application/json
models/errors/NotFoundResponse	404	application/json
models/errors/RequestTimedOutResponse	408	application/json
models/errors/ConflictResponse	409	application/json
models/errors/UnprocessableEntityResponse	422	application/json
models/errors/TooManyRequestsResponse	429	application/json
models/errors/InternalServerErrorResponse	500	application/json
models/errors/NotImplementedResponse	501	application/json
models/errors/BadGatewayResponse	502	application/json
models/errors/SDKError	4XX, 5XX	*/*

mcpDelete

Close an existing MCP session for the provided session id

Example Usage

package hello.world;

import com.stackone.stackone_client_java.StackOne;
import com.stackone.stackone_client_java.models.components.SchemeBasic;
import com.stackone.stackone_client_java.models.errors.*;
import com.stackone.stackone_client_java.models.operations.StackoneMcpDeleteResponse;
import com.stackone.stackone_client_java.models.operations.StackoneMcpDeleteSecurity;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws Exception {

        StackOne sdk = StackOne.builder()
            .build();

        StackoneMcpDeleteResponse res = sdk.mcp().mcpDelete()
                .security(StackoneMcpDeleteSecurity.builder()
                    .basic(SchemeBasic.builder()
                        .username("")
                        .password("")
                        .build())
                    .build())
                .xAccountId("<id>")
                .mcpSessionId("<id>")
                .call();

        // handle response
    }
}

Parameters

Parameter	Type	Required	Description
security	com.stackone.stackone_client_java.models.operations.StackoneMcpDeleteSecurity	✔️	The security requirements to use for the request.
xAccountId	Optional<String>	➖	Account secure id for the target provider account (optional if x-account-id query parameter is provided)
xAccountIdQueryParameter	Optional<Object>	➖	Account secure id (alternative to x-account-id header)
mcpSessionId	String	✔️	Session id

Response

StackoneMcpDeleteResponse

Errors

Error Type	Status Code	Content Type
models/errors/BadRequestResponse	400	application/json
models/errors/UnauthorizedResponse	401	application/json
models/errors/ForbiddenResponse	403	application/json
models/errors/NotFoundResponse	404	application/json
models/errors/RequestTimedOutResponse	408	application/json
models/errors/ConflictResponse	409	application/json
models/errors/UnprocessableEntityResponse	422	application/json
models/errors/TooManyRequestsResponse	429	application/json
models/errors/InternalServerErrorResponse	500	application/json
models/errors/NotImplementedResponse	501	application/json
models/errors/BadGatewayResponse	502	application/json
models/errors/SDKError	4XX, 5XX	*/*