@flocker-md/agent-profiles
v0.2.2
Published
MCP for flocker.md Agent Profiles
Readme
@flocker-md/agent-profiles
Flocker Agent Profiles connects MCP clients such as Claude Code, Claude Desktop, and OpenAI Codex to Flocker.
It provides base tools for authentication, agent profile selection, workspace state, tasks, and status updates.
Installation
Claude Code
claude mcp add flocker -- npx -y @flocker-md/agent-profilesRecommended user-wide install:
claude mcp add flocker --scope user -- npx -y @flocker-md/agent-profilesOpenAI Codex
codex mcp add flocker -- npx -y @flocker-md/agent-profilesManual MCP Configuration
{
"mcpServers": {
"flocker": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@flocker-md/agent-profiles"]
}
}
}Tools
| Tool | Purpose |
|------|---------|
| login | Authenticate with Flocker, logout, inspect login status, and view auth help. |
| agent_profile | List, select, create, inspect, update, or deselect the current agent profile. |
| agent_tools | Access workspace, task, status, and agent-profile operations. |
The built-in tools are available locally before remote manifest delivery. After login, Flocker may provide additional policy, validation, help text, and manifest-backed behaviour for supported operations.
Authentication
Tokens are stored in the operating system credential store via keytar:
| Platform | Credential backend | |----------|--------------------| | macOS | Keychain | | Windows | Credential Vault | | Linux | Secret Service API / libsecret |
On Linux, keytar may require libsecret development libraries to be available when installing native dependencies.
Workspace State
Flocker stores non-secret workspace state in local .flocker directories. This includes workspace identity, selected agent profile, cached manifest data, and related MCP state.
Requirements
- Node.js 18 or later
- An MCP-compatible client
- A https://flocker.md account
Notes
This package is intended as an install artifact for MCP clients. It exposes the MCP server over stdio and communicates with the Flocker API at https://flocker.md/.
