Skip to content

Add MCP Quick Start Documentation for both typeScript and python and Add Agent QuickStart doc to Identity Server 7.2.0 and next branch #6048

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pavinduLakshan merged 8 commits into from
Apr 11, 2026
Merged

Add MCP Quick Start Documentation for both typeScript and python and Add Agent QuickStart doc to Identity Server 7.2.0 and next branch #6048

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
60a1381
Add MCP Quick Start
ranuka-laksika Apr 9, 2026
5deca4c
Address Qucik start doc for Identity server
ranuka-laksika Apr 9, 2026
755f8b9
Address suggestion
ranuka-laksika Apr 9, 2026
eedf8ef
Address Sugeestion from coderabbitai
ranuka-laksika Apr 9, 2026
f96922a
Address comments
ranuka-laksika Apr 9, 2026
fb50ece
Add Agent Quick start doc to Identity Server
ranuka-laksika Apr 10, 2026
461f41d
Address typo
ranuka-laksika Apr 10, 2026
1440b0f
Address Sugesstions
ranuka-laksika Apr 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion en/asgardeo/docs/quick-starts/mcp-auth-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ template: templates/quick-start.html
<script>
const meta = {
what_you_will_learn: [
"Create a new MCP server in Typescript",
"Create a new MCP server in TypeScript",
"Defines an MCP tool that adds two numbers",
"Install <a href='https://www.npmjs.com/package/@asgardeo/mcp-express' target='_blank' rel='noopener noreferrer'>Asgardeo MCP SDK</a>",
"Set up MCP authorization with {{ product_name }}"
Expand Down
25 changes: 25 additions & 0 deletions en/identity-server/7.2.0/docs/quick-starts/agent-auth-py.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
template: templates/quick-start.html
---

<script>
const meta = {

Check warning on line 6 in en/identity-server/7.2.0/docs/quick-starts/agent-auth-py.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[WSO2-IAM.SentenceLength] Try to keep sentences short (< 30 words).

Raw Output:
{"message": "[WSO2-IAM.SentenceLength] Try to keep sentences short (\u003c 30 words).", "location": {"path": "en/identity-server/7.2.0/docs/quick-starts/agent-auth-py.md", "range": {"start": {"line": 6, "column": 3}}}, "severity": "INFO"}

Check warning on line 6 in en/identity-server/7.2.0/docs/quick-starts/agent-auth-py.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'const'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'const'?", "location": {"path": "en/identity-server/7.2.0/docs/quick-starts/agent-auth-py.md", "range": {"start": {"line": 6, "column": 3}}}, "severity": "WARNING"}
what_you_will_learn: [

Check warning on line 7 in en/identity-server/7.2.0/docs/quick-starts/agent-auth-py.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'what_you_will_learn'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'what_you_will_learn'?", "location": {"path": "en/identity-server/7.2.0/docs/quick-starts/agent-auth-py.md", "range": {"start": {"line": 7, "column": 5}}}, "severity": "WARNING"}
"Authenticate AI agents with {{ product_name }}",
"Use agent credentials or On-Behalf-Of (OBO) authentication flows",
"Connect authenticated agents to secure MCP servers",
"Invoke MCP tools safely from modern AI agent frameworks"
],
prerequisites: [
"About 15 minutes",
"A <a href='{{ base_path }}/get-started/quick-set-up/'>{{ product_name }} setup</a>",
"Python 3.10 or later installed on your system",
"pip or another Python package manager",
"A text editor or IDE",
"An MCP server secured with {{ product_name }} (you may use your own or follow the <a href='{{ base_path }}/quick-starts/mcp-auth-server-py/'>MCP Server Auth quickstart</a>)"
],
source_code: "<a href='https://github.com/wso2/iam-ai-samples/tree/main/agent-identity/python' target='_blank' class='github-icon'>Agent-Auth Python Sample</a>"

Check warning on line 21 in en/identity-server/7.2.0/docs/quick-starts/agent-auth-py.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'source_code'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'source_code'?", "location": {"path": "en/identity-server/7.2.0/docs/quick-starts/agent-auth-py.md", "range": {"start": {"line": 21, "column": 5}}}, "severity": "WARNING"}
};
</script>

{% include "../../../../includes/quick-starts/agent-auth-py.md" %}
25 changes: 25 additions & 0 deletions en/identity-server/7.2.0/docs/quick-starts/agent-auth-ts.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
template: templates/quick-start.html
---

<script>
const meta = {

Check warning on line 6 in en/identity-server/7.2.0/docs/quick-starts/agent-auth-ts.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[WSO2-IAM.SentenceLength] Try to keep sentences short (< 30 words).

Raw Output:
{"message": "[WSO2-IAM.SentenceLength] Try to keep sentences short (\u003c 30 words).", "location": {"path": "en/identity-server/7.2.0/docs/quick-starts/agent-auth-ts.md", "range": {"start": {"line": 6, "column": 3}}}, "severity": "INFO"}

Check warning on line 6 in en/identity-server/7.2.0/docs/quick-starts/agent-auth-ts.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'const'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'const'?", "location": {"path": "en/identity-server/7.2.0/docs/quick-starts/agent-auth-ts.md", "range": {"start": {"line": 6, "column": 3}}}, "severity": "WARNING"}
what_you_will_learn: [

Check warning on line 7 in en/identity-server/7.2.0/docs/quick-starts/agent-auth-ts.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'what_you_will_learn'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'what_you_will_learn'?", "location": {"path": "en/identity-server/7.2.0/docs/quick-starts/agent-auth-ts.md", "range": {"start": {"line": 7, "column": 5}}}, "severity": "WARNING"}
"Authenticate AI agents with {{ product_name }}",
"Use agent credentials or On-Behalf-Of (OBO) authentication flows",
"Connect authenticated agents to secure MCP servers",
"Invoke MCP tools safely from modern AI agent frameworks"
],
prerequisites: [
"About 15 minutes",
"A <a href='{{ base_path }}/get-started/quick-set-up/'>{{ product_name }} setup</a>",
"Node.js installed on your system",
"Make sure you have a JavaScript package manager like npm, yarn, or pnpm",

Check warning on line 17 in en/identity-server/7.2.0/docs/quick-starts/agent-auth-ts.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'pnpm'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'pnpm'?", "location": {"path": "en/identity-server/7.2.0/docs/quick-starts/agent-auth-ts.md", "range": {"start": {"line": 17, "column": 75}}}, "severity": "WARNING"}

Check warning on line 17 in en/identity-server/7.2.0/docs/quick-starts/agent-auth-ts.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'npm'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'npm'?", "location": {"path": "en/identity-server/7.2.0/docs/quick-starts/agent-auth-ts.md", "range": {"start": {"line": 17, "column": 61}}}, "severity": "WARNING"}
"A text editor or IDE",
"An MCP server secured with {{ product_name }} (you may use your own or follow the <a href='{{ base_path }}/quick-starts/mcp-auth-server/'>MCP Server Auth quickstart</a>)"
],
source_code: "<a href='https://github.com/wso2/iam-ai-samples/tree/main/agent-identity/typescript' target='_blank' class='github-icon'>Agent-Auth TypeScript Sample</a>"

Check warning on line 21 in en/identity-server/7.2.0/docs/quick-starts/agent-auth-ts.md

View workflow job for this annotation

GitHub Actions / Vale style check 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'source_code'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'source_code'?", "location": {"path": "en/identity-server/7.2.0/docs/quick-starts/agent-auth-ts.md", "range": {"start": {"line": 21, "column": 5}}}, "severity": "WARNING"}
};
</script>

{% include "../../../../includes/quick-starts/agent-auth-ts.md" %}
23 changes: 23 additions & 0 deletions en/identity-server/7.2.0/docs/quick-starts/mcp-auth-server-py.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
template: templates/quick-start.html
---

<script>
const meta = {
what_you_will_learn: [
"Set up a secure MCP server using Python",
"Connect your MCP server to {{ product_name }} for authentication",
"Access MCP tools and resources securely"
],
prerequisites: [
"About 15 minutes",
"<a href='{{ base_path }}/get-started/quick-set-up/'>Set up {{ product_name }}</a>",
"Install Python 3.10 or later on your system",
"Python package manager (e:g.: pip) installed",
"A text editor or IDE"
],
source_code: "<a href='https://github.com/wso2/iam-ai-samples/tree/main/mcp-auth/python' target='_blank' class='github-icon'>MCP-Auth Python Sample</a>"
};
</script>

{% include "../../../../includes/quick-starts/mcp-auth-server-py.md" %}
24 changes: 24 additions & 0 deletions en/identity-server/7.2.0/docs/quick-starts/mcp-auth-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
template: templates/quick-start.html
---

<script>
const meta = {
what_you_will_learn: [
"Create a new MCP server in TypeScript",
"Defines an MCP tool that adds two numbers",
"Install <a href='https://www.npmjs.com/package/@asgardeo/mcp-express' target='_blank' rel='noopener noreferrer'>Asgardeo MCP SDK</a>",
"Set up MCP authorization with {{ product_name }}"
],
prerequisites: [
"About 15 minutes",
"<a href='{{ base_path }}/get-started/quick-set-up/'>Set up {{ product_name }}</a>",
"Install Node.js on your system",
"Make sure you have a JavaScript package manager like npm, yarn, or pnpm",
"A text editor or IDE"
],
source_code: "<a href='https://github.com/wso2/iam-ai-samples/tree/main/mcp-auth/typescript' target='_blank' class='github-icon'>MCP-Auth Sample</a>"
};
</script>

{% include "../../../../includes/quick-starts/mcp-auth-server.md" %}
6 changes: 6 additions & 0 deletions en/identity-server/7.2.0/mkdocs.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -575,6 +575,12 @@ nav:
- OIDC Java EE: get-started/try-samples/qsg-oidc-webapp-java-ee.md
- SAML Java EE: get-started/try-samples/qsg-saml-webapp-java-ee.md
- WS-Federation: get-started/try-samples/ws-federation-webapp.md
- Secure MCP Servers:
- TypeScript: quick-starts/mcp-auth-server.md
- Python: quick-starts/mcp-auth-server-py.md
- Secure Your AI Agents:
- Python: quick-starts/agent-auth-py.md
- TypeScript: quick-starts/agent-auth-ts.md
- Subscribe to AI features: get-started/subscribe-to-ai-features.md
- About this release: get-started/about-this-release.md
- Guides:
Expand Down
25 changes: 25 additions & 0 deletions en/identity-server/next/docs/quick-starts/agent-auth-py.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
template: templates/quick-start.html
---

<script>
const meta = {
what_you_will_learn: [
"Authenticate AI agents with {{ product_name }}",
"Use agent credentials or On-Behalf-Of (OBO) authentication flows",
"Connect authenticated agents to secure MCP servers",
"Invoke MCP tools safely from modern AI agent frameworks"
],
prerequisites: [
"About 15 minutes",
"A <a href='{{ base_path }}/get-started/quick-set-up/'>{{ product_name }} setup</a>",
"Python 3.10 or later installed on your system",
"pip or another Python package manager",
"A text editor or IDE",
"An MCP server secured with {{ product_name }} (you may use your own or follow the [MCP Auth Server quickstart]({{base_path}}/quick-starts/mcp-auth-server-py))"
],
source_code: "<a href='https://github.com/wso2/iam-ai-samples/tree/main/agent-identity/python' target='_blank' class='github-icon'>Agent-Auth Python Sample</a>"
};
</script>

{% include "../../../../includes/quick-starts/agent-auth-py.md" %}
25 changes: 25 additions & 0 deletions en/identity-server/next/docs/quick-starts/agent-auth-ts.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
template: templates/quick-start.html
---

<script>
const meta = {
what_you_will_learn: [
"Authenticate AI agents with {{ product_name }}",
"Use agent credentials or On-Behalf-Of (OBO) authentication flows",
"Connect authenticated agents to secure MCP servers",
"Invoke MCP tools safely from modern AI agent frameworks"
],
prerequisites: [
"About 15 minutes",
"A <a href='{{ base_path }}/get-started/quick-set-up/'>{{ product_name }} setup</a>",
"Node.js installed on your system",
"Make sure you have a JavaScript package manager like npm, yarn, or pnpm",
"A text editor or IDE",
"An MCP server secured with {{ product_name }} (you may use your own or follow the [MCP Auth Server quickstart]({{base_path}}/quick-starts/mcp-auth-server))"
],
source_code: "<a href='https://github.com/wso2/iam-ai-samples/tree/main/agent-identity/typescript' target='_blank' class='github-icon'>Agent-Auth TypeScript Sample</a>"
};
</script>

{% include "../../../../includes/quick-starts/agent-auth-ts.md" %}
23 changes: 23 additions & 0 deletions en/identity-server/next/docs/quick-starts/mcp-auth-server-py.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
template: templates/quick-start.html
---

<script>
const meta = {
what_you_will_learn: [
"Set up a secure MCP server using Python",
"Connect your MCP server to {{ product_name }} for authentication",
"Access MCP tools and resources securely"
],
prerequisites: [
"About 15 minutes",
"<a href='{{ base_path }}/get-started/quick-set-up/'>Set up {{ product_name }}</a>",
"Install Python 3.10 or later on your system",
"Python package manager (e:g.: pip) installed",
"A text editor or IDE"
],
source_code: "<a href='https://github.com/wso2/iam-ai-samples/tree/main/mcp-auth/python' target='_blank' class='github-icon'>MCP-Auth Python Sample</a>"
};
</script>

{% include "../../../../includes/quick-starts/mcp-auth-server-py.md" %}
24 changes: 24 additions & 0 deletions en/identity-server/next/docs/quick-starts/mcp-auth-server.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
template: templates/quick-start.html
---

<script>
const meta = {
what_you_will_learn: [
"Create a new MCP server in TypeScript",
"Defines an MCP tool that adds two numbers",
"Install <a href='https://www.npmjs.com/package/@asgardeo/mcp-express' target='_blank' rel='noopener noreferrer'>Asgardeo MCP SDK</a>",
"Set up MCP authorization with {{ product_name }}"
],
prerequisites: [
"About 15 minutes",
"<a href='{{ base_path }}/get-started/quick-set-up/'>Set up {{ product_name }}</a>",
"Install Node.js on your system",
"Make sure you have a JavaScript package manager like npm, yarn, or pnpm",
"A text editor or IDE"
],
source_code: "<a href='https://github.com/wso2/iam-ai-samples/tree/main/mcp-auth/typescript' target='_blank' class='github-icon'>MCP-Auth Sample</a>"
};
</script>

{% include "../../../../includes/quick-starts/mcp-auth-server.md" %}
6 changes: 6 additions & 0 deletions en/identity-server/next/mkdocs.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -584,6 +584,12 @@ nav:
- OIDC Java EE: get-started/try-samples/qsg-oidc-webapp-java-ee.md
- SAML Java EE: get-started/try-samples/qsg-saml-webapp-java-ee.md
- WS-Federation: get-started/try-samples/ws-federation-webapp.md
- Secure MCP Servers:
- TypeScript: quick-starts/mcp-auth-server.md
- Python: quick-starts/mcp-auth-server-py.md
- Secure Your AI Agents:
- Python: quick-starts/agent-auth-py.md
- TypeScript: quick-starts/agent-auth-ts.md
- Subscribe to AI features: get-started/subscribe-to-ai-features.md
- About this release: get-started/about-this-release.md
- Guides:
Expand Down
Loading
Loading