Famulor Agent Plugin

August 23, 2026 · View on GitHub

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 repository has two deliberate distributions. The portable Agent Plugin and developer skill cover the complete 282-tool customer-facing MCP surface. The Claude community-store and Gemini Gallery packages are 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 282 current tools split across 13 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: read-only Gemini Gallery package using the same Assistant & History profile
  • .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

The root gemini-extension.json is the gallery package. It connects only to the read-only Assistant & History profile and loads the matching guidance from GEMINI.md.

OpenCode, OpenClaw, and manual Gemini developer setup

Use the universal installer above for the full developer skill. Client-specific notes are in .opencode/INSTALL.md and .openclaw/INSTALL.md. For manual Gemini developer use, add the full hosted endpoint explicitly instead of installing the Gallery extension.

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 282-tool catalog is a dated navigation snapshot. The live MCP tools/list response remains authoritative for arguments, availability, annotations, and gating.

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.