NotebookLM
Google NotebookLM via natural language: create notebooks, add sources (PDF, URL, YouTube) and ask gr
Should I use this
Quality & Safety
Findings (6)
- HIGHTool poisoning patterns detected
- MEDIUMTool 'notebooklm_share_view_level' description contains placeholder textin notebooklm_share_view_level
- LOWTool 'notebooklm_notebook_create' description lacks action verbin notebooklm_notebook_create
- LOWTool 'connect' description lacks action verbin connect
- LOWTool 'notebooklm_artifact_suggestions' name length outside 3-30 rangein notebooklm_artifact_suggestions
- INFOTool description contains placeholder or incomplete textin notebooklm_share_view_level
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"notebooklm-mcp": {
"url": "https://api.mcp.ai/p_notebooklm"
}
}
}Remote endpoints
https://api.mcp.ai/p_notebooklmstreamable-httpWhat it can do
Tool inventory
Tools (43)
🟢notebooklm_list
Lista os notebooks do usuário. Retorna [{ id, title, ... }] — use o `id` nas demais tools.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡notebooklm_notebook_create(title)
Cria um notebook novo (vazio). Retorna o notebook com seu `id`.
Input Schema
{
"type": "object",
"properties": {
"title": {
"type": "string"
}
},
"required": [
"title"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪notebooklm_notebook_rename(notebook_id, new_title, notebook_ids)
Renomeia um notebook. Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"new_title": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"new_title"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴notebooklm_notebook_delete(notebook_id, notebook_ids)
Apaga um notebook (irreversível). Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢notebooklm_notebook_summary(notebook_id, topics, notebook_ids)
Resumo do notebook com insights gerados por IA. `topics:true` inclui tópicos sugeridos. Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"topics": {
"type": "boolean"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢notebooklm_notebook_metadata(notebook_id, notebook_ids)
Metadados do notebook + lista de fontes. Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢notebooklm_ask(notebook_id, question, notebook_ids)
Pergunta ao notebook; resposta FUNDAMENTADA nas fontes, com citações. Pode demorar. Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"question": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"question"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢notebooklm_history(notebook_id, limit, show_all, notebook_ids)
Histórico de Q&A da conversa do notebook. Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"limit": {
"type": "number"
},
"show_all": {
"type": "boolean"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡notebooklm_source_add(notebook_id, content, type, title, notebook_ids)
Adiciona uma fonte ao notebook: URL (página/YouTube) ou texto. `type` é auto-detectado; use `type:"text"` + `title` para colar texto. Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"content": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"url",
"text",
"youtube"
]
},
"title": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"content"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢notebooklm_source_list(notebook_id, notebook_ids)
Lista as fontes do notebook. Retorna [{ id, title, ... }]. Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢notebooklm_source_get(notebook_id, source_id, notebook_ids, source_ids)
Detalhes de uma fonte. Bulk support: accepts notebook_ids, source_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"source_id": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"source_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"source_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢notebooklm_source_fulltext(notebook_id, source_id, format, notebook_ids, source_ids)
Texto completo indexado de uma fonte. Bulk support: accepts notebook_ids, source_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"source_id": {
"type": "string"
},
"format": {
"type": "string",
"enum": [
"text",
"markdown"
]
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"source_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"source_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢notebooklm_source_guide(notebook_id, source_id, notebook_ids, source_ids)
Resumo + palavras-chave de uma fonte (gerado por IA). Bulk support: accepts notebook_ids, source_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"source_id": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"source_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"source_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪notebooklm_source_rename(notebook_id, source_id, new_title, notebook_ids, source_ids)
Renomeia uma fonte. Bulk support: accepts notebook_ids, source_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"source_id": {
"type": "string"
},
"new_title": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"source_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"source_id",
"new_title"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪notebooklm_source_refresh(notebook_id, source_id, notebook_ids, source_ids)
Reprocessa uma fonte de URL/Drive (re-indexa o conteúdo atual). Bulk support: accepts notebook_ids, source_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"source_id": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"source_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"source_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴notebooklm_source_delete(notebook_id, source_id, notebook_ids, source_ids)
Remove uma fonte do notebook. Bulk support: accepts notebook_ids, source_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"source_id": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"source_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"source_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡notebooklm_source_add_research(notebook_id, query, from_source, mode, import_all, ...)
Pesquisa na web (ou Drive) e adiciona fontes a partir dos resultados. Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"query": {
"type": "string"
},
"from_source": {
"type": "string",
"enum": [
"web",
"drive"
]
},
"mode": {
"type": "string",
"enum": [
"fast",
"deep"
]
},
"import_all": {
"type": "boolean"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪notebooklm_generate(notebook_id, kind, instructions, language, source_ids, ...)
Gera um artifact do notebook (assíncrono — retorna o artifact em geração). `kind`: audio (podcast), video, cinematic_video, slide_deck, report, mind_map, quiz, flashcards, infographic, data_table. `instructions` = foco/estilo. `options` = flags específicas do tipo (ex.: audio {format:deep-dive|brief|critique|debate, length:short|default|long}; video/cinematic_video {format:explainer|brief|cinematic, style:...}; slide_deck {format:detailed|presenter, length}; report {format:briefing-doc|study-guide|blog-post|custom}; quiz/flashcards {quantity:fewer|standard|more, difficulty:easy|medium|hard}; infographic {orientation, detail, style}; mind_map {kind:interactive|note-backed}). Acompanhe com notebooklm_artifact_list/get.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"audio",
"video",
"cinematic_video",
"slide_deck",
"report",
"mind_map",
"quiz",
"flashcards",
"infographic",
"data_table"
]
},
"instructions": {
"type": "string"
},
"language": {
"type": "string"
},
"source_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"options": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"kind"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢notebooklm_artifact_list(notebook_id, type, notebook_ids)
Lista os artifacts do notebook. `type` filtra (audio|video|slide-deck|quiz|flashcard|infographic|data-table|mind-map|report). Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"type": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢notebooklm_artifact_get(notebook_id, artifact_id, notebook_ids, artifact_ids)
Detalhes/status de um artifact. Bulk support: accepts notebook_ids, artifact_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"artifact_id": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"artifact_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"artifact_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢notebooklm_artifact_poll(notebook_id, task_id, notebook_ids, task_ids)
Aguarda/consulta o status de uma geração de artifact. Bulk support: accepts notebook_ids, task_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"task_id": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"task_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"task_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢notebooklm_artifact_suggestions(notebook_id, notebook_ids)
Sugestões de artifacts para o notebook. Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪notebooklm_artifact_rename(notebook_id, artifact_id, new_title, notebook_ids, artifact_ids)
Renomeia um artifact. Bulk support: accepts notebook_ids, artifact_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"artifact_id": {
"type": "string"
},
"new_title": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"artifact_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"artifact_id",
"new_title"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪notebooklm_artifact_retry(notebook_id, artifact_id, notebook_ids, artifact_ids)
Re-tenta a geração de um artifact que falhou. Bulk support: accepts notebook_ids, artifact_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"artifact_id": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"artifact_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"artifact_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴notebooklm_artifact_delete(notebook_id, artifact_id, notebook_ids, artifact_ids)
Apaga um artifact. Bulk support: accepts notebook_ids, artifact_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"artifact_id": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"artifact_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"artifact_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢notebooklm_download(notebook_id, kind, artifact_id, notebook_ids, artifact_ids)
Baixa o conteúdo de um artifact. Texto (report/mind_map/quiz/flashcards/data_table) retorna inline em `content`; binário (audio/video/slide_deck/infographic) retorna metadados + tamanho (entrega por URL é tratada à parte). Bulk support: accepts notebook_ids, artifact_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"audio",
"video",
"cinematic_video",
"slide_deck",
"report",
"mind_map",
"quiz",
"flashcards",
"infographic",
"data_table"
]
},
"artifact_id": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"artifact_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"kind"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡notebooklm_note_create(notebook_id, content, title, notebook_ids)
Cria uma nota no notebook. Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"content": {
"type": "string"
},
"title": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"content"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢notebooklm_note_list(notebook_id, notebook_ids)
Lista as notas do notebook. Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢notebooklm_note_get(notebook_id, note_id, notebook_ids, note_ids)
Conteúdo de uma nota. Bulk support: accepts notebook_ids, note_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"note_id": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"note_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"note_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪notebooklm_note_rename(notebook_id, note_id, new_title, notebook_ids, note_ids)
Renomeia uma nota. Bulk support: accepts notebook_ids, note_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"note_id": {
"type": "string"
},
"new_title": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"note_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"note_id",
"new_title"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴notebooklm_note_delete(notebook_id, note_id, notebook_ids, note_ids)
Apaga uma nota. Bulk support: accepts notebook_ids, note_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"note_id": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"note_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"note_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢notebooklm_share_status(notebook_id, notebook_ids)
Status de compartilhamento do notebook. Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪notebooklm_share_public(notebook_id, enable, notebook_ids)
Liga/desliga o link público do notebook. Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"enable": {
"type": "boolean"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡notebooklm_share_add(notebook_id, email, permission, message, notebook_ids)
Compartilha o notebook com um email (editor/viewer). Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"email": {
"type": "string"
},
"permission": {
"type": "string",
"enum": [
"editor",
"viewer"
]
},
"message": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"email"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡notebooklm_share_update(notebook_id, email, permission, notebook_ids)
Atualiza a permissão de um colaborador. Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"email": {
"type": "string"
},
"permission": {
"type": "string",
"enum": [
"editor",
"viewer"
]
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"email"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴notebooklm_share_remove(notebook_id, email, notebook_ids)
Remove o acesso de um colaborador. Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"email": {
"type": "string"
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"email"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢notebooklm_share_view_level(notebook_id, level, notebook_ids)
Define o nível de acesso do link público: full (notebook todo) ou chat (só chat). Bulk support: accepts notebook_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"notebook_id": {
"type": "string"
},
"level": {
"type": "string",
"enum": [
"full",
"chat"
]
},
"notebook_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"notebook_id",
"level"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢show_version
Show the current MCP platform and adapter versions.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡report_bug(message, context, conversation)
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
Input Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
},
"context": {
"default": "",
"type": "string"
},
"conversation": {
"default": "[]",
"type": "string"
}
},
"required": [
"message"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢connect
Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢toolkit_info
Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡marketplace(action, query, mcp_id, limit, tier_slug, ...)
The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.
Input Schema
{
"type": "object",
"properties": {
"action": {
"default": "search",
"type": "string",
"enum": [
"search",
"describe",
"install",
"uninstall",
"subscribe",
"cancel",
"resume",
"report_bug",
"request_mcp",
"list_tools",
"invoke",
"search_prompts",
"get_prompt",
"publish_prompt"
]
},
"query": {
"default": "",
"type": "string"
},
"mcp_id": {
"default": "",
"type": "string"
},
"limit": {
"default": 10,
"type": "number"
},
"tier_slug": {
"default": "",
"type": "string"
},
"immediate": {
"default": false,
"type": "boolean"
},
"cancel_reason": {
"type": "string",
"enum": [
"too_expensive",
"missing_features",
"switched_service",
"unused",
"customer_service",
"too_complex",
"low_quality",
"other"
]
},
"cancel_comment": {
"default": "",
"type": "string"
},
"message": {
"default": "",
"type": "string"
},
"report_context": {
"default": "",
"type": "string"
},
"conversation": {
"default": "[]",
"type": "string"
},
"request_name": {
"default": "",
"type": "string"
},
"request_details": {
"default": "",
"type": "string"
},
"tool_id": {
"default": "",
"type": "string"
},
"arguments": {
"default": "{}",
"type": "string"
},
"prompt_slug": {
"default": "",
"type": "string"
},
"prompt_vars": {
"default": "{}",
"type": "string"
},
"prompt_category": {
"default": "",
"type": "string"
},
"prompt_tool": {
"default": "",
"type": "string"
},
"prompt_title": {
"default": "",
"type": "string"
},
"prompt_description": {
"default": "",
"type": "string"
},
"prompt_body": {
"default": "",
"type": "string"
},
"prompt_targets": {
"default": [],
"type": "array",
"items": {
"type": "string",
"enum": [
"claude",
"chatgpt",
"cursor",
"lovable"
]
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡authenticate(token)
MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.
Input Schema
{
"type": "object",
"properties": {
"token": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence