productivityapi_key

Peerdom

Peerdom helps organizations map roles, people, groups, projects, goals, pages, and cards through a collaborative organizational platform.

Verdict

Peerdom tracks roles, responsibilities, and organizational structure for self-managing teams. In Switchy, @mentioning Peerdom lets you create roles, assign people, update custom fields, and query who holds what responsibility — all without opening a browser. Teams using Holacracy, Sociocracy, or similar governance models get the most value: you can draft role proposals in chat, assign accountabilities during meetings, and pull current structure into planning docs. Setup requires an API key with write access, so coordinate with whoever administers your Peerdom workspace.

Common use cases

  • Draft role descriptions during governance meetings
  • Assign accountabilities without switching tools
  • Query who holds a specific role right now
  • Update role percentages when workload shifts
  • Archive former team members in bulk

Integration

Vendor
Peerdom
Category
productivity
Auth
API_KEY
Tools
19
Composio slug
peerdom

Tools

  • Assign Or Update Role Holder

    Ensure a peer holds a role, creating the assignment when absent or updating its percentage, focus, and elected-until date when present.

  • Create Custom Field Definition

    Create one custom-field definition that controls a named field's owner, type, multiplicity, order, and visibility.

  • Create Group

    Create a group from an existing parent-group anchor on a map. Set external to true to detach the new group as a top-level external group.

  • Create Peer

    Create an email-free person record in the organization; this tool deliberately cannot provision a Peerdom login account.

  • Create Role

    Create a role under a parent group on a map using core role fields that do not require Peerdom's Contribution or Goals apps.

  • Deactivate Peer

    Mark a peer as former. This is a soft delete: the peer is removed from normal active-peer reads but remains available when former peers are included.

  • Delete Custom Field Definition
    destructive

    Permanently delete a custom-field definition. WARNING: Peerdom cascade-deletes every value stored against the definition; this cannot be undone and requires explicit confirmation.

  • Delete Group
    destructive

    Permanently delete one group after reading it to block accidental root-group deletion. Root deletion requires separate explicit authorization.

  • Delete Role
    destructive

    Delete one role by ID and return the deleted role for confirmation.

  • Get Custom Field Definitions

    List custom-field definitions or return one definition by ID so agents can use the organization's real field names and value types.

  • Get Groups

    List organization groups or return one group by ID, with optional map and peer filters and optional custom-field-value expansion.

  • Get Organization Context

    Return the connected Peerdom organization and its maps, including the live map ID and tenant palette needed to create groups and roles.

  • Get Peers

    List peers with optional former-peer and custom-field inclusion, or return one peer by ID with optional roles and custom fields.

  • Get Roles

    List roles or return one role by ID, with optional peer, group, and map filters plus holder, group, representing-node, and custom-field expansions.

  • Unassign Role Holder

    Remove one peer's assignment from one role without deleting either the peer or the role.

  • Update Custom Field Definition

    Rename a custom-field definition and its custom-field API key, or update its labels, display order, or public visibility without changing its value type or owner.

  • Update Group

    Update selected group properties such as name, parent, external state, color, shape, or custom fields. Omitted fields remain unchanged.

  • Update Peer

    Update selected profile fields on an existing peer; omitted fields remain unchanged despite the provider using PUT.

  • Update Role

    Update selected core role properties without changing Contribution- or Goals-specific settings.

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Find Peerdom in the MCP catalog and click Connect. 3. You'll be prompted for an API key — generate one in your Peerdom workspace under Settings > API Access (you need admin permissions). 4. Copy the key and paste it into Switchy's connection dialog, then click Authorize. 5. Switchy confirms the connection by fetching your organization name; if this fails, double-check the key's scope includes read and write access. 6. Open any Project in Switchy and type '@Peerdom list all active roles' to verify the integration works. 7. If the response returns your current roles, you're ready to create, update, and query organizational data directly from chat.

What teammates see: by default, memories from Peerdom are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

List Active Roles

@Peerdom show me all active roles in the organization, grouped by circle or team.

Create New Role

@Peerdom create a role called 'Customer Success Lead' under the Sales circle with purpose 'ensure client retention and satisfaction' and accountabilities 'quarterly check-ins, onboarding handoff, escalation triage'.

Assign Role Holder

@Peerdom assign Jordan to the 'Marketing Coordinator' role at 50% focus, with elected-until date three months from today.

Update Custom Field

@Peerdom update the custom field 'Certification Status' on the 'Safety Officer' role to 'OSHA 30 — expires Dec 2025'.

Deactivate Former Peer

@Peerdom mark Alex Chen as a former peer so they no longer appear in active role assignments.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@peerdom show me all roles currently held by Sarah Chen, including their focus percentages and elected-until dates

Output

Sarah Chen holds three roles: Engineering Lead (50% focus, elected until 2025-06-30), Security Champion (20% focus, elected until 2025-03-31), and Onboarding Mentor (30% focus, no election end date). All roles are active. This illustrative example reflects how Peerdom surfaces role assignments with their governance metadata—actual output includes role IDs, parent group paths, and custom field values if configured.

Notes

This read-heavy query demonstrates Peerdom's role-holder model, which tracks elected governance alongside operational focus. Requires read scope for peers and roles. Useful for understanding current organizational structure before making assignment changes or planning succession.

Prompt

@peerdom assign Marcus to the Product Owner role at 60% focus, elected until end of Q2 2025, and create the role under the Platform team if it doesn't exist yet

Output

Role 'Product Owner' created under Platform team (group ID: grp_8x4k). Marcus Williams assigned as role holder with 60% focus allocation and elected-until date of 2025-06-30. Assignment record created with ID: rh_9m2p. This illustrative example shows Peerdom's atomic role-and-assignment workflow—actual responses include full role metadata and parent group lineage.

Notes

This write example combines role creation with assignment in one prompt, showcasing Peerdom's governance-first design. Requires write scope for roles and role-holders. Side-effect: creates permanent organizational structure. The elected-until date enforces term limits, triggering re-election workflows when the date passes.

Prompt

@peerdom analyze our current role distribution across all engineering groups and identify peers holding more than 100% total focus allocation

Output

Across 4 engineering groups (Backend, Frontend, Platform, Infrastructure), 23 roles are currently filled by 18 unique peers. Three peers exceed 100% focus: Jordan Lee (140%: Tech Lead 60%, Architect 50%, Hiring Lead 30%), Alex Kumar (120%: Backend Lead 70%, API Owner 50%), and Sam Torres (110%: Frontend Lead 60%, Design System Owner 50%). This illustrative synthesis combines role-holder reads with AI reasoning to surface over-allocation risks.

Notes

This synthesis example pairs Peerdom's organizational data with the AI's analytical capabilities to surface governance issues invisible in single-record queries. Requires read scope across multiple groups. Useful for capacity planning and preventing burnout, but interpretation depends on whether focus percentages represent time commitment or priority weighting in your organization.

Use-case deep-dives

Onboarding sprint at 12-person startup

When Peerdom wins for rapid org-chart setup during hiring bursts

A 12-person startup hiring four engineers in one month needs to spin up role assignments, reporting lines, and custom fields (location, start date, equity tier) without waiting on IT. Peerdom's 19 tools let you script the entire onboarding flow: create peers, assign roles with percentage splits for dual-hat contributors, define custom fields for comp data, and nest groups under the engineering parent. The API-key auth means your ops lead runs it from a Switchy thread without provisioning logins for people who haven't started yet. This works until you hit 40-50 people—at that scale, you want a real HRIS with payroll hooks, not a flexible org-chart API. If your onboarding is three hires a quarter and you already use BambooHR, skip Peerdom. If you're doubling headcount in six weeks and need to move faster than Workday's change-request queue, this is the call.

Role rotation in professional-services firm

Peerdom handles fluid role assignments when project staffing changes weekly

A 20-person consulting shop rotates people across client projects every sprint, with analysts holding two or three roles at fractional percentages (40% on Project A, 30% on Project B, 30% internal ops). Peerdom's assign-or-update-role-holder tool lets you script the weekly shuffle: update percentage splits, set elected-until dates for term-limited project leads, and reassign focus areas without touching a UI. The custom-field definitions track billable rates and client codes per role, so your finance pull matches the live org chart. This breaks down if role changes happen multiple times per day (a staffing agency placing temps hourly) or if you need approval workflows before assignments go live—Peerdom writes directly, no review step. For weekly or bi-weekly project planning at firms under 100 people, it's faster than maintaining a spreadsheet and more structured than Slack-based role announcements.

Offboarding cleanup at acquisition target

When deactivate-peer is the right tool for post-merger org reconciliation

A 30-person SaaS company just got acquired and needs to mark 8 departing employees as former without deleting their historical role data for the earnout audit. Peerdom's deactivate-peer tool soft-deletes the records—they vanish from active-peer queries but remain in the system when you explicitly include former peers, preserving the paper trail for the acquirer's due diligence. You can script the batch deactivation in one Switchy thread, then use delete-group to collapse the now-empty product-marketing group into the parent. The risk: if you accidentally run delete-custom-field-definition instead of just clearing values, you lose all stored data with no undo. This scenario works when you need a fast, auditable offboarding sweep and your HR system of record (Rippling, Gusto) is already handling benefits termination. If you're a 200-person company with compliance requirements around data retention policies, you want a tool with approval gates and restore functionality, not a direct-write API.

Frequently asked

What does the Peerdom MCP let me do in Switchy?

It lets AI agents read and modify your Peerdom org structure—creating roles, assigning people to them, managing groups, and updating custom fields. The MCP exposes 19 tools covering peer records, role assignments, group hierarchies, and field definitions. Agents can automate org-chart updates, sync role holders across systems, or answer questions about who owns what role.

Do I need admin access in Peerdom to connect this MCP?

Yes. The MCP uses an API key, and Peerdom's API requires organization-level permissions to create roles, assign peers, and delete groups. A standard member key won't work. Generate the key from your Peerdom account settings under API or Integrations, then paste it into Switchy's connection flow.

Can the MCP create user login accounts in Peerdom?

No. The Create Peer tool explicitly cannot provision Peerdom login accounts—it only creates email-free person records inside your org. If you need to invite someone with login credentials, do that directly in Peerdom's UI. The MCP is for org-structure automation, not user provisioning.

How is this different from editing my org chart in Peerdom directly?

The MCP lets AI agents make bulk changes or sync data from other tools without you opening Peerdom. For example, an agent can read role assignments from a spreadsheet and update 50 role holders in one prompt. Manual edits are faster for one-off tweaks; the MCP wins when you're automating repetitive org-structure tasks.

Who on my team should connect the Peerdom MCP?

Whoever manages your org chart or people ops in Peerdom. That person already has the API key permissions and understands which roles and groups exist. Don't hand this to someone unfamiliar with your structure—agents can delete groups or deactivate peers, and Peerdom's cascade deletes are permanent.

More productivity MCPs

See all productivity MCPs →

Data last verified 61 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.