{
  "info": {
    "name": "Writer — mcp.ai",
    "description": "REST API for the Writer MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/writer",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "writer_add_file_to_graph",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/add/file/to/graph",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "add",
            "file",
            "to",
            "graph"
          ]
        },
        "description": "Tool to add a file to a knowledge graph for indexing and retrieval. Use when you need to add an uploaded file to an existing knowledge graph for RAG applications.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"file_id\": \"\",\n  \"graph_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_analyze_images",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/analyze/images",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "analyze",
            "images"
          ]
        },
        "description": "Tool to analyze images using Writer's vision capabilities. Use when you need image understanding, text extraction from images, or visual question answering. Images must be uploaded via POST /v1/files ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"model\": \"\",\n  \"prompt\": \"\",\n  \"variables\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_ask_question_to_knowledge_graph",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/ask/question/to/knowledge/graph",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "ask",
            "question",
            "to",
            "knowledge",
            "graph"
          ]
        },
        "description": "Tool to send a question to the knowledge graph and retrieve the answer. Use after defining your question and optional context.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"context\": \"\",\n  \"question\": \"\",\n  \"graph_ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_chat_completion",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/chat/completion",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "chat",
            "completion"
          ]
        },
        "description": "Tool to generate chat-based completions. Use when you need conversational AI responses; call after assembling system and user messages.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"n\": 0,\n  \"stop\": \"\",\n  \"model\": \"\",\n  \"top_p\": 0,\n  \"stream\": false,\n  \"messages\": \"\",\n  \"max_tokens\": 0,\n  \"temperature\": 0,\n  \"presence_penalty\": 0,\n  \"frequency_penalty\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_create_knowledge_graph",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/knowledge/graph",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "knowledge",
            "graph"
          ]
        },
        "description": "Tool to create a new knowledge graph. Use when you need to create an empty graph that files can be added to.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"description\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_delete_file",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/file",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "file"
          ]
        },
        "description": "Tool to delete a file by its ID. Use when you need to permanently remove a file from Writer with no recovery option available.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"file_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_delete_graph",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/graph",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "graph"
          ]
        },
        "description": "Tool to delete a knowledge graph by its ID. Use when you need to remove a graph after confirming its identifier.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"graph_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_detect_ai_content",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/detect/ai/content",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "detect",
            "ai",
            "content"
          ]
        },
        "description": "Tool to detect whether content was generated by AI. Returns a classification label and confidence score indicating the likelihood of AI-generated content. Use when you need to verify content authentic",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"input\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_download_file",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/download/file",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "download",
            "file"
          ]
        },
        "description": "Tool to download the binary content of a file. Use when you need to retrieve file data from the Writer platform. The response contains the file in its original format.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"file_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_get_file",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/file",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "file"
          ]
        },
        "description": "Tool to retrieve detailed information about a specific file by its ID. Use when you need to check a file's metadata, processing status, or associated knowledge graphs.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"file_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_list_applications",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/applications",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "applications"
          ]
        },
        "description": "Tool to list all no-code agent applications. Use when you need to retrieve all registered applications.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"after\": \"\",\n  \"limit\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_list_files",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/files",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "files"
          ]
        },
        "description": "Tool to list all uploaded files. Use when you need to retrieve a paginated set of user files, optionally filtered by status, graph, or type. Use after uploading files to inspect available files.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"after\": \"\",\n  \"limit\": 0,\n  \"order\": \"\",\n  \"before\": \"\",\n  \"status\": \"\",\n  \"graph_id\": \"\",\n  \"file_types\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_list_graphs",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/graphs",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "graphs"
          ]
        },
        "description": "Tool to retrieve a list of knowledge graphs. Use when you need an overview of existing graphs.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"after\": \"\",\n  \"limit\": 0,\n  \"order\": \"\",\n  \"before\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_list_models",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/models",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "models"
          ]
        },
        "description": "Tool to list all available language models. Use when you need to discover which models can be used for completions.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_medical_comprehend",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/medical/comprehend",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "medical",
            "comprehend"
          ]
        },
        "description": "Tool to extract medical entities and concepts from unstructured clinical text. Use when you need to label medical text with standardized codes such as SNOMED CT.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"text\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_parse_pdf",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/parse/pdf",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "parse",
            "pdf"
          ]
        },
        "description": "Tool to parse and extract text content from a previously uploaded PDF file. Use when you need to convert PDF documents to text or markdown format for further processing.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"format\": \"\",\n  \"file_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_remove_file_from_graph",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/remove/file/from/graph",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "remove",
            "file",
            "from",
            "graph"
          ]
        },
        "description": "Tool to remove a file from a Knowledge Graph. Use when you need to unlink a specific file from a graph by providing both graph and file identifiers.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"file_id\": \"\",\n  \"graph_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_retrieve_graph",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/retrieve/graph",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "retrieve",
            "graph"
          ]
        },
        "description": "Tool to retrieve a knowledge graph by its ID. Use when you need details of an existing graph.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"graph_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_text_generation",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/text/generation",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "text",
            "generation"
          ]
        },
        "description": "Tool to generate text based on a given prompt. Use when you need model-driven completions after crafting a prompt.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"stop\": \"\",\n  \"model\": \"\",\n  \"top_p\": 0,\n  \"prompt\": \"\",\n  \"max_tokens\": 0,\n  \"temperature\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_translate_text",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/translate/text",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "translate",
            "text"
          ]
        },
        "description": "Tool to translate text from one language to another with support for formality, length control, and profanity masking. Use when you need to convert text between different languages.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"text\": \"\",\n  \"model\": \"\",\n  \"formality\": false,\n  \"length_control\": false,\n  \"mask_profanity\": false,\n  \"source_language_code\": \"\",\n  \"target_language_code\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_update_graph",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/graph",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "graph"
          ]
        },
        "description": "Tool to update an existing knowledge graph. Use after confirming the graph_id. Specify at least one of name or description to modify.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"graph_id\": \"\",\n  \"description\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_upload_file",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/upload/file",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "upload",
            "file"
          ]
        },
        "description": "Tool to upload a file to Writer. Use when you need to add files for Knowledge Graphs, PDF parsing, or other file-based operations. Files can be associated with Knowledge Graphs for RAG applications.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"file\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "writer_web_search",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/web/search",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "web",
            "search"
          ]
        },
        "description": "Tool to perform a web search. Use when you need relevant web page results for a given query.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"query\": \"\",\n  \"topic\": \"\",\n  \"time_range\": \"\",\n  \"max_results\": 0,\n  \"search_depth\": \"\",\n  \"include_answer\": false,\n  \"exclude_domains\": \"\",\n  \"include_domains\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}