Famulor Agent Plugin

A portable agent skill plus hosted Famulor MCP connections for Claude Code, Cursor, Codex, Gemini CLI, OpenCode, OpenClaw, and other Agent Skills-compatible clients.

The portable Agent Plugin, Gemini CLI extension, and developer skill cover the complete 421-tool customer-facing MCP surface as of 2026-09-29. The Claude community-store package is restricted to an Assistant & History profile with exactly 11 read-only tools.

What is included

skills/famulor-skill/SKILL.md: short operating workflow, authorization rules, and toolset router
skills/famulor-skill/references/toolsets/: all 421 current tools split across 14 progressively loaded references
skills/famulor-skill/references/assistant-design.md: assistant onboarding and prompt-design guidance without fixed model or voice IDs
plugin.json and mcp.json: portable Agent Plugins v1 package
.claude-plugin/plugin.json and .mcp.json: full native Claude developer plugin, kept for backward compatibility
claude-store/: isolated Claude Store package with one read-only Assistant & History skill and a restricted OAuth MCP connection
gemini-extension.json and GEMINI.md: Gemini CLI extension with the full MCP endpoint and bundled skill
.cursor-plugin/plugin.json: native Cursor plugin metadata
.plugin/plugin.json: Open Plugins compatibility
famulor.skill: standalone packaged Agent Skill archive

The portable Agent Plugin, Cursor, Codex, OpenCode, and OpenClaw use the full hosted endpoint:

https://app.famulor.io/mcp

The server applies the authenticated workspace, approved scopes, role, plan, consent, and retention rules to every request. For smaller discovery results, append one or more toolsets, for example:

https://app.famulor.io/mcp?toolsets=assistants,calls

Install

Universal Agent Skills installer

npx skills add bekservice/Famulor-Skill

This installs the skill instructions. If the client does not also discover the repository's MCP configuration, add https://app.famulor.io/mcp as a remote Streamable HTTP server and complete OAuth.

Claude Code — full developer plugin

Test directly from a clone:

git clone https://github.com/bekservice/Famulor-Skill.git
claude --plugin-dir ./Famulor-Skill

Claude Code loads the full portable developer skill and root .mcp.json. Open /mcp to complete OAuth when prompted.

Claude Store — Assistants & History only

The submission package lives at the repository path claude-store/. Test it independently:

claude --plugin-dir ./Famulor-Skill/claude-store

This isolated package connects only to:

https://app.famulor.io/mcp?profile=assistant-history

It exposes exactly these 11 read-only tools: list_assistants, get_assistant, list_assistant_versions, get_assistant_version, list_prompt_templates, get_languages, get_models, get_voices, list_history, get_call, and get_email_history_item.

list_history provides an omnichannel overview across calls, email, and connected messaging channels such as Instagram or Messenger when present. Messaging results may be previews rather than complete transcripts. The Claude Store package cannot modify assistants, send messages, place calls, run campaigns, purchase numbers, manage billing, or perform any other write action.

Cursor

Install the repository as a plugin:

/add-plugin https://github.com/bekservice/Famulor-Skill

For local testing, symlink or copy the repository to ~/.cursor/plugins/local/famulor, reload Cursor, and authenticate the famulor MCP server. Cursor discovers skills/ and mcp.json from the plugin root.

Codex

See .codex/INSTALL.md, or use:

npx skills add bekservice/Famulor-Skill
codex mcp add famulor --url https://app.famulor.io/mcp
codex mcp login famulor

Gemini CLI Gallery

The root gemini-extension.json is the gallery package. It connects to the full MCP endpoint and loads GEMINI.md plus the bundled skills/famulor-skill/ workflow. Gemini CLI discovers the extension from the public GitHub repository with the gemini-cli-extension topic and a tagged release; there is no separate submission form. The OAuth consent screen limits access to the workspace and toolsets a user approves.

gemini extensions install https://github.com/bekservice/Famulor-Skill

After installation, run /mcp auth famulor in Gemini CLI if it asks for OAuth authentication.

Google Antigravity

Antigravity uses a different MCP configuration format. Install the portable skill with npx skills add bekservice/Famulor-Skill --skill famulor-skill --agent antigravity, then add the remote server in Antigravity's MCP settings:

{
  "mcpServers": {
    "famulor": {
      "serverUrl": "https://app.famulor.io/mcp"
    }
  }
}

Antigravity supports dynamic OAuth registration; authenticate the server in Settings → Customizations. Its curated plugin marketplace currently documents local and direct GitHub installation, but no public third-party submission process.

OpenCode, OpenClaw, and manual setup

Use the universal installer above for the full developer skill. Client-specific notes are in .opencode/INSTALL.md and .openclaw/INSTALL.md.

How the skill behaves

Uses live MCP schemas instead of stale REST examples or fixed IDs
Loads only the reference for the relevant toolset
Reads current state before mutation and verifies results afterward
Keeps read-only requests read-only
Requires explicit targets for calls, messages, campaign starts, payments, number changes, credit transfers, migrations, and destructive actions
Preserves workspace isolation, consent, suppression, roles, scopes, plan gates, and personal-data boundaries

The 421-tool catalog is a dated navigation snapshot. The live MCP tools/list response remains authoritative for arguments, availability, annotations, and gating. OAuth grants, workspace roles, plans, and selected toolsets determine which tools a given connection can see. Milian tools consume additional credits and require explicit approval per question or voice session.

Validate locally

claude plugin validate . --strict
claude plugin validate ./claude-store --strict
python3 /path/to/skill-creator/scripts/quick_validate.py skills/famulor-skill
python3 /path/to/skill-creator/scripts/quick_validate.py claude-store/skills/famulor-assistants-history

Also validate every JSON file, confirm the packaged archive matches skills/famulor-skill/, and check that the live endpoint returns OAuth metadata rather than a server error.

Security

Do not commit API keys or OAuth tokens.
Prefer OAuth for interactive clients.
Treat transcript, recording, message, email, contact, and customer-memory data as personal data.
Review tool annotations and returned impact before external or destructive actions.

Documentation and support

Licensed under the MIT License.