Provides AI assistants with access to Ionic Framework documentation, component API references, usage examples, and blog posts.
Also known as capawesome-team/ionic-framework-mcp, @capawesome/ionic-framework-mcp
- Stars
- 1
- Tools
- 5
- Downloads, 30 days
- 166
- Latest version
- 0.0.1
- Last commit
- Nov 12, 2026
- License
- MIT
What is Ionic Framework MCP?
Ionic Framework provides AI assistants with access to Ionic Framework documentation, component API references, usage examples, and blog posts. It exposes 5 tools, such as search_docs, get_doc_page, list_components.
Summary generated from the project's README
About Ionic Framework MCP server
Developers building mobile and web applications can provide their AI assistants with direct access to official Ionic Framework documentation. This server allows tools like Claude Desktop, Cursor, and VS Code to retrieve technical details for Ionic versions 8 and 9. It covers component API references, usage examples for Angular, React, Vue, and vanilla JavaScript, and recent blog posts.
The server is hosted remotely, meaning it requires no local installation or API keys to use via HTTP. Users can connect it to various clients by adding the provided URL to their settings. For environments that only support stdio, a local proxy can be run using npx with Node.js 22 or later. The service includes a rate limit of 100 requests per minute per IP address to ensure stability.
Written from the project's README. Every use case is checked against a quote from it.
How to install Ionic Framework MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Ionic Framework MCP in Claude Code
$ claude mcp add ionic-framework-mcp -- npx -y @capawesome/ionic-framework-mcpInstall Ionic Framework MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"ionic-framework-mcp": {
"command": "npx",
"args": [
"-y",
"@capawesome/ionic-framework-mcp"
]
}
}
}Install Ionic Framework MCP in VS Code
.vscode/mcp.json
{
"servers": {
"ionic-framework-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@capawesome/ionic-framework-mcp"
]
}
}
}Install Ionic Framework MCP in VS Code CLI
$ code --add-mcp '{"name":"ionic-framework-mcp","type":"stdio","command":"npx","args":["-y","@capawesome/ionic-framework-mcp"]}'Install Ionic Framework MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"ionic-framework-mcp": {
"command": "npx",
"args": [
"-y",
"@capawesome/ionic-framework-mcp"
]
}
}
}Install Ionic Framework MCP in Codex
$ codex mcp add ionic-framework-mcp -- npx -y @capawesome/ionic-framework-mcpInstall Ionic Framework MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.ionic-framework-mcp] command = "npx" args = ["-y", "@capawesome/ionic-framework-mcp"]
Install Ionic Framework MCP in Gemini CLI
$ gemini mcp add -s user ionic-framework-mcp npx -- -y @capawesome/ionic-framework-mcpInstall Ionic Framework MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"ionic-framework-mcp": {
"command": "npx",
"args": [
"-y",
"@capawesome/ionic-framework-mcp"
]
}
}
}Ionic Framework MCP tools 5
Detected from the READMEsearch_docsget_doc_pagelist_componentsget_component_usagelist_blog_posts
| search_docs | — | |
| get_doc_page | — | |
| list_components | — | |
| get_component_usage | — | |
| list_blog_posts | — |
Configuration
IONIC_FRAMEWORK_MCP_URL
| Name | Description | |
|---|---|---|
| IONIC_FRAMEWORK_MCP_URL | — |
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSPass
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubIonic Framework MCP Server
Unofficial MCP server for the official Ionic Framework documentation. It gives AI assistants the current documentation for Ionic Framework v9 and v8 — including the component API reference and the usage examples for Angular, React, Vue and vanilla JavaScript — plus the Ionic blog. Not affiliated with or endorsed by Ionic or OutSystems.
Maintained by Capawesome.
Endpoint
The server is hosted and ready to use. No account, no token, no installation:
https://ionic-framework-mcp.capawesome.io/mcp
Installation
Claude Code
claude mcp add --transport http ionic-framework https://ionic-framework-mcp.capawesome.io/mcp
Claude Desktop / Claude.ai
Go to Settings → Connectors → Add custom connector and enter:
- Name:
Ionic Framework - URL:
https://ionic-framework-mcp.capawesome.io/mcp
Cursor
Or add .cursor/mcp.json to your project:
{
"mcpServers": {
"ionic-framework": {
"url": "https://ionic-framework-mcp.capawesome.io/mcp"
}
}
}
VS Code
Or add .vscode/mcp.json to your project:
{
"servers": {
"ionic-framework": {
"type": "http",
"url": "https://ionic-framework-mcp.capawesome.io/mcp"
}
}
}
Windsurf
Add the server to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"ionic-framework": {
"serverUrl": "https://ionic-framework-mcp.capawesome.io/mcp"
}
}
}
Zed
Add the server to your Zed settings.json:
{
"context_servers": {
"ionic-framework": {
"url": "https://ionic-framework-mcp.capawesome.io/mcp"
}
}
}
Any client via npx
Clients that cannot connect to a remote server over HTTP can run this package, which proxies stdio to the hosted server:
{
"mcpServers": {
"ionic-framework": {
"command": "npx",
"args": ["-y", "@capawesome/ionic-framework-mcp"]
}
}
}
Requires Node.js 22 or later.
Tools
| Tool | Purpose | Parameters |
|---|---|---|
search_docs |
Search the documentation by keyword. Start here for any Ionic Framework question. | query (required), section, version, limit |
get_doc_page |
Read a full documentation page returned by search_docs. |
url (required), version |
list_components |
List Ionic Framework components with their API reference. | query, version, limit |
get_component_usage |
Read usage examples for a component, per framework. | component (required), example, framework, version |
list_blog_posts |
List recent posts from the Ionic blog. | — |
Versions
The documentation is available for Ionic Framework v9 (default) and v8. Pass the version parameter to target a specific version.
Rate limits
The endpoint is limited to 100 requests per minute per IP. Requests over the limit are answered with 429 Too Many Requests; retry after a short wait.
Privacy
Your IP address is processed for rate limiting only. Queries and tool arguments are not stored, not logged beyond Cloudflare's standard edge logs, and never used for training. See the Privacy Policy for details.
Related
- Capacitor MCP Server — the same for the Capacitor documentation, plugin list and blog.
- Capawesome MCP Server — the official MCP server for the Capawesome documentation and the Capawesome Cloud management API.
- Capawesome Cloud Live Updates — ship JavaScript, HTML and CSS changes to your app without an app store review.
- Capawesome Cloud Native Builds — build native iOS and Android apps in the cloud, without a Mac.
- Capawesome Cloud App Store Publishing — submit builds to the Apple App Store and Google Play Store.
Attribution
The documentation content is © the Ionic team, licensed under Apache-2.0 and sourced from ionic-team/ionic-docs. It is converted from MDX to Markdown for delivery over MCP and otherwise served unmodified in substance. The component API reference comes from the @ionic/docs package (MIT). Blog excerpts come from the Ionic blog and link to the original post.
See NOTICE for the full attribution.
Development
npm install
npm run build
npm test
Set IONIC_FRAMEWORK_MCP_URL to point the proxy at a local server instead of the hosted one:
IONIC_FRAMEWORK_MCP_URL=http://localhost:8787/mcp node dist/index.js
Release
Releases are managed by release-please. Merging its release pull request tags the version, publishes the package to npm and then publishes server.json to the MCP Registry. The version in server.json is bumped by release-please together with package.json, so it never has to be edited by hand. To publish to the registry manually, install mcp-publisher, run mcp-publisher login dns --domain=capawesome.io --private-key=<key> with the Ed25519 private key from the password manager and then mcp-publisher publish.
License
See LICENSE.
Ionic Framework MCP questions
How do I add Ionic Framework MCP to Claude Code?
Run claude mcp add ionic-framework-mcp -- npx -y @capawesome/ionic-framework-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Ionic Framework MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Ionic Framework MCP provide?
It exposes 5 tools, including search_docs, get_doc_page, list_components, get_component_usage, list_blog_posts.
Which versions of Ionic Framework are supported?
The server provides documentation for Ionic Framework v9 and v8.
Do I need an account or API key to use this server?
No, the server is hosted and ready to use without an account or token.
How can I run this if my client doesn't support HTTP transport?
You can use npx to run the package, which proxies stdio to the hosted server.