Ionic Framework Mcp

io.capawesomePublished by capawesome.ioOfficial publisherv0.0.1Updated Oct 24, 2026

Unofficial MCP server for the Ionic Framework documentation, components and blog.

The publisher's own server: Capacitor Mcp

VerifiedStreamable HTTPWeb executableKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

Unofficial MCP server that gives an assistant the Ionic Framework v9/v8 docs, component API reference, usage examples and blog.

What you can do
  • Search the official Ionic Framework documentation by keyword, with optional section and version filters
  • Read a full documentation page as markdown, end to end
  • List UI components with tag names, descriptions and links, optionally filtered
  • Read official usage examples for a component in Angular, React, Vue or vanilla JavaScript
  • List the 10 most recent Ionic blog posts with title, date, tags and excerpt
When to use it
Useful when building or debugging Ionic Framework apps and you want the assistant to answer from current v9 or v8 documentation and real component usage examples instead of guessing APIs. Also handy for checking recent releases, announcements and deprecations from the Ionic blog.
Requirements
A remote MCP endpoint over streamable HTTP; no account, token or installation needed. Clients that cannot use remote HTTP can run the npm package via npx as a stdio proxy, which requires Node.js 22 or later. Network access to the hosted endpoint; rate limited to 100 requests per minute per IP.
Before you install
Unofficial and not affiliated with or endorsed by Ionic or OutSystems. Queries and tool arguments are sent to a third-party hosted service; the README says the IP address is processed for rate limiting and queries are not stored or used for training. Read-only documentation tools, so no data is written or changed.

Installation

In SourceWeft

  1. Open Ionic Framework Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.capawesome%2Fionic-framework-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "ionic-framework": {
      "type": "http",
      "url": "https://ionic-framework-mcp.capawesome.io/mcp"
    }
  }
}

README

Ionic 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

bash
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

[Install in Cursor]

Or add .cursor/mcp.json to your project:

json
{  "mcpServers": {    "ionic-framework": {      "url": "https://ionic-framework-mcp.capawesome.io/mcp"    }  }}

VS Code

Install in VS Code

Or add .vscode/mcp.json to your project:

json
{  "servers": {    "ionic-framework": {      "type": "http",      "url": "https://ionic-framework-mcp.capawesome.io/mcp"    }  }}

Windsurf

Add the server to ~/.codeium/windsurf/mcp_config.json:

json
{  "mcpServers": {    "ionic-framework": {      "serverUrl": "https://ionic-framework-mcp.capawesome.io/mcp"    }  }}

Zed

Add the server to your Zed settings.json:

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:

json
{  "mcpServers": {    "ionic-framework": {      "command": "npx",      "args": ["-y", "@capawesome/ionic-framework-mcp"]    }  }}

Requires Node.js 22 or later.

Tools

ToolPurposeParameters
search_docsSearch the documentation by keyword. Start here for any Ionic Framework question.query (required), section, version, limit
get_doc_pageRead a full documentation page returned by search_docs.url (required), version
list_componentsList Ionic Framework components with their API reference.query, version, limit
get_component_usageRead usage examples for a component, per framework.component (required), example, framework, version
list_blog_postsList 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

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

bash
npm installnpm run buildnpm test

Set IONIC_FRAMEWORK_MCP_URL to point the proxy at a local server instead of the hosted one:

bash
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.

Source: README.md at commit d3f3a06

Tools

5

search_docs

Search Ionic Framework documentation

Search the official Ionic Framework documentation from ionicframework.com by keyword. Use this first for any question about Ionic Framework itself — a UI component and its properties, events and CSS custom properties, theming and layout, the Angular, React and Vue integrations, navigation and routing, the Ionic CLI, or upgrading to a newer major version — because guessing a component property or a CSS variable produces markup that silently does nothing. Returns the best matching page sections with `title`, `url`, `snippet`, `section` and `version`, plus the `parentTitle` and `parentUrl` of the page a section belongs to. The same results are attached as structured content. Do not use this to read a whole page (call `get_doc_page` with a `url` from these results), for Capacitor core, Capacitor plugins or native iOS and Android configuration (use the Capacitor MCP server at https://capacitor-mcp.capawesome.io/mcp instead), or for Capawesome plugins and Capawesome Cloud services such as Live Updates, Native Builds and App Store Publishing (use the Capawesome MCP server at https://mcp.capawesome.io/mcp instead).

Parameterslimitqueryrequiredsectionversion

get_doc_page

Read a documentation page

Read the full markdown of a single page of the official Ionic Framework documentation. Use this after `search_docs` to read a page end to end before writing markup against a component, because search snippets are deliberately short and regularly omit required setup steps. A component page carries the complete API reference of that component: its properties with types and defaults, events, methods, CSS shadow parts, CSS custom properties and slots. Returns the page title, its URL, the documentation version and the complete page markdown including code samples. Do not use this to find a page: it needs an exact URL or path, so run `search_docs` first. Do not use it for pages outside ionicframework.com — Capacitor and native plugins are covered by the Capacitor MCP server at https://capacitor-mcp.capawesome.io/mcp, Capawesome plugins and Capawesome Cloud by the Capawesome MCP server at https://mcp.capawesome.io/mcp.

Parametersurlrequiredversion

list_components

List Ionic Framework components

List the UI components of Ionic Framework, optionally filtered by a keyword. Use this to find the component that fits a piece of UI before building it by hand, and to learn the custom element name it is used under. Use limit 100 to list every component. Returns `tag`, `description` and `url` per component, where `url` is the documentation page carrying its full API reference. Do not use this to read a component's API: call `get_doc_page` with the returned `url`. Do not use it for Capacitor plugins or native capabilities, which are covered by the Capacitor MCP server at https://capacitor-mcp.capawesome.io/mcp.

Parameterslimitqueryversion

get_component_usage

Read component usage examples

Read the official usage examples of one Ionic Framework component, as published on its documentation page. Use this before writing markup for a component to see how it is actually used in Angular, React, Vue or vanilla JavaScript — the template, the component class and the styles that belong together. Call it without an `example` first to see which examples the component offers. Returns the examples of the component with the frameworks each provides, or, when an `example` is given, its code per framework as fenced code blocks — one section per framework, and one block per file where an example spans several files. Do not use this for the component's API reference: its properties, events, methods, CSS shadow parts, CSS custom properties and slots are on the documentation page, which `get_doc_page` returns.

Parametersexampleversioncomponentrequiredframework

list_blog_posts

List recent blog posts

List the 10 most recent posts from the official Ionic blog, newest first. Use this when the question is about what is new — recent releases, announcements or deprecations. The blog covers both Ionic Framework and Capacitor. Returns `title`, `date`, `tags`, `url` and `excerpt` per post. Do not use this to answer a documentation question: the feed only carries the newest posts, so search the documentation with `search_docs` instead.

Takes no parameters.

Version history

1
  1. v0.0.1LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Capawesome integrations

Capacitor Mcp

io.capawesomeOfficial publisher

Unofficial MCP server that gives assistants the official Capacitor docs, plugin lists and Ionic blog posts so they stop guessing APIs and CLI flags.

Streamable HTTPWeb executable
Knowledge & Memory4 toolsOct 24, 2026

Capawesome

io.capawesomeOfficial publisher

Official Capawesome MCP server that lets an assistant search and read Capawesome documentation, guides and blog posts, with optional Capawesome Cloud management

Streamable HTTPWeb executable
Cloud & Infrastructure3 toolsOct 24, 2026