{
  "info": {
    "name": "Hjarni — mcp.ai",
    "description": "REST API for the Hjarni 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/hjarni",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "hjarni_create_container",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/container",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "container"
          ]
        },
        "description": "Create a root or nested Hjarni container for organizing notes.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"position\": 0,\n  \"parent_id\": 0,\n  \"description\": \"\",\n  \"llm_instructions\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hjarni_create_note",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/note",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "note"
          ]
        },
        "description": "Create a Markdown note in the inbox or a container. Tags named in tag_names are applied as part of creation. Free accounts are limited to 25 notes, so check account status if quota pressure is possibl",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"body\": \"\",\n  \"title\": \"\",\n  \"summary\": \"\",\n  \"position\": 0,\n  \"tag_names\": \"\",\n  \"source_url\": \"\",\n  \"container_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hjarni_create_notes",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/notes",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "notes"
          ]
        },
        "description": "Create 1-25 Markdown notes in order and return one result per input. This batch is non-atomic: successful notes remain created if another item fails.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"notes\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hjarni_create_tag",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/tag",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "tag"
          ]
        },
        "description": "Create a Hjarni tag for organizing notes.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hjarni_get_account_status",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/account/status",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "account",
            "status"
          ]
        },
        "description": "Return the connected Hjarni identity, token scope, plan, teams, and current resource usage and quotas. Use this before creating many notes or attachments; Free accounts allow 25 notes, 5 attachments, ",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hjarni_get_note",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/note",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "note"
          ]
        },
        "description": "Get one Hjarni note by ID with its Markdown body, tags, container, attachments, links, and optimistic-lock version.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"note_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hjarni_list_containers",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/containers",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "containers"
          ]
        },
        "description": "List Hjarni containers as active roots, archived roots, or all active containers in a flat view. Use next_cursor to page through results.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"scope\": \"\",\n  \"per_page\": 0,\n  \"next_cursor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hjarni_list_notes",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/notes",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "notes"
          ]
        },
        "description": "List and filter personal Hjarni notes, including active, inbox, archived, or favorited notes. Use next_cursor to page through results; use query for simple personal-note filtering.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"tag\": \"\",\n  \"query\": \"\",\n  \"scope\": \"\",\n  \"per_page\": 0,\n  \"next_cursor\": \"\",\n  \"container_id\": 0,\n  \"exclude_body\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hjarni_list_tags",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/tags",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "tags"
          ]
        },
        "description": "List all Hjarni tags and their note counts. Use next_cursor to page through results.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"per_page\": 0,\n  \"next_cursor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hjarni_list_trashed_notes",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/trashed/notes",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "trashed",
            "notes"
          ]
        },
        "description": "List recoverable trashed Hjarni notes with their deletion and scheduled purge times. Use next_cursor to page through results.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"per_page\": 0,\n  \"next_cursor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hjarni_rename_tag",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/rename/tag",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "rename",
            "tag"
          ]
        },
        "description": "Rename an existing Hjarni tag without changing its note associations.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"tag_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hjarni_restore_note",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/restore/note",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "restore",
            "note"
          ]
        },
        "description": "Restore a note from Trash before its scheduled purge and return the active note.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"note_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hjarni_trash_note",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/trash/note",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "trash",
            "note"
          ]
        },
        "description": "Move a note to recoverable Trash. This is not immediate permanent deletion: Hjarni retains the note for about 30 days, and RESTORE_NOTE can recover it before purge.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"note_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hjarni_update_container",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/container",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "container"
          ]
        },
        "description": "Update a Hjarni container's name, description, parent, position, or container-specific AI instructions.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"position\": 0,\n  \"parent_id\": 0,\n  \"description\": \"\",\n  \"container_id\": 0,\n  \"llm_instructions\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "hjarni_update_note",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/note",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "note"
          ]
        },
        "description": "Update note metadata, placement, tags, or body. body replaces the entire Markdown body; append_body safely appends text. Provide expected_lock_version from GET_NOTE to prevent overwriting concurrent e",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"body\": \"\",\n  \"title\": \"\",\n  \"note_id\": 0,\n  \"summary\": \"\",\n  \"position\": 0,\n  \"tag_names\": \"\",\n  \"source_url\": \"\",\n  \"append_body\": \"\",\n  \"container_id\": 0,\n  \"expected_lock_version\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}