# Accredible certificates — how to use (mcp.ai)

Connect your Accredible certificates account and use 36 tools for education straight from your AI agent. Connect with your own API key. Accredible Certificates is a platform that enables organizations to create, manage, and distribute digital certificates, open badges, and blockchain credentials.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_accredible_certificates?ms=1787296140000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `accredible_certificates_bulk_create_credentials_v2`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/accredible_certificates`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/accredible_certificates/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/accredible_certificates/bulk/create/credentials/v2` — Tool to bulk create credentials. Use when batching up to 30 credentials in one call; supports multi-status (207) responses.
  - body: { credentials: object[] }
- `POST https://api.mcp.ai/api/accredible_certificates/clone/group` — Tool to clone an existing group. Use after confirming the source group exists and you need a copy with optional overrides.
  - body: { name?: string, group_id: integer, language?: string, meta_data?: object, attach_pdf?: boolean, blockchain?: boolean, signup_url?: string, auto_expiry?: integer, course_link?: string, course_name?: string, badge_design_id?: integer, signup_url_show?: boolean, course_link_show?: boolean, learning_outcomes?: string[], primary_design_id?: integer, skill_category_id?: integer, course_description?: string, certificate_design_id?: integer, organization_link_show?: boolean, allow_duplicate_credentials?: boolean, generate_private_credential?: boolean }
- `POST https://api.mcp.ai/api/accredible_certificates/create/attribute/key` — Tool to create a new custom attribute key. Use when you need to define a new custom attribute for credentials. Requires department ID to associate the attribute with a specific department.
  - body: { kind: string, name: string, department_id: integer }
- `POST https://api.mcp.ai/api/accredible_certificates/create/collection` — Tool to create a new collection. Use when you need a curated set of groups.
  - body: { name: string, public?: boolean, description?: string }
- `POST https://api.mcp.ai/api/accredible_certificates/create/credential` — Tool to create a new credential with optional evidence items and references. Use when issuing credentials to recipients; ensure group exists before creation.
  - body: { name?: string, approve?: boolean, private?: boolean, complete?: boolean, group_id: integer, issued_on?: string, meta_data?: object, expired_on?: string, references?: object[], description?: string, recipient_id?: string, credential_id?: string, evidence_items?: object[], recipient_name: string, recipient_email: string, custom_attributes?: object, recipient_meta_data?: object, recipient_phone_number?: string, allow_supplemental_evidence?: boolean, allow_supplemental_references?: boolean }
- `POST https://api.mcp.ai/api/accredible_certificates/create/evidence/item` — Tool to create a new evidence item for a credential. Use after confirming credential ID.
  - body: { url?: string, file?: string, preview?: string, category: string, position?: integer, description: string, credential_id: string, string_object?: string, custom_insight?: string }
- `POST https://api.mcp.ai/api/accredible_certificates/create/group` — Tool to create a new group. Use after gathering all group details.
  - body: { name: string, language?: string, meta_data?: object, attach_pdf?: boolean, blockchain?: boolean, signup_url?: string, auto_expiry?: integer, collections?: object[], course_link?: string, course_name: string, department_id?: integer, badge_design_id?: integer, signup_url_show?: boolean, course_link_show?: boolean, learning_outcomes?: string[], primary_design_id?: integer, skill_category_id?: integer, course_description: string, certificate_design_id?: integer, organization_link_show?: boolean, allow_duplicate_credentials?: boolean, generate_private_credential?: boolean }
- `POST https://api.mcp.ai/api/accredible_certificates/create/reference` — Tool to create a new reference for a credential. Use when you need to add a reference from someone who can vouch for the credential recipient's skills or achievements.
  - body: { reference: object, credential_id: string }
- `POST https://api.mcp.ai/api/accredible_certificates/delete/collection` — Tool to delete a collection. Use after confirming you want to permanently remove an existing collection. Executes DELETE on /v1/collections/{collection_id} endpoint and returns status code.
  - body: { collection_id: string }
- `POST https://api.mcp.ai/api/accredible_certificates/delete/credential` — Tool to delete a credential. Use after confirming you want to permanently remove an existing credential. Executes DELETE on /credentials/{credential_id} endpoint and returns status code.
  - body: { credential_id: string }
- `POST https://api.mcp.ai/api/accredible_certificates/delete/evidence/item` — Tool to delete an evidence item from a credential. Use after confirming you want to permanently remove a specific evidence item.
  - body: { credential_id: string, evidence_item_id: integer }
- `POST https://api.mcp.ai/api/accredible_certificates/delete/group` — Tool to delete a group. Use after confirming no credentials remain and when you need to permanently remove the group.
  - body: { group_id: integer }
- `POST https://api.mcp.ai/api/accredible_certificates/delete/reference` — Tool to delete a specific reference by ID. Use after confirming both credential_id and reference_id. Example: "Delete reference 1234 from credential 'abc123'."
  - body: { reference_id: integer, credential_id: string }
- `POST https://api.mcp.ai/api/accredible_certificates/generate/pd/fs/for/credentials` — Tool to generate PDFs for multiple credentials. Use when you need to batch-download a zip archive of certificate PDFs for a list of published credential IDs. Example: "Generate PDFs for credentials [1
  - body: { credential_ids: string[] }
- `POST https://api.mcp.ai/api/accredible_certificates/get/analytics` — Tool to retrieve analytics data for credentials. Use when you need to track credential views, shares, and other events with optional date and group filters.
  - body: { page?: integer, end_date?: string, group_id?: integer, page_size?: integer, start_date?: string, department_id?: integer }
- `POST https://api.mcp.ai/api/accredible_certificates/get/credential` — Tool to view a credential by ID. Use when you need to retrieve detailed information about a specific credential.
  - body: { id: string }
- `POST https://api.mcp.ai/api/accredible_certificates/get/credential/analytics` — Tool to view analytics for a specific credential. Use when you need to retrieve analytics data such as views, shares, or other events for a credential.
  - body: { id: string }
- `POST https://api.mcp.ai/api/accredible_certificates/get/department` — Tool to view a specific department by ID. Use when you need to retrieve detailed information about a department.
  - body: { department_id: integer }
- `POST https://api.mcp.ai/api/accredible_certificates/get/evidence/item` — Tool to retrieve a specific evidence item from a credential. Use when you need to view details of an existing evidence item.
  - body: { credential_id: string, evidence_item_id: integer }
- `POST https://api.mcp.ai/api/accredible_certificates/get/group` — Tool to retrieve a specific group by ID. Use when you need to view details of an existing group.
  - body: { group_id: integer }
- `POST https://api.mcp.ai/api/accredible_certificates/get/issuer` — Tool to retrieve details about the authenticated issuer. Use when you need to view information about the issuer organization.
- `POST https://api.mcp.ai/api/accredible_certificates/get/reference` — Tool to view a specific reference by ID. Use when you need to retrieve details of a reference associated with a credential.
  - body: { reference_id: integer, credential_id: string }
- `POST https://api.mcp.ai/api/accredible_certificates/initialize/badge/designer` — Tool to initialize the embedded badge designer. Use to create a new badge design or edit an existing one.
  - body: { design_id?: integer, department_id?: integer }
- `POST https://api.mcp.ai/api/accredible_certificates/initialize/certificate/designer` — Tool to initialize the embedded certificate designer. Returns a JWT token for embedding the designer in your application. Use when you need to create or edit certificate designs programmatically.
  - body: { design_id?: integer, callback_url?: string, department_id?: integer }
- `POST https://api.mcp.ai/api/accredible_certificates/list/templates` — Tool to retrieve a list of all templates. Use after authentication to fetch paginated certificate templates.
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/accredible_certificates/search/attribute/keys` — Tool to search for attribute keys by various criteria. Use when you need to find custom attribute keys by name, department, or type (e.g., "Search for email type attribute keys in department 123").
  - body: { kind?: string, name?: string, page?: integer, page_size?: integer, department_id?: integer }
- `POST https://api.mcp.ai/api/accredible_certificates/search/collections` — Tool to search for collections. Use when you need to filter collections by IDs, name, or public flag and paginate through results. e.g., "Search for public collections named 'abc' on page 2."
  - body: { meta?: object, sort?: object, query: object }
- `POST https://api.mcp.ai/api/accredible_certificates/search/credentials/v2` — Tool to search for credentials using the v2 API. This is a faster alternative to the v1 Search API and supports operations on query fields for complex queries. Use when you need to filter credentials 
  - body: { page?: object, sort?: object, query?: object }
- `POST https://api.mcp.ai/api/accredible_certificates/search/departments` — Tool to search for departments by various criteria. Use when you need to find departments by name or retrieve a paginated list of departments.
  - body: { name?: string, page?: integer, page_size?: integer }
- `POST https://api.mcp.ai/api/accredible_certificates/search/designs` — Tool to search for designs (certificate/badge templates). Use when you need to filter designs by type, metadata, or paginate through design results.
  - body: { kind?: string, page?: integer, meta_data?: object, page_size?: integer }
- `POST https://api.mcp.ai/api/accredible_certificates/search/groups` — Tool to search for groups in Accredible. Use when you need to filter groups by IDs, name, update dates, or metadata and paginate through results.
  - body: { ids?: integer[], name?: string, page?: integer, meta_data?: object, page_size?: integer, end_updated_date?: string, start_updated_date?: string }
- `POST https://api.mcp.ai/api/accredible_certificates/update/credential` — Tool to update an existing credential. Use when you need to modify credential details such as description, dates, recipient information, or custom attributes.
  - body: { name?: string, complete?: boolean, group_id?: integer, issued_on?: string, meta_data?: object, recipient?: object, expired_on?: string, description?: string, credential_id: string, custom_attributes?: object, allow_supplemental_evidence?: boolean, allow_supplemental_references?: boolean }
- `POST https://api.mcp.ai/api/accredible_certificates/update/evidence/item` — Tool to update an existing evidence item for a credential. Use when you need to modify the details of an evidence item after it has been created.
  - body: { url?: string, file?: string, preview?: string, category?: string, position?: integer, description?: string, credential_id: string, string_object?: string, custom_insight?: string, evidence_item_id: integer }
- `POST https://api.mcp.ai/api/accredible_certificates/update/group` — Tool to update an existing group. Use when you need to modify group details after fetching its current data.
  - body: { name?: string, group_id: integer, language?: string, meta_data?: object, attach_pdf?: boolean, blockchain?: boolean, signup_url?: string, auto_expiry?: integer, collections?: object[], course_link?: string, course_name?: string, department_id?: integer, badge_design_id?: integer, signup_url_show?: boolean, course_link_show?: boolean, learning_outcomes?: string[], primary_design_id?: integer, skill_category_id?: integer, course_description?: string, certificate_design_id?: integer, organization_link_show?: boolean, allow_duplicate_credentials?: boolean, generate_private_credential?: boolean }
- `POST https://api.mcp.ai/api/accredible_certificates/update/reference` — Tool to update a reference by ID. Use when you need to modify a reference's details for a credential. Use after retrieving the reference ID to change comments or relationship.
  - body: { reference: object, reference_id: integer, credential_id: string }
- `POST https://api.mcp.ai/api/accredible_certificates/view/all/skill/categories` — Tool to retrieve all skill categories. Use when you need to list all available skill categories (e.g., to link them to groups).

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

## More
- Page: https://mcp.ai/accredible_certificates
- Agent spec (llms.txt): https://mcp.ai/accredible_certificates/llms.txt
- Postman collection: https://mcp.ai/accredible_certificates/postman.json