{"id":51001866,"url":"https://github.com/iblai/api","last_synced_at":"2026-06-20T15:30:38.892Z","repository":{"id":336091638,"uuid":"1119766492","full_name":"iblai/api","owner":"iblai","description":"Agent skills + a chat MCP server to operate the ibl.ai platform via its REST API. Install: npx skills add iblai/api","archived":false,"fork":false,"pushed_at":"2026-06-12T18:54:21.000Z","size":133,"stargazers_count":14,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-12T20:22:02.736Z","etag":null,"topics":["agent-skills","ai-agents","claude-code","cursor","github-copilot","ibl-ai","llm","mcp","model-context-protocol","rest-api","skills"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iblai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-19T20:13:28.000Z","updated_at":"2026-06-12T18:54:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/iblai/api","commit_stats":null,"previous_names":["iblai/iblai-mcp","iblai/api"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/iblai/api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iblai%2Fapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iblai%2Fapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iblai%2Fapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iblai%2Fapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iblai","download_url":"https://codeload.github.com/iblai/api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iblai%2Fapi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34576040,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-20T02:00:06.407Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","ai-agents","claude-code","cursor","github-copilot","ibl-ai","llm","mcp","model-context-protocol","rest-api","skills"],"created_at":"2026-06-20T15:30:38.190Z","updated_at":"2026-06-20T15:30:38.884Z","avatar_url":"https://github.com/iblai.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003ca href=\"https://ibl.ai\"\u003e\u003cimg src=\"https://ibl.ai/images/iblai-logo.png\" alt=\"ibl.ai\" width=\"300\"\u003e\u003c/a\u003e\n\n# iblai/api\n\nOperate any ibl.ai organization from your AI agent. Skills + a chat MCP server.\n\n[![Skills](https://img.shields.io/badge/Skills-33-CC785C)](https://skills.sh/iblai/api)\n[![Claude Code](https://img.shields.io/badge/Claude_Code-CC785C?logoColor=white)](https://claude.ai)\n[![Cursor](https://img.shields.io/badge/Cursor-000000)](https://cursor.com)\n[![GitHub Copilot](https://img.shields.io/badge/GitHub_Copilot-000000?logo=githubcopilot\u0026logoColor=white)](https://github.com/features/copilot)\n[![MCP](https://img.shields.io/badge/MCP-Model_Context_Protocol-1f6feb)](https://modelcontextprotocol.io)\n[![ibl.ai](https://img.shields.io/badge/ibl.ai-platform-000000)](https://ibl.ai)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\n\u003c/div\u003e\n\n\u003e **Note:** These skills and servers run against the hosted `api.iblai.app` environment. If you'd like a license to the full platform codebase to run locally or self-host, reach out to our team at [ibl.ai/contact](https://ibl.ai/contact).\n\n---\n\n## Quick Start\n\n**Before you start:** you need [Node.js](https://nodejs.org) (for `npx`), a skills-compatible AI agent ([Claude Code](https://claude.ai/code), Cursor, OpenCode, and [15+ others](https://skills.sh)), and an ibl.ai account. **No account yet?** Sign up at [ibl.ai/join](https://ibl.ai/join) — it walks you through creating your own organization.\n\n### 1. Install the skills\n\n```bash\nnpx skills add iblai/api\n```\n\nThis installs skills that teach your AI agent how to **drive the ibl.ai platform REST API directly** — configure agents, manage datasets and memory, administer users and roles, send notifications, and pull analytics — for any organization you belong to. You'll now have the `/iblai-*` commands in your agent.\n\n### 2. Connect an organization\n\nRun the login skill once. It opens [login.iblai.app/me](https://login.iblai.app/me), you sign in via SSO, it asks which of your organizations to use, and it writes your **org key**, **username**, and a **Platform API Token** to `.env`:\n\n```text\n/iblai-login\n```\n\n\u003e **First time?** No ibl.ai account → start at [ibl.ai/join](https://ibl.ai/join) (it leads you through creating your organization), then run `/iblai-login`. Already signed in but only see the shared **`main`** organization? That's not your own workspace — create your own org first; `/iblai-login` handles it.\n\nEvery other skill then reads `IBLAI_ORG`, `IBLAI_USERNAME`, and `IBLAI_API_KEY` from `.env` and calls `https://api.iblai.app` with `Authorization: Api-Token \u003ckey\u003e`.\n\n## What is iblai/api\n\nA toolkit for operating the [ibl.ai](https://ibl.ai) platform from your AI agent. Where [`iblai/vibe`](https://github.com/iblai/vibe) gives you UI components to *build* an app, `iblai/api` gives you skills to *run the platform itself* — every agent-configuration and platform-admin operation mapped to its exact REST endpoints (method, URL, body) — plus a hosted MCP server for the one runtime capability that isn't a REST call: chatting with a deployed agent.\n\n**Why it matters:**\n\n- **One skill per operation** — each `/iblai-*` skill maps one capability, so changing an agent's LLM or pulling cost analytics is a `/` command, not a docs hunt\n- **Any organization** — authenticate once via `login.iblai.app/me`, then target any of your organizations by org key + Api-Token\n- **Endpoint-accurate** — skills carry the real `api.iblai.app` request shapes, so your agent calls the platform correctly the first time\n- **Runtime chat included** — a hosted Model Context Protocol server for chatting with deployed agents (streamed responses, tool use, RAG) — no local install\n- **No UI required** — drive the platform headless, from CI, a terminal, or any MCP-capable assistant\n\n## How It Works\n\n1. **Install** — `npx skills add iblai/api` drops the skills into your project.\n2. **Connect** — run `/iblai-login` to capture your org + username from `login.iblai.app/me` and store an Api-Token in `.env`.\n3. **Operate** — invoke any `/iblai-*` skill; it fills in your org, username, and (where relevant) the agent id, then calls `api.iblai.app`.\n4. **Automate** — chain skills, or connect the hosted chat MCP server to your assistant to talk to agents at runtime.\n\n## Skills\n\nAfter installing, use these directly in your AI agent with `/` commands.\n\n### Setup\n\n```text\n/iblai-login\n```\n\n### Agent\n\n```text\n/iblai-agent-create        /iblai-agent-datasets\n/iblai-agent-settings      /iblai-agent-embed\n/iblai-agent-sandbox       /iblai-agent-memory\n/iblai-agent-access        /iblai-agent-history\n/iblai-agent-llm           /iblai-agent-audit\n/iblai-agent-prompts       /iblai-agent-evals\n/iblai-agent-skills        /iblai-agent-chat\n/iblai-agent-safety        /iblai-agent-disclaimers\n/iblai-agent-privacy       /iblai-agent-tools\n/iblai-agent-mcp\n```\n\n### Organization (platform admin)\n\n```text\n/iblai-org                 /iblai-rbac\n/iblai-management       /iblai-crm\n/iblai-integrations     /iblai-notifications\n/iblai-tokens          /iblai-invites\n/iblai-scim            /iblai-billing\n/iblai-features\n```\n\n### Profile\n\n```text\n/iblai-profile             /iblai-profile-metadata\n```\n\n### Content \u0026 discovery\n\n```text\n/iblai-search              /iblai-course-create\n/iblai-analytics           /iblai-catalog\n/iblai-milestones          /iblai-credentials\n/iblai-catalog-media       /iblai-catalog-invitations\n```\n\n### What each skill does\n\n| Skill | Description |\n|-------|-------------|\n| `/iblai-login` | Connect an organization — opens `login.iblai.app/me`, captures org + username + Api-Token into `.env`. Run first. |\n| `/iblai-agent-create` | Create a new agent from a template (then configure with the other agent skills) |\n| `/iblai-agent-settings` | Agent identity \u0026 capabilities — name, description, category, image, visibility, flags; fork and delete |\n| `/iblai-agent-sandbox` | Connect/disconnect a sandbox (Claw) instance, push config, run health checks, set the model |\n| `/iblai-agent-access` | Role-based access to an agent — grant editor / chat / analytics_viewer to users, groups, emails |\n| `/iblai-agent-llm` | Choose the agent's LLM provider and model |\n| `/iblai-agent-prompts` | System / proactive / study / guided prompts and suggested-prompt CRUD |\n| `/iblai-agent-skills` | Browse the skill catalog and assign skills to an agent (requires a sandbox) |\n| `/iblai-agent-safety` | Moderation \u0026 safety systems, prompts/responses, and flagged-prompt logs |\n| `/iblai-agent-privacy` | Privacy Router — PII detection, redact/mask/block, entity types, output filtering |\n| `/iblai-agent-disclaimers` | Advisory text and the User Agreement |\n| `/iblai-agent-tools` | Enable/disable the agent's tools |\n| `/iblai-agent-mcp` | MCP connectors — create, edit, enable, and complete OAuth connections |\n| `/iblai-agent-datasets` | Training datasets (RAG) — add files/URLs/YouTube/crawl/GitHub, train, retrain, delete |\n| `/iblai-agent-embed` | Embed/widget settings + backend token provisioning — CSS/JS, voice, SSO, share links |\n| `/iblai-agent-memory` | Agent memories and memory categories — list, filter, add, edit, delete |\n| `/iblai-agent-history` | Conversation history \u0026 summaries; export chat history as an async report |\n| `/iblai-agent-audit` | Agent audit log — who changed what (read-only) |\n| `/iblai-agent-evals` | Agent evaluations — datasets, experiments, LLM-as-Judge + human scoring, CSV export |\n| `/iblai-agent-chat` | Set up live chat with an agent — wires the `iblai-agent-chat` MCP server into the project |\n| `/iblai-org` | Org-wide settings — default agent, help center URL, chat width, feature toggles |\n| `/iblai-management` | Org admin — Users, Groups, Roles, Policies, Teams, Alerts |\n| `/iblai-rbac` | RBAC — roles, policies, groups, permission checks, agent/team sharing, student toggles |\n| `/iblai-crm` | CRM — people, organizations, pipelines, deals (move/won/lost), activities, tags |\n| `/iblai-integrations` | Account integrations — LLM keys, Data Source credentials, API tokens |\n| `/iblai-tokens` | Platform API Tokens — list, create (secret shown once), delete |\n| `/iblai-notifications` | Org notifications — counts, inbox, mark-as-read, build \u0026 send |\n| `/iblai-invites` | User invitations — list and send (single or CSV bulk) |\n| `/iblai-scim` | SCIM 2.0 directory provisioning — users (Enterprise extension), groups, departments, memberships; RBAC group assignment auto-links platforms |\n| `/iblai-billing` | Billing \u0026 credits — credit accounts, item paywalls, prices, checkout (auth + guest), subscriptions, access checks, revenue/subscriber reporting |\n| `/iblai-features` | Per-user feature config \u0026 flags — get/update (inline or feature+values), bulk-config, apps/onboarding, trial activation, platform provisioning |\n| `/iblai-profile` | The signed-in user's own profile — Basic, Social, Education, Experience, Resume, Memory |\n| `/iblai-profile-metadata` | Per-user, per-org metadata key-value store — preferences, settings, feature flags |\n| `/iblai-search` | Discover agents and content + personalized (RAG) recommendations — faceted search (read-only) |\n| `/iblai-analytics` | Analytics across agents, content, and users — KPIs, users, topics, transcripts, costs, courses, programs, audit, reports |\n| `/iblai-course-create` | Course Creation API — generate, edit, and publish courses (tasks, outline, structure) |\n| `/iblai-catalog` | Learning catalog — courses, programs, pathways, resources, skills/roles taxonomy, enrollment, eligibility, reviews |\n| `/iblai-milestones` | Catalog milestones — course/resource/program/pathway completions and skill points (block, course, platform, user) |\n| `/iblai-credentials` | Digital credentials — credential CRUD, user/group assignments, assertions, course import/export, provider config (Accredible), analytics |\n| `/iblai-catalog-media` | Catalog media resources — list/create/update/delete media tied to courses/units/items, multipart upload, search, by-item lookup |\n| `/iblai-catalog-invitations` | Catalog invitations \u0026 licensing — platform/course/program invitations (bulk, blank, redeem), licenses \u0026 assignments, access requests, suggestions |\n\nSkills live in [`skills/`](./skills). Read them, extend them, or write your own.\n\n## MCP Server\n\nHosted Model Context Protocol server — no local installation required. This covers the one **runtime** capability the skills can't: actually talking to a deployed agent. Wire it up with **`/iblai-agent-chat`** (it writes the config below from your `.env` token + a chosen agent), or add it manually. (Administering the platform is the skills' job — see [Skills vs MCP servers](#skills-vs-mcp-servers).)\n\n| Server | Description | Endpoint |\n|--------|-------------|----------|\n| [iblai-agent-chat](./mcp/iblai-agent-chat) | Talk to a deployed agent — streamed AI responses (runtime) | `/mcp/agent-chat/` |\n\n### Connect from Claude Code\n\n```bash\nclaude mcp add iblai-agent-chat --transport http https://asgi.data.iblai.app/mcp/agent-chat/ --header \"Authorization: Api-Token YOUR_API_TOKEN\"\n```\n\n### Connect from Claude Desktop / Cursor\n\n```json\n{\n  \"mcpServers\": {\n    \"iblai-agent-chat\": {\n      \"transport\": \"streamable-http\",\n      \"url\": \"https://asgi.data.iblai.app/mcp/agent-chat/\",\n      \"headers\": {\n        \"Authorization\": \"Api-Token YOUR_API_TOKEN\"\n      }\n    }\n  }\n}\n```\n\n### Skills vs MCP servers\n\nThe split is **administer/use-via-REST vs chat at runtime**:\n\n- **Skills** do everything you can reach over REST — create and configure agents, manage datasets, memory, users, roles, notifications, discovery/search, recommendations, user profiles and analytics, and reporting — by calling the API directly.\n- **The MCP server** is for the one thing that isn't a REST admin call: holding a live conversation with a deployed agent (streamed responses, tool use, RAG).\n\n**Rule: if a skill covers it, there is no server for it.** That's why only `iblai-agent-chat` remains — the former `analytics`, `agent-create`, `search`, and `user` servers were removed once skills covered analytics, agent creation, discovery + recommendations (`/iblai-search`), and user profile + analytics (`/iblai-profile`).\n\n## Authentication\n\nEverything authenticates the same way:\n\n- **Base URL:** `https://api.iblai.app`\n- **Header:** `Authorization: Api-Token \u003ckey\u003e` on every request\n- **Org \u0026 username:** from [login.iblai.app/me](https://login.iblai.app/me) — each organization you belong to shows its **key** (e.g. `enterprise`, `iblai`, or a UUID)\n- **Api-Token:** your **first** token comes from the platform admin (or `login.iblai.app`); once you're connected, `/iblai-tokens` lists, creates, and rotates tokens. The secret is shown once.\n\nThe `/iblai-login` skill walks through all of this and writes `IBLAI_ORG`, `IBLAI_USERNAME`, and `IBLAI_API_KEY` to `.env`. Never commit `.env` — it is in `.gitignore`.\n\n## Resources\n\n- [skills.sh/iblai/api](https://skills.sh/iblai/api) — install skills with `npx skills add iblai/api`\n- [iblai/vibe](https://github.com/iblai/vibe) — companion toolkit for *building* ibl.ai apps (UI components + Claude Code skills)\n- [login.iblai.app/me](https://login.iblai.app/me) — your account, organizations, and org keys\n- [docs.ibl.ai](https://docs.ibl.ai) — platform documentation\n\n## License\n\nMIT — see [LICENSE](LICENSE). © [ibl.ai](https://ibl.ai)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiblai%2Fapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiblai%2Fapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiblai%2Fapi/lists"}