# @wootsup/anysource-mcp

> The AnySource MCP server: connects your AI assistant to AnySource for YOOtheme Pro on WordPress and Joomla: multi-platform, multi-AI-client, Stripe-style auth, bundled skills

Latest version **3.0.2** (published 2026-10-15) · MIT license · 0 weekly downloads

## Install

```sh
npm install @wootsup/anysource-mcp
pnpm add @wootsup/anysource-mcp
yarn add @wootsup/anysource-mcp
bun add @wootsup/anysource-mcp
```

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 3.0.2 |
| Published | 2026-10-15 |
| First published | 2026-10-11 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | WootsUp |
| Maintainers | getimo-productions |
| Keywords | mcp, model-context-protocol, anysource, wordpress, joomla, claude, chatgpt, cursor |

## Links

- npm: https://www.npmjs.com/package/@wootsup/anysource-mcp
- Repository: https://github.com/wootsup/api-mapper
- Homepage: https://wootsup.com/products/anysource-for-yootheme-pro/?utm_source=npm&utm_medium=listing&utm_campaign=profil
- Issues: https://wootsup.com/contact/
- npm.io page: https://npm.io/package/@wootsup/anysource-mcp

## Alternatives

- [jsforce](https://npm.io/package/jsforce.md) — 851.2K weekly downloads
- [react-native-qrcode-svg](https://npm.io/package/react-native-qrcode-svg.md) — 693.5K weekly downloads
- [@salesforce/plugin-data](https://npm.io/package/@salesforce/plugin-data.md) — 394.9K weekly downloads
- [@backstage/plugin-search-common](https://npm.io/package/@backstage/plugin-search-common.md) — 308.5K weekly downloads
- [@chain-registry/types](https://npm.io/package/@chain-registry/types.md) — 38.4K weekly downloads

## Recent versions

- 3.0.2 (latest) — 2026-10-15
- 3.0.1 — 2026-10-14
- 3.0.0 — 2026-10-12
- 0.0.1 — 2026-10-11
- 0.0.0-stage — 2026-10-11

## README

# @wootsup/anysource-mcp

**Build YOOtheme dynamic content via natural conversation.** The official MCP
server for [AnySource for YOOtheme Pro](https://wootsup.com/products/anysource-for-yootheme-pro/?utm_source=npm&utm_medium=readme&utm_campaign=profil) (formerly API Mapper). Connect your AI
assistant to AnySource running on WordPress or Joomla, then create flows, manage OAuth
credentials, and publish sources without leaving the chat.

[![npm version](https://img.shields.io/npm/v/@wootsup/anysource-mcp.svg)](https://www.npmjs.com/package/@wootsup/anysource-mcp)
[![license](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)

---

## Install

Two paths, pick one.

### Option A: `npx` (Claude Code, Cursor, VS Code, Cline, Codex CLI)

```bash
npx -y @wootsup/anysource-mcp setup
```

The interactive wizard:

1. Asks for your MCP key and shows its id, issuer and scope.
2. Asks for the site URL (pre-filled from the key) and which AI client(s) to
   configure.
3. Checks that your site answers, then patches the client's MCP config
   idempotently (paths under Multi-client below).
4. Tests your key with one call to the site, and rolls back if that fails.

To install the bundled skill into `~/.claude/skills/apimapper/`,
run `npx -y @wootsup/anysource-mcp install-skill`. Use `--help` to see all
subcommands.

### Option B: Claude Desktop (MCPB bundle)

1. Download `anysource-mcp.mcpb`, see the
   [installation guide](https://wootsup.com/docs/mcp/anysource/installation).
2. Drag it onto the Claude Desktop window (or **Settings → Developer →
   Install from file**).
3. Enter your site URL and MCP key when prompted.

## Setup (3 steps)

1. **Install the AnySource for YOOtheme Pro plugin** on your site:
   - **WordPress:** plugin from
     [wootsup.com](https://wootsup.com)
   - **Joomla:** extension from
     [wootsup.com](https://wootsup.com)
2. **Generate an MCP key** in the admin:
   - WordPress: click **AnySource** in the WP admin menu. The flow
     editor opens. In the editor header (top-right), click the **⋮**
     (three-dot) menu → **Settings**. In the modal's left sidebar,
     click **MCP access** → **New MCP key**.
   - Joomla: **Components → AnySource** loads the same editor. Use
     the same **⋮** → **Settings** → **MCP access** path.
   - Token shape: `ask_live_…` (production) or `ask_test_…` (sandbox). Keys
     created before the rename start with `amk_` and keep working.
3. **Run `npx -y @wootsup/anysource-mcp setup`** (or install the MCPB) and paste
   the key. The wizard tests it against your site and rolls back if the site
   refuses it.

Verify in your AI client: ask it to run `anysource_health`. It reports
connectivity, authentication and platform.

## Common tools

The full surface is 82 tools: 23 are first-class in `tools/list` (20 from the
plugin, 3 site tools this package answers), and the other 59 route through the
`anysource_advanced` gateway so the listed surface stays under each client's
tool cap. Everything is
[documented in detail in the tools reference](https://wootsup.com/docs/mcp/anysource/tools).

| Tool | What it does |
|------|--------------|
| `anysource_health` | Connectivity + auth probe. **Run this first.** |
| `anysource_onboarding` | Lists platform, existing flows, next-step suggestions. |
| `anysource_flow_setup_with_sources` | Composite: create flow + add sources + compile + publish. |
| `anysource_connection_list` | List connections (paginated, table-formatted). |
| `anysource_credential_create` | Add OAuth or Bearer credentials. |
| `anysource_oauth_authorize_begin` | Start an OAuth 2.0 PKCE flow. |
| `anysource_graph_preview` | Preview a flow's output without saving. |
| `anysource_library_catalog` | Browse pre-built connection templates. |
| `anysource_get_skill` | Fetch a skill topic on demand. |
| `anysource_advanced` | Gateway to the 59 advanced tools. Call `{ tool }` for a target's schema, or `{ tool, arguments }` to run it. |

See the [tools reference](https://wootsup.com/docs/mcp/anysource/tools) for the
canonical workflow guide, and the
[AnySource MCP docs](https://wootsup.com/docs/mcp/anysource/) for OAuth,
Joomla, YOOtheme, and troubleshooting deep-dives.

## Multi-platform: WordPress and Joomla

Every call goes to the plugin's MCP endpoint: `/wp-json/anysource/mcp` on
WordPress, `/api/index.php/v1/anysource/mcp` on Joomla. Without
`ANYSOURCE_PLATFORM`, the bridge tries both and settles on the one that answers.
You write the same prompt on both.

## Several sites

Point `ANYSOURCE_SITES_FILE` at a `sites.json` with one entry per site and one
default. Your AI lists, tests and switches sites with `anysource_sites_list`,
`anysource_sites_test` and `anysource_use_site`.

## Multi-client

Supported AI clients (auto-detected by the setup wizard):

- **Claude Desktop**: MCPB bundle or `~/Library/Application Support/Claude/`
- **Claude Code**: `~/.claude.json`
- **Cursor**: `~/.cursor/mcp.json` (or project-local `.cursor/mcp.json`)
- **VS Code**: the user-profile `mcp.json` (`~/Library/Application Support/Code/User/mcp.json` on macOS), under `servers`
- **Cline**: `~/.cline/config.json`
- **Codex**: `~/.codex/config.toml`

The server ships **stdio-only** (local install via npx or the Claude
Desktop MCPB bundle).

## Troubleshooting

See the [troubleshooting guide](https://wootsup.com/docs/mcp/anysource/troubleshooting).
Common cases:

- `401` with `apimapper_token_invalid` (Joomla: `invalid_bearer_token`) → key
  revoked, expired or issued by another site. Issue a new key and re-run setup.
- `404` on every tool → plugin not active, or its MCP endpoint is not
  reachable.

## Feedback and support

Found a bug or have a feature request? Reach us at
[wootsup.com/contact](https://wootsup.com/contact/).

For the security disclosure process, see [`SECURITY.md`](./SECURITY.md).

## License

[MIT](./LICENSE) © 2026 WootsUp / getimo productions.

## Links

- **Homepage:** <https://wootsup.com>
- **Plugin (WordPress + Joomla):** download from <https://wootsup.com/downloads>
- **Docs:** <https://wootsup.com/docs/mcp/anysource/>
- **Installation:** <https://wootsup.com/docs/mcp/anysource/installation>
- **Tools reference:** <https://wootsup.com/docs/mcp/anysource/tools>
- **Troubleshooting:** <https://wootsup.com/docs/mcp/anysource/troubleshooting>
- **Support:** <https://wootsup.com/contact/>
- **Changelog:** [`CHANGELOG.md`](./CHANGELOG.md)

---
_Source: https://npm.io/package/@wootsup/anysource-mcp · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
