Asgardeo MCP Server

The Asgardeo MCP Server allows you to manage your Asgardeo organization or WSO2 Identity Server deployment seamlessly using LLM tools, enabling natural language interactions for various configuration tasks.

[!IMPORTANT] Experimental Feature Notice
This software includes experimental functionality and is not intended for use in production environments. Features, APIs, and functionality may change as the implementation evolves without prior notice.

Key Use Cases

With tools like Claude Desktop, you can:

• List Applications: Retrieve a list of all applications in your organization.
• Create Applications: Set up single-page, web, mobile or m2m applications and integrate it with the Asgardeo authentication SDK.
• Retrieve Application Details: Fetch detailed information about specific applications.
• Configure Login Flows: Customize the login flow of an application using natural language prompts and the available tools, enabling seamless user authentication experiences.

Demonstrations

• Listing Applications in Claude
  

• Fetching Application Details in Claude
  

How to Use

On Asgardeo / WSO2 Identity Server

1. Create an M2M Application: Set up an M2M application in your organization.
2. Authorize Management APIs: Grant the following scopes to the application:

| API | Scopes | |-----|--------| | Application Management API (/api/server/v1/applications) | internal_application_mgt_view, internal_application_mgt_update, internal_application_mgt_create | | API Resource Management API (/api/server/v1/api-resources) | internal_api_resource_update, internal_api_resource_create, internal_api_resource_view | | Identity Provider Management API (/api/server/v1/identity-providers) | internal_idp_view | | Authenticators Management API (/api/server/v1/authenticators) | internal_authenticator_view | | Claim Management API (/api/server/v1/claim-dialects) | internal_claim_meta_view | | SCIM2 Users API (/scim2/Users) | internal_user_mgt_create | | OIDC Scope Management API (/api/server/v1/oidc/scopes) | internal_oidc_scope_mgt_view |

3. Copy Credentials: Save the client ID and client secret of the M2M application.

On Your Machine

4. Clone the Repository:

git clone https://github.com/asgardeo/asgardeo-mcp-server.git

5. Install Dependencies:

go mod tidy

6. Build the Executable:

go build -o asgardeo-mcp

7. Configure Your MCP Client:

VS Code (GitHub Copilot)

• Install the GitHub Copilot extension.
• Open VS Code Settings (File > Preferences > Settings).
• Search for "MCP" and edit the settings.json file:

  "mcp": {
    "servers": {
        "asgardeo-mcp-server": {
            "type": "stdio",
            "command": "<absolute path to the asgardeo-mcp executable, e.g., /Users/<user directory>/<repository path>/asgardeo-mcp-server/asgardeo-mcp>",
            "args": [],
            "env": {
                "BASE_URL" : "https://api.asgardeo.io/t/<asgardeo organization>",
                "CLIENT_ID" : "<client ID>",
                "CLIENT_SECRET" : "<client secret>"
              }
            }
    }
    }
  

• Save the file and start the MCP server from settings.json.

Claude Desktop

• Open Claude Desktop and navigate to Settings > Developer.
• Edit the claude_desktop_config.json file:

  "asgardeo-mcp": {
   "command": "<absolute path to the asgardeo-mcp executable, e.g., /Users/<user directory>/<repository path>/asgardeo-mcp-server/asgardeo-mcp>",
   "args": [],
   "env": {
    "BASE_URL": "https://api.asgardeo.io/t/<asgardeo organization>",
    "CLIENT_ID": "<client ID>",
    "CLIENT_SECRET": "<client secret>"
   }
  }
  ``
  

... View full README on GitHub