psychology

Agent Documentation

Connect Your AI Agent

18 tools to manage your digital legacy. Choose your integration method below and have your AI agent managing buckets, contacts, and check-ins in minutes.

01

Generate an API Key

Settings → Agent API Keys. Choose read-only or full access.

02

Pick Your Method

MCP Server, ClawHub skill, or raw REST API calls.

03

Start Using Tools

"Add my life insurance to the financial bucket." Done.

MCP Server

The MCP (Model Context Protocol) server runs as a stdio process, exposing 18 typed tools. Works with Claude Desktop, Claude Code, and any MCP-compatible client. No curl required — your AI agent calls structured tools directly.

laptop_macClaude Desktop

Add this to your claude_desktop_config.json:

claude_desktop_config.json
{
  "mcpServers": {
    "kicking-the-bucket": {
      "command": "npx",
      "args": ["-y", "@kicking-the-bucket/mcp"],
      "env": {
        "KTB_API_KEY": "ktb_your_api_key_here"
      }
    }
  }
}

terminalClaude Code

Terminal
claude mcp add kicking-the-bucket -- npx -y @kicking-the-bucket/mcp

Then set your API key as an environment variable:

Terminal
export KTB_API_KEY="ktb_your_api_key_here"

cableGeneric MCP Client

Terminal
KTB_API_KEY="ktb_your_api_key_here" npx @kicking-the-bucket/mcp

Environment Variables

VariableRequiredDescription
KTB_API_KEYYesYour API key (starts with ktb_)
KTB_API_URLNoAPI base URL (defaults to production)

All 18 Tools

Available across all integration methods. Tools marked full require a Full Access API key.

ToolScopeDescription
get_dashboardreadDashboard overview with completeness score
get_profilereadUser profile and subscription info
list_bucketsreadAll bucket categories with item counts
list_itemsreadItems in a specific bucket
get_itemreadFull item details by ID
search_itemsreadSearch across all items by keyword
list_contactsreadAll trusted contacts
get_dms_statusreadDead Man's Switch status
list_messagesreadAll scheduled messages
create_itemfullCreate a new item in a bucket
update_itemfullUpdate an existing item
delete_itemfullPermanently delete an item
add_contactfullAdd a trusted contact
update_contactfullUpdate a contact's details
remove_contactfullRemove a trusted contact
configure_dmsfullConfigure DMS frequency or toggle
check_infullPerform a DMS check-in
create_messagefullSchedule a message for a contact

Bucket Categories

Items are organized into 6 categories. Use these values for the bucketCategory parameter.

financial

Bank accounts, insurance, investments, crypto, debts, taxes

legal

Wills, power of attorney, deeds, trusts, guardianship

digital

Passwords, social media, email, subscriptions, domains

personal

Letters, videos, audio messages, recipes, memories

medical

Directives, medical history, medications, doctor contacts

household

Utilities, home maintenance, vehicles, pets, contractors

Item Types

documentcredentialnotevideoaudiocontact_cardchecklist

API Key Scopes

visibility

Read Only

Can only use read tools (GET requests). View buckets, items, contacts, DMS status, and messages. Safe for monitoring and reporting agents.

edit

Full Access

Can use all tools including create, update, and delete operations. Required for agents that manage your legacy data.

Ready to connect your agent?

Sign up, generate an API key, and let your AI handle the paperwork of mortality.