[ INTEGRATION ]
Skills MCP
The following 5MCP tools auto-register whenever the platform's skills_enabled flag is on. Agents discover them via tools/list and invoke them via tools/call, same as any other MCP tool. No bespoke wiring on your side.
⚠Private beta — provisioning required
Skills must be enabled on your platform by an Assistiv admin. The MCP tools (find_skill, fetch_skill, create_skill, submit_skill_review) only register when platform.skills_enabled = true. Email founders@assistiv.ai to provision.
ℹFree tier
First 5,000 skill calls per platform per calendar month are free (combined across all four MCP tools). After 5k, $0.0004 per call ($0.40 per 1k) — flat regardless of skill folder size, since size is set by the source repo, not by you. Counter resets on the 1st of each month. See pricing for the full tier table.
Which URL to point your agent at
Two URLs expose the skill tools. Pick based on whether the agent also needs your other MCP apps (GitHub, Slack, Zendesk, ...).
POST mcp.assistiv.ai/mcp/skills
Skills only. Returns exactly the 5tools below. Use when the agent's only job is to discover and run skills.
POST mcp.assistiv.ai/mcp
Dynamic. Returns skills + every MCP app the end user has connected. Use when the agent mixes skills with GitHub / Slack / etc.
Both URLs require an end-user key (sk-eu_*). Billing, free tier, and auth-register condition are identical; only the tool list differs.
Tools
find_skill
Hybrid search (BM25 + pgvector) over the catalog. Returns top matches with summaries and review aggregates.
fetch_skill
Returns the full skill folder. Optional target_path tells the agent runtime where to write files.
create_skill
Upload a private skill (files inlined as base64). Owned by the caller (platform or end-user).
delete_skill
Soft-delete a private skill you own. Public skills cannot be deleted via this tool. Idempotent.
submit_skill_review
Score along four fixed dimensions (accuracy / value / efficiency / clarity) after the run. End-user keys only.
Each tool wraps a route on the Skills REST API. You can call REST directly if you prefer; the MCP tools exist so MCP-compatible agents don't have to special-case skills.
Auto-register condition
Skill tools only appear on tools/list when platform.skills_enabled = true. Flip the toggle on the MCP dashboard or PATCH the platform directly:
curl -X PATCH https://api.assistiv.ai/v1/platforms/{platform_id} \
-H "Authorization: Bearer sk-plat_..." \
-H "Content-Type: application/json" \
-d '{"skills_enabled": true}'Sessions already open keep their registered tools until the next initialize; new sessions reflect the flag immediately.
Agent quickstart (curl)
Three calls and the skill tools are live in your agent's tool list. Replace sk-eu_... with an end-user API key.
1. Initialize a session
curl -i -X POST https://mcp.assistiv.ai/mcp/skills \
-H "Authorization: Bearer sk-eu_..." \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"method": "initialize",
"id": 1,
"params": {
"protocolVersion": "2024-11-05",
"capabilities": {},
"clientInfo": {"name":"my-agent","version":"1.0"}
}
}'
# Response includes an mcp-session-id header. Reuse it on subsequent calls.2. List the tools
curl -X POST https://mcp.assistiv.ai/mcp/skills \
-H "Authorization: Bearer sk-eu_..." \
-H "mcp-session-id: <session-id-from-step-1>" \
-d '{"jsonrpc":"2.0","method":"tools/list","id":2}'
# Returns exactly: find_skill, fetch_skill, create_skill, delete_skill,
# submit_skill_review. Swap /mcp/skills for /mcp to also include any MCP
# apps the end-user has connected.3. Search the catalog
curl -X POST https://mcp.assistiv.ai/mcp/skills \
-H "Authorization: Bearer sk-eu_..." \
-H "mcp-session-id: <session-id>" \
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"id": 3,
"params": {
"name": "find_skill",
"arguments": {"query": "parse a CSV from a URL", "top_k": 3, "visibility": "all"}
}
}'
# Returns ranked matches with skill_id, name, description, score, and review aggregates.
# Pass the skill_id to fetch_skill to get the full folder.