# Parma — MCP server on mcp.ai
> Connect your Parma account and use 23 tools for CRM straight from your AI agent. Connect with your own API key. Parma CRM is a relationship management app designed to help you accelerate growth by deepening and nurturing your business relationships.

By: mcp.ai · official
Page: https://mcp.ai/parma

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_parma?ms=1787293500000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/parma/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/parma/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/parma/skill.md
Postman collection (v2.1): https://mcp.ai/parma/postman.json

## Tools
- parma_add_relationship_to_group(group_id: integer, relationship_id: string) — Tool to add a relationship to a group in Parma. Use when you need to associate an existing relationship with a group.
- parma_create_note(body: string, datetime?: string, relationship_ids: integer[]) — Tool to create a new note in the Parma account. Use when you need to add a note linked to specific relationships.
- parma_create_relationship(name: string, type?: string, about?: string, group_ids: integer[], company_id?: integer) — Tool to create a new relationship in Parma. Use when you need to add a new person or company to your Parma account.
- parma_data_json() — Tool to retrieve DCAT-US 1.1 compliant metadata of all datasets. Use when you need the complete catalog JSON (data.json) from Parma’s open data portal.
- parma_delete_relationship(id: string) — Tool to delete a relationship from Parma by its ID. Use when you need to remove an existing relationship between entities. Returns success confirmation after deletion (HTTP 204).
- parma_get_pipeline(id: string) — Tool to retrieve a pipeline by its ID. Use when you need to fetch details about a specific pipeline.
- parma_get_relationship(id: string) — Tool to retrieve a relationship by its unique ID. Use when you need to get detailed information about a specific relationship.
- parma_get_stage(id: string) — Tool to retrieve a stage by its unique identifier. Use when you need to fetch details about a specific stage in a pipeline.
- parma_get_user(id: string) — Tool to retrieve a user by their unique ID. Use when you need to fetch details for a specific user.
- parma_get_user_profile() — Tool to retrieve the authenticated user's profile. Use after obtaining a valid auth token to fetch current user account details.
- parma_list_deals(page?: string) — Tool to retrieve all deals from the Parma account. Use when you need to list deals, filter by pagination, or get an overview of all deals in the system.
- parma_list_groups(page?: string, query?: string) — Tool to retrieve all groups in the Parma account. Use when you need to list groups, optionally filtered by a search query.
- parma_list_notes(page?: string) — Tool to retrieve all notes from the Parma account. Use when you need to list or search through notes associated with relationships.
- parma_list_pipelines() — Tool to list all pipelines in the Parma account. Use when you need to retrieve available pipelines and their details.
- parma_list_relationship_groups(relationship_id: string) — Tool to retrieve all groups linked to a specific relationship. Use when you need to see which groups are associated with a given relationship ID.
- parma_list_relationship_notes(page?: string, relationship_id: string) — Tool to list all notes linked to a relationship. Use when you need to retrieve all notes associated with a specific relationship ID.
- parma_list_relationships(sms?: string, name?: string, page?: string, type?: string, email?: string, phone?: string, twitter?: string, linkedin?: string, telegram?: string, whatsapp?: string, instagram?: string, schedulinglink?: string) — Tool to list all relationships in the Parma account. Use when you need to retrieve and filter relationships by various criteria such as name, type, or contact details.
- parma_list_stages() — Tool to retrieve all stages in the Parma account. Use when you need to list pipeline stages or check available stage configurations.
- parma_list_users(page?: string) — Tool to list all users in the Parma account. Use when you need to retrieve the complete list of users with their IDs, names, and email addresses.
- parma_package_list() — Tool to retrieve all dataset identifiers from the Parma CKAN instance. Use when you need to list every available dataset ID.
- parma_remove_relationship_from_group(relationship_id: string, relationship_group_id: string) — Tool to remove a relationship from a group. Use when you need to dissociate a relationship from a specific relationship group. Returns success status on completion (HTTP 204).
- parma_update_note(id: string, body?: string, datetime?: string, relationship_ids?: integer[]) — Tool to update an existing note in the Parma account. Use when you need to modify the content, datetime, or relationships of a specific note.
- parma_update_relationship(id: string, name?: string, type?: string, about?: string, group_ids?: integer[], company_id?: integer, properties?: object[]) — Tool to update an existing relationship in the Parma account. Use when you need to modify relationship details such as name, description, type, or associated groups.

## Example prompts
- "What can I do in Parma?"
- "Show me a summary of my Parma account"

## Links
Docs: https://mcp.ai/docs/mcps/parma
Website: https://mcp.ai/mcps/parma