MCP Pickaxe Server

Instructions

Implementation Reference

• src/index.ts:486-492 (handler)

  Handler function for the 'doc_create' tool. Constructs a POST request body with the required 'name' and optional 'rawContent' or 'website', calls the Pickaxe API endpoint '/studio/document/create', and returns the JSON response.

  case "doc_create": {
    const body: Record<string, unknown> = { name: args.name };
    if (args.rawContent) body.rawContent = args.rawContent;
    if (args.website) body.website = args.website;
    const result = await pickaxeRequest("/studio/document/create", "POST", body, studio);
    return JSON.stringify(result, null, 2);
  }

• src/index.ts:152-170 (schema)

  Input schema definition for the 'doc_create' tool, specifying parameters: studio (optional), name (required), rawContent (optional), and website (optional, mutually exclusive with rawContent).

  inputSchema: {
    type: "object",
    properties: {
      studio: studioParam,
      name: {
        type: "string",
        description: "Name/title of the document",
      },
      rawContent: {
        type: "string",
        description: "Raw text content for the document. Use this OR website, not both.",
      },
      website: {
        type: "string",
        description: "URL to scrape as document content. Use this OR rawContent, not both.",
      },
    },
    required: ["name"],
  },

• src/index.ts:149-171 (registration)

  Tool registration in the 'tools' array, including name, description, and inputSchema, which is returned by the ListTools handler.

  {
    name: "doc_create",
    description: "Create a new document in Pickaxe knowledge base. Can create from raw content or scrape a website URL.",
    inputSchema: {
      type: "object",
      properties: {
        studio: studioParam,
        name: {
          type: "string",
          description: "Name/title of the document",
        },
        rawContent: {
          type: "string",
          description: "Raw text content for the document. Use this OR website, not both.",
        },
        website: {
          type: "string",
          description: "URL to scrape as document content. Use this OR rawContent, not both.",
        },
      },
      required: ["name"],
    },
  },