Can I use Pinboard as a CLI?

Yes. KosmoKrator exposes a Pinboard CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Pinboard through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Pinboard tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Pinboard credentials stored?

Pinboard credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Pinboard MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Pinboard CLI for AI Agents

Use the Pinboard CLI from KosmoKrator to call Pinboard tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

Pinboard CLI Setup

Pinboard can be configured headlessly with `kosmokrator integrations:configure pinboard`.

Install, configure, and verify

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure pinboard --set auth_token="$PINBOARD_AUTH_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor pinboard --json
kosmokrator integrations:status --json

Credentials

Authentication type: API token api_token. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

Key	Env var	Type	Required	Label
`auth_token`	`PINBOARD_AUTH_TOKEN`	Secret `secret`	yes	Auth Token
`url`	`PINBOARD_URL`	Text `text`	no	API URL

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call

kosmo integrations:call pinboard.pinboard_posts_update '{}' --json

Provider shortcut

kosmo integrations:pinboard pinboard_posts_update '{}' --json

Discovery

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

Discovery commands

kosmo integrations:docs pinboard --json
kosmo integrations:docs pinboard.pinboard_posts_update --json
kosmo integrations:schema pinboard.pinboard_posts_update --json
kosmo integrations:search "Pinboard" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

`pinboard.pinboard_posts_update`

Return the most recent bookmark add, update, or delete time.

Read read

Parameters: none

Generic call

kosmo integrations:call pinboard.pinboard_posts_update '{}' --json

Shortcut

kosmo integrations:pinboard pinboard_posts_update '{}' --json

`pinboard.pinboard_posts_add`

Add or update a bookmark.

Write write

Parameters: none

Generic call

kosmo integrations:call pinboard.pinboard_posts_add '{}' --json

Shortcut

kosmo integrations:pinboard pinboard_posts_add '{}' --json

`pinboard.pinboard_posts_delete`

Delete an existing bookmark.

Write write

Parameters: none

Generic call

kosmo integrations:call pinboard.pinboard_posts_delete '{}' --json

Shortcut

kosmo integrations:pinboard pinboard_posts_delete '{}' --json

`pinboard.pinboard_posts_get`

Return one or more posts for a date or URL.

Read read

Parameters: none

Generic call

kosmo integrations:call pinboard.pinboard_posts_get '{}' --json

Shortcut

kosmo integrations:pinboard pinboard_posts_get '{}' --json

`pinboard.pinboard_posts_recent`

Return recent posts, optionally filtered by tag.

Read read

Parameters: none

Generic call

kosmo integrations:call pinboard.pinboard_posts_recent '{}' --json

Shortcut

kosmo integrations:pinboard pinboard_posts_recent '{}' --json

`pinboard.pinboard_posts_all`

Return all bookmarks in the account.

Read read

Parameters: none

Generic call

kosmo integrations:call pinboard.pinboard_posts_all '{}' --json

Shortcut

kosmo integrations:pinboard pinboard_posts_all '{}' --json

`pinboard.pinboard_posts_dates`

Return dates with bookmark counts.

Read read

Parameters: none

Generic call

kosmo integrations:call pinboard.pinboard_posts_dates '{}' --json

Shortcut

kosmo integrations:pinboard pinboard_posts_dates '{}' --json

`pinboard.pinboard_posts_suggest`

Return popular and recommended tags for a URL.

Read read

Parameters: none

Generic call

kosmo integrations:call pinboard.pinboard_posts_suggest '{}' --json

Shortcut

kosmo integrations:pinboard pinboard_posts_suggest '{}' --json

`pinboard.pinboard_tags_get`

Return tags and usage counts.

Read read

Parameters: none

Generic call

kosmo integrations:call pinboard.pinboard_tags_get '{}' --json

Shortcut

kosmo integrations:pinboard pinboard_tags_get '{}' --json

`pinboard.pinboard_tags_delete`

Delete all instances of a tag.

Write write

Parameters: none

Generic call

kosmo integrations:call pinboard.pinboard_tags_delete '{}' --json

Shortcut

kosmo integrations:pinboard pinboard_tags_delete '{}' --json

`pinboard.pinboard_tags_rename`

Rename a tag or fold it into an existing tag.

Write write

Parameters: none

Generic call

kosmo integrations:call pinboard.pinboard_tags_rename '{}' --json

Shortcut

kosmo integrations:pinboard pinboard_tags_rename '{}' --json

`pinboard.pinboard_user_secret`

Return the secret RSS key.

Read read

Parameters: none

Generic call

kosmo integrations:call pinboard.pinboard_user_secret '{}' --json

Shortcut

kosmo integrations:pinboard pinboard_user_secret '{}' --json

`pinboard.pinboard_user_api_token`

Return the user API token.

Read read

Parameters: none

Generic call

kosmo integrations:call pinboard.pinboard_user_api_token '{}' --json

Shortcut

kosmo integrations:pinboard pinboard_user_api_token '{}' --json

`pinboard.pinboard_notes_list`

Return a list of notes without note text detail.

Read read

Parameters: none

Generic call

kosmo integrations:call pinboard.pinboard_notes_list '{}' --json

Shortcut

kosmo integrations:pinboard pinboard_notes_list '{}' --json

`pinboard.pinboard_notes_get`

Return an individual note.

Read read

Parameters: none

Generic call

kosmo integrations:call pinboard.pinboard_notes_get '{}' --json

Shortcut

kosmo integrations:pinboard pinboard_notes_get '{}' --json

`pinboard.pinboard_api_get`

Call a safe relative Pinboard GET path for endpoints not covered by first-class tools.

Read read

Parameters: path, payload

Generic call

kosmo integrations:call pinboard.pinboard_api_get '{"path":"example_path","payload":"example_payload"}' --json

Shortcut

kosmo integrations:pinboard pinboard_api_get '{"path":"example_path","payload":"example_payload"}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

pinboard.pinboard_posts_update 0 parameters

Schema command

kosmo integrations:schema pinboard.pinboard_posts_update --json

Parameter	Type	Required	Description
No parameters.

pinboard.pinboard_posts_add 0 parameters

Schema command

kosmo integrations:schema pinboard.pinboard_posts_add --json

Parameter	Type	Required	Description
No parameters.

pinboard.pinboard_posts_delete 0 parameters

Schema command

kosmo integrations:schema pinboard.pinboard_posts_delete --json

Parameter	Type	Required	Description
No parameters.

pinboard.pinboard_posts_get 0 parameters

Schema command

kosmo integrations:schema pinboard.pinboard_posts_get --json

Parameter	Type	Required	Description
No parameters.

pinboard.pinboard_posts_recent 0 parameters

Schema command

kosmo integrations:schema pinboard.pinboard_posts_recent --json

Parameter	Type	Required	Description
No parameters.

pinboard.pinboard_posts_all 0 parameters

Schema command

kosmo integrations:schema pinboard.pinboard_posts_all --json

Parameter	Type	Required	Description
No parameters.

pinboard.pinboard_posts_dates 0 parameters

Schema command

kosmo integrations:schema pinboard.pinboard_posts_dates --json

Parameter	Type	Required	Description
No parameters.

pinboard.pinboard_posts_suggest 0 parameters

Schema command

kosmo integrations:schema pinboard.pinboard_posts_suggest --json

Parameter	Type	Required	Description
No parameters.

pinboard.pinboard_tags_get 0 parameters

Schema command

kosmo integrations:schema pinboard.pinboard_tags_get --json

Parameter	Type	Required	Description
No parameters.

pinboard.pinboard_tags_delete 0 parameters

Schema command

kosmo integrations:schema pinboard.pinboard_tags_delete --json

Parameter	Type	Required	Description
No parameters.

pinboard.pinboard_tags_rename 0 parameters

Schema command

kosmo integrations:schema pinboard.pinboard_tags_rename --json

Parameter	Type	Required	Description
No parameters.

pinboard.pinboard_user_secret 0 parameters

Schema command

kosmo integrations:schema pinboard.pinboard_user_secret --json

Parameter	Type	Required	Description
No parameters.

pinboard.pinboard_user_api_token 0 parameters

Schema command

kosmo integrations:schema pinboard.pinboard_user_api_token --json

Parameter	Type	Required	Description
No parameters.

pinboard.pinboard_notes_list 0 parameters

Schema command

kosmo integrations:schema pinboard.pinboard_notes_list --json

Parameter	Type	Required	Description
No parameters.

pinboard.pinboard_notes_get 0 parameters

Schema command

kosmo integrations:schema pinboard.pinboard_notes_get --json

Parameter	Type	Required	Description
No parameters.

pinboard.pinboard_api_get 2 parameters

Schema command

kosmo integrations:schema pinboard.pinboard_api_get --json

Parameter	Type	Required	Description
`path`	string	yes	Relative Pinboard API path.
`payload`	object	no	Query parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.