BotKelp is an MCP server published by io.github.aiscimi-code, hosted at www.botkelp.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 16 tools, including get_help, search_components, get_component, purchase_scaffold, get_scaffold.
Verified component catalog over remote MCP: agents pick ids and get a project that builds.
904 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Free. Short usage index. Then search_components to pick ids.
No parameters.
{
"name": "get_help",
"title": "Get help",
"description": "Free. Short usage index. Then search_components to pick ids.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Free. Compact catalog TSV: id, provides, requires, conflictsWith. Omit args for all.
| Parameter | Type | Description |
|---|---|---|
| query | string | Words to match, e.g. "auth stripe". |
| detail | boolean | Add short descriptions. |
| provides | array | Required capability tags. |
{
"name": "search_components",
"title": "Search components",
"description": "Free. Compact catalog TSV: id, provides, requires, conflictsWith. Omit args for all.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"query": {
"type": "string",
"description": "Words to match, e.g. \"auth stripe\"."
},
"detail": {
"type": "boolean",
"description": "Add short descriptions."
},
"provides": {
"type": "array",
"items": {
"type": "string"
},
"description": "Required capability tags."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}One component's source files, UNRENDERED (EJS markers, not build-ready): inspect only; use purchase_scaffold for real files. Free, 32/day, signed-in account.
| Parameter | Type | Description |
|---|---|---|
| component * | string | Component id, or id@version, e.g. "supabase-client@2.0.0". |
{
"name": "get_component",
"title": "Get component source",
"description": "One component's source files, UNRENDERED (EJS markers, not build-ready): inspect only; use purchase_scaffold for real files. Free, 32/day, signed-in account.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"component"
],
"properties": {
"component": {
"type": "string",
"description": "Component id, or id@version, e.g. \"supabase-client@2.0.0\"."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Buys a CI-green starter repo for component ids (credits via your signed-in account, or x402). Returns a git clone command and projectid. Red builds are refused and not charged. delivery "inline" returns files instead (more tokens).
| Parameter | Type | Description |
|---|---|---|
| project | object | Saved project metadata. |
| delivery | string | "clone" (default) or "inline". |
| maintain | boolean | Renewable repeat access (default true). |
| components * | array | Component ids, e.g. ["nextjs-base","tailwind"]. |
| site_profile | ["boolean","string"] | true or a profile name: bake legal pages in. |
| admin_page_set | string | Extra file-set name. |
| template_files | any | Extra files: true, or [{name}|{source,dest}]. |
{
"name": "purchase_scaffold",
"title": "Purchase scaffold",
"description": "Buys a CI-green starter repo for component ids (credits via your signed-in account, or x402). Returns a git clone command and projectid. Red builds are refused and not charged. delivery \"inline\" returns files instead (more tokens).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"components"
],
"properties": {
"project": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Your label."
},
"description": {
"type": "string",
"description": "Notes."
}
},
"description": "Saved project metadata."
},
"delivery": {
"enum": [
"clone",
"inline"
],
"type": "string",
"description": "\"clone\" (default) or \"inline\"."
},
"maintain": {
"type": "boolean",
"description": "Renewable repeat access (default true)."
},
"components": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Component ids, e.g. [\"nextjs-base\",\"tailwind\"]."
},
"site_profile": {
"type": [
"boolean",
"string"
],
"description": "true or a profile name: bake legal pages in."
},
"admin_page_set": {
"type": "string",
"description": "Extra file-set name."
},
"template_files": {
"anyOf": [
{
"type": "boolean",
"const": true
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"dest": {
"type": "string",
"description": "Destination path."
},
"name": {
"type": "string",
"description": "Saved file name."
},
"source": {
"type": "string",
"description": "Path in connected repo."
}
}
}
}
],
"description": "Extra files: true, or [{name}|{source,dest}]."
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Refetches a scaffold you purchased (fresh clone command), no extra credits. Credit-flow projects need Maintain on. Same site_profile/delivery options as purchase_scaffold.
| Parameter | Type | Description |
|---|---|---|
| delivery | string | "clone" (default) or "inline". |
| projectid * | string | The project id from a previous purchase_scaffold result. Required — your project is resolved from your authenticated account. |
| site_profile | ["boolean","string"] | false/omit: skip. true: attach this account's one site profile (errors if 0 or >1). A string: attach that named profile. |
{
"name": "get_scaffold",
"title": "Get scaffold",
"description": "Refetches a scaffold you purchased (fresh clone command), no extra credits. Credit-flow projects need Maintain on. Same site_profile/delivery options as purchase_scaffold.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"projectid"
],
"properties": {
"delivery": {
"enum": [
"clone",
"inline"
],
"type": "string",
"description": "\"clone\" (default) or \"inline\"."
},
"projectid": {
"type": "string",
"description": "The project id from a previous purchase_scaffold result. Required — your project is resolved from your authenticated account."
},
"site_profile": {
"type": [
"boolean",
"string"
],
"description": "false/omit: skip. true: attach this account's one site profile (errors if 0 or >1). A string: attach that named profile."
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Lists this account's saved scaffold projects (id, name, description, repo, components, maintain state). Use the projectid with get_scaffold to re-fetch a scaffold — no project_api_key is needed as a tool argument.
No parameters.
{
"name": "get_projects",
"title": "Get projects",
"description": "Lists this account's saved scaffold projects (id, name, description, repo, components, maintain state). Use the projectid with get_scaffold to re-fetch a scaffold — no project_api_key is needed as a tool argument.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Turn Maintain on/off for a project and/or rotate its project key. Off keeps existing clones; it stops future get_scaffold access.
| Parameter | Type | Description |
|---|---|---|
| rotate | boolean | If true, mints a new project key and invalidates the old one. |
| maintain | boolean | |
| projectid * | string | The project id to change (from get_projects). Required — scoped to your authenticated account. |
{
"name": "set_projects",
"title": "Set projects",
"description": "Turn Maintain on/off for a project and/or rotate its project key. Off keeps existing clones; it stops future get_scaffold access.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"projectid"
],
"properties": {
"rotate": {
"type": "boolean",
"description": "If true, mints a new project key and invalidates the old one."
},
"maintain": {
"type": "boolean"
},
"projectid": {
"type": "string",
"description": "The project id to change (from get_projects). Required — scoped to your authenticated account."
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Your site profiles (privacy, terms, cookies, licence, custom_field) as JSON. list: true for names, or siteprofilename for one; field filters. Use next.arguments when a purchase reply says incomplete: true.
| Parameter | Type | Description |
|---|---|---|
| list | boolean | If true, return this account's profile names instead of a profile's content. |
| field | any | "all" (default), or an array from: privacy, terms, cookies, license, custom_field. |
| cursor | string | Resume token from a previous incomplete result, e.g. "doc:terms". |
| siteprofilename | string | The profile to fetch. Required unless list: true. |
{
"name": "get_siteprofile",
"title": "Get site profile",
"description": "Your site profiles (privacy, terms, cookies, licence, custom_field) as JSON. list: true for names, or siteprofilename for one; field filters. Use next.arguments when a purchase reply says incomplete: true.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"list": {
"type": "boolean",
"description": "If true, return this account's profile names instead of a profile's content."
},
"field": {
"anyOf": [
{
"type": "string",
"const": "all"
},
{
"type": "array",
"items": {
"enum": [
"privacy",
"terms",
"cookies",
"license",
"custom_field"
],
"type": "string"
}
}
],
"description": "\"all\" (default), or an array from: privacy, terms, cookies, license, custom_field."
},
"cursor": {
"type": "string",
"description": "Resume token from a previous incomplete result, e.g. \"doc:terms\"."
},
"siteprofilename": {
"type": "string",
"description": "The profile to fetch. Required unless list: true."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Creates or updates one named site profile for this account. Fields omitted from `field` keep their current saved value (or blank, if the profile is new); pass only what changed. custom_field entries are merged key-by-key. An account may keep more than one named profile (e.g. one per brand/site).
| Parameter | Type | Description |
|---|---|---|
| field * | object | Fields to change. Omitted fields keep their current value. |
| siteprofilename * | string | Name for this profile, e.g. "default" or "acme-co". |
{
"name": "set_siteprofile",
"title": "Set site profile",
"description": "Creates or updates one named site profile for this account. Fields omitted from `field` keep their current saved value (or blank, if the profile is new); pass only what changed. custom_field entries are merged key-by-key. An account may keep more than one named profile (e.g. one per brand/site).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"siteprofilename",
"field"
],
"properties": {
"field": {
"type": "object",
"properties": {
"terms": {
"type": "string"
},
"cookies": {
"type": "string"
},
"license": {
"type": "string"
},
"privacy": {
"type": "string"
},
"custom_field": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
}
},
"description": "Fields to change. Omitted fields keep their current value."
},
"siteprofilename": {
"type": "string",
"description": "Name for this profile, e.g. \"default\" or \"acme-co\"."
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Lists this account's admin page set names (omit name), or returns one set's exact files (pass name). These are the file trees purchase_scaffold's admin_page_set param bakes into a dedicated forked repo. Requires a linked account (transport auth).
| Parameter | Type | Description |
|---|---|---|
| name | string | The set to fetch. Omit to list this account's set names instead. |
{
"name": "get_adminpageset",
"title": "Get admin page set",
"description": "Lists this account's admin page set names (omit name), or returns one set's exact files (pass name). These are the file trees purchase_scaffold's admin_page_set param bakes into a dedicated forked repo. Requires a linked account (transport auth).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "The set to fetch. Omit to list this account's set names instead."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Creates or fully replaces one named admin page set for this account — real file source (React/Next.js), not text config. purchase_scaffold's admin_page_set param bakes a chosen set into a brand-new, dedicated repo. An account may keep more than one named set.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Name for this set, e.g. "default" or "acme-admin". |
| files * | array | The full set of files, e.g. [{ path: "app/admin/page.tsx", content: "..." }]. |
{
"name": "set_adminpageset",
"title": "Set admin page set",
"description": "Creates or fully replaces one named admin page set for this account — real file source (React/Next.js), not text config. purchase_scaffold's admin_page_set param bakes a chosen set into a brand-new, dedicated repo. An account may keep more than one named set.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"files"
],
"properties": {
"name": {
"type": "string",
"description": "Name for this set, e.g. \"default\" or \"acme-admin\"."
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"content"
],
"properties": {
"path": {
"type": "string",
"description": "Relative file path, e.g. \"app/layout.tsx\"."
},
"content": {
"type": "string"
}
}
},
"minItems": 1,
"description": "The full set of files, e.g. [{ path: \"app/admin/page.tsx\", content: \"...\" }]."
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Remote `npm install && npm run build` of your edited files (send every file). Call with files -> WAIT + jobId; call again with jobId -> OK or FAIL with the error tail. Needs a purchased projectid.
| Parameter | Type | Description |
|---|---|---|
| files | array | The full project to verify — a scaffold's files with your edits applied. Omit when polling with jobId. |
| jobId | string | Poll a previously started verification. Omit on the first call (pass files), pass the returned jobId on subsequent calls. |
| projectid * | string | The project id from a previous purchase_scaffold result — must be owned by this account. Required. |
| envVariables | array | Env var names to write placeholder values for before building (typically get_component's `envVariables` output) — needed for components that read process.env at build time (e.g. a Supabase client). |
{
"name": "verify_scaffold",
"title": "Verify scaffold",
"description": "Remote `npm install && npm run build` of your edited files (send every file). Call with files -> WAIT + jobId; call again with jobId -> OK or FAIL with the error tail. Needs a purchased projectid.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"projectid"
],
"properties": {
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"content"
],
"properties": {
"path": {
"type": "string",
"description": "Relative file path, e.g. \"app/layout.tsx\"."
},
"content": {
"type": "string"
}
}
},
"minItems": 1,
"description": "The full project to verify — a scaffold's files with your edits applied. Omit when polling with jobId."
},
"jobId": {
"type": "string",
"description": "Poll a previously started verification. Omit on the first call (pass files), pass the returned jobId on subsequent calls."
},
"projectid": {
"type": "string",
"description": "The project id from a previous purchase_scaffold result — must be owned by this account. Required."
},
"envVariables": {
"type": "array",
"items": {
"type": "string"
},
"description": "Env var names to write placeholder values for before building (typically get_component's `envVariables` output) — needed for components that read process.env at build time (e.g. a Supabase client)."
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Report a catalog/code bug or request a component (files an issue on botkelp/components). Signed-in account, 10/day. No secrets.
| Parameter | Type | Description |
|---|---|---|
| projectid | string | Optional project id this report relates to. |
| description * | string | What is wrong or what you want. Include enough detail to reproduce. No secrets. |
{
"name": "report_issue",
"title": "Report an issue",
"description": "Report a catalog/code bug or request a component (files an issue on botkelp/components). Signed-in account, 10/day. No secrets.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"description"
],
"properties": {
"projectid": {
"type": "string",
"description": "Optional project id this report relates to."
},
"description": {
"type": "string",
"description": "What is wrong or what you want. Include enough detail to reproduce. No secrets."
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Shows whether this account has a GitHub repo connected, or lists files under a path in that repo. If not connected, the result includes installUrl — open it (GitHub App) to grant read access to one repo. Sign in on botkelp.com with GitHub first so the install is tied to your account.
| Parameter | Type | Description |
|---|---|---|
| path | string | Folder or file in the connected repo to list. Omit for connection status. |
{
"name": "get_github",
"title": "Get GitHub connection",
"description": "Shows whether this account has a GitHub repo connected, or lists files under a path in that repo. If not connected, the result includes installUrl — open it (GitHub App) to grant read access to one repo. Sign in on botkelp.com with GitHub first so the install is tied to your account.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"path": {
"type": "string",
"description": "Folder or file in the connected repo to list. Omit for connection status."
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Returns a GitHub App install URL so the user can grant BotKelp read access to one of their repos. Open the URL, pick a single repo, approve. Then purchase_scaffold template_files: [{ source: "app/legal/" }] copies those pages into the clone. disconnect: true drops the connection. Prefer signing in with GitHub on botkelp.com first.
| Parameter | Type | Description |
|---|---|---|
| disconnect | boolean | true: drop the connected repo. Omit to mint a fresh install URL. |
{
"name": "set_github",
"title": "Connect or disconnect GitHub",
"description": "Returns a GitHub App install URL so the user can grant BotKelp read access to one of their repos. Open the URL, pick a single repo, approve. Then purchase_scaffold template_files: [{ source: \"app/legal/\" }] copies those pages into the clone. disconnect: true drops the connection. Prefer signing in with GitHub on botkelp.com first.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"disconnect": {
"type": "boolean",
"description": "true: drop the connected repo. Omit to mint a fresh install URL."
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}No params. Says whether you are signed in (authenticated) and account tools work (accountToolsReady). Never returns a key.
No parameters.
{
"name": "get_account_status",
"title": "Get account status",
"description": "No params. Says whether you are signed in (authenticated) and account tools work (accountToolsReady). Never returns a key.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Call get_help first (a short index), then search_components to pick ids — both free, with no API key required. You never pass any API key as a tool argument: the server authenticates you once via MCP OAuth 2.1 at the transport and injects your linked BotKelp account key on your behalf. Call get_account_status to check whether your key is linked. If generated or catalog code is wrong, outdated, fails to build, has a security issue, or you want a new component, call report_issue.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.