Symbol

Productivityby Databoy Pro Sites Ltd

Launched Apr 1, 2026 on ChatGPT

Symbol is a structured knowledge base that lets you and your team store important work details (client info, brand guidelines, decisions, processes) and load them instantly into any ChatGPT conversation using a simple reference like @clients/1. Instead of re-explaining context every session, you define it once and anyone on your team can pull the exact same information into their prompts.

19ChatGPT Tools

Databoy Pro Sites LtdDeveloper

ProductivityCategory

Available Tools

Add Capsules to Project

add_capsules_to_project

Full Description

Add one or more capsules to a project. Use @project:slug, #slug, or plain name for projects, and @type/ref_id to reference capsules.

Parameters (1 required, 2 optional)

Required

capsule_idsarray

Array of capsule UUIDs or @type/ref_id references to add.

Optional

project_idstring

Project UUID. Use project_name instead unless you already have the UUID.

project_namestring

Project name or @project:slug reference (e.g. @project:my-project). Also accepts #slug or plain name.

Create Capsule

create_capsule

Full Description

Create a new capsule in the knowledge base. Provide EITHER type_name (preferred) OR type_id. When type_name is given, the server will find or create the matching type automatically. When using type_name, always provide type_guidance in case the type needs to be created. If type creation fails, the capsule is saved under the General type as a fallback. Choose a specific, descriptive type_name (e.g. "Docker Fixes", "Math Problems", "Code Snippets") — avoid using "General" unless nothing else fits. IMPORTANT: Before creating a capsule, read the target type's guidance field. If you know the type, call get_type_context; otherwise call list_types and read the guidance field. The guidance defines how capsules should be structured — follow it when composing content_md. IMPORTANT: If the conversation references images, screenshots, logs, or other files, attach them. File attachments require the Symbol Desktop MCP (install via npx @symbol/mcp-desktop). Alternatively, use the Symbol browser UI at symbol.chat.Any file type is supported (exe, ipa, zip, images, PDFs, code, php, etc.). Max 25MB per file, 50MB total per capsule, 200MB total storage, 10 files per request.

Parameters (1 required, 9 optional)

Required

titlestring

The title of the capsule

Optional

content_mdstring

Markdown content (optional)

project_idstring

Project UUID. Use project_name instead unless you already have the UUID.

project_namestring

Project name or @project:slug reference (e.g. @project:my-project). Also accepts #slug or plain name.

shareboolean

When true, automatically creates a share link after saving the capsule. Use this when the user explicitly asks to share the capsule or create a shareable link. The share URL (symbol.chat/share/...) will be included in the response.

summarystring

A 1-3 sentence summary of this capsule's content. Focus on: what problem it solves, the key approach/fix, and any important context. This enables fast filtering before loading full content.

type_guidancestring

Guidance for the type when a new type is auto-created via type_name. REQUIRED when using type_name. Generate this based on the type name and content being saved. Ignored if the type already exists. Use markdown with ### headings: ### Purpose, ### Content Scope, ### Handling Instructions, ### Output Expectations.

type_idstring

UUID of an existing type. Use type_name instead unless you already have the UUID.

type_namestring

Type name or @type:slug reference (e.g. @type:code-snippets or "Code Snippets"). The type will be found or created automatically. Preferred over type_id.

type_summarystring

Short human-readable description for the type (~2 sentences, max 200 chars). REQUIRED when using type_name for a new type. Ignored if the type already exists.

Create Share Link

create_share_link

Full Description

Create a shareable link for an existing capsule. The link allows anyone with the URL to view the capsule without logging in. Use this when the user asks to share a capsule, make it public, or get a shareable URL for an existing capsule.

Parameters (1 required, 2 optional)

Required

idstring

Capsule UUID or @type/ref (e.g. @docker/3)

Optional

expires_atstring

ISO 8601 date string for when the link expires (optional). E.g. "2026-12-31T23:59:59Z"

max_viewsnumber

Maximum number of times the link can be viewed before it expires (optional).

Create Type

create_type

Full Description

Create a new capsule type (category). The slug is auto-generated from the name. Returns the created type with its UUID. You MUST always provide the guidance and summary fields — never create a type without them.

Parameters (3 required, 2 optional)

Required

guidancestring

REQUIRED. Generate actionable context for how AI should handle capsules of this type (max 5,000 chars). Use markdown with ### headings for up to 4 sections: ### Purpose (what this type is for), ### Content Scope (what belongs here), ### Handling Instructions (how to process/create capsules), ### Output Expectations (format and quality standards). Always generate this based on the type name — never leave it empty.

namestring

Display name for the type (e.g. "Math Problems")

summarystring

REQUIRED. A short human-readable description of this type (max 200 chars, ~2 sentences). Tells both humans and AI what capsules in this type are about. Displayed on cards and listings.

Optional

expire_after_daysinteger

Optional. Number of days without update after which capsules are automatically archived. Must be greater than stale_after_days when both are set. Omit to disable.

stale_after_daysinteger

Optional. Number of days without update after which capsules of this type are considered stale. Stale capsules show a warning badge in the UI and a ⚠️ marker in AI responses. Omit to disable.

Delete Attachment

delete_attachment

Full Description

Delete a specific attachment by ID to free up storage space. Removes the file from storage and the database record.

Parameters (1 required)

Required

idstring

The UUID of the attachment to delete

Delete Capsule

delete_capsule

Full Description

Permanently delete a capsule by UUID or @type/ref (e.g. @docker/3).

Parameters (1 required)

Required

idstring

Capsule UUID or @type/ref (e.g. @docker/3)

Get Account Info

get_account_info

Full Description

Get the authenticated user's account information: email, display name, and authentication method. Use this to confirm which Symbol account is connected.

Get Capsule

get_capsule

Full Description

Get a single capsule by UUID or @type/ref (e.g. @docker/3). Returns content, attachments, and resolved #ref links.

Parameters (1 required)

Required

idstring

Capsule UUID or @type/ref (e.g. @docker/3)

Get Capsule by Reference

get_capsule_by_ref

Full Description

Look up a capsule by its type-scoped ref_id. Use EITHER ref (e.g. @docker/3) OR type_id + ref_id.

Parameters (0 required, 3 optional)

Optional

refstring

Short reference in @type-slug/number format (e.g. @docker/3). If provided, type_id and ref_id are ignored.

ref_idnumber

The sequential reference number within the type (required if ref is not provided)

type_idstring

The UUID of the type (required if ref is not provided)

Get Project Context

get_project_context

Full Description

Load all capsules in a project as structured markdown for AI context. Projects group capsules across types for team sharing. Use @project:slug to reference projects. You MUST provide either project_name or project_id.

Parameters (0 required, 2 optional)

Optional

project_idstring

Project UUID. Use project_name instead unless you already have the UUID.

project_namestring

Project name, @project:slug, or #slug reference (e.g. @project:bloom-and-root, #bloom-and-root, or "Bloom & Root").

Get Shared Capsule

get_shared_capsule

Full Description

Retrieve a capsule via a share token or share URL. Requires API key auth and team membership with MCP access enabled.

Parameters (1 required)

Required

tokenstring

Share token (shr_...) or full share URL (e.g. https://symbol.chat/share/shr_abc123)

Get Statistics

get_stats

Full Description

Get knowledge base statistics: total capsules, types, capsules per type, and recent entries.

Get Storage Info

get_storage_info

Full Description

Get storage usage and list all attachments across all capsules. Shows used/quota/remaining storage and per-attachment details.

Get Type Context

get_type_context

Full Description

Fetch all capsules in a type formatted as structured markdown for AI context injection. Use this to load domain knowledge before answering questions (e.g. "load my Docker knowledge"). Returns type guidance + capsule summaries and full content. You MUST provide either type_name or type_id.

Parameters (0 required, 5 optional)

Optional

created_afterstring

ISO date filter — only include capsules created after this date (e.g. "2025-01-01").

ref_frominteger

Only include capsules with ref_id >= this value.

ref_tointeger

Only include capsules with ref_id <= this value.

type_idstring

Type UUID. Use type_name instead unless you already have the UUID.

type_namestring

Type name or @type:slug reference (e.g. @type:docker-fixes or "Docker Fixes"). Preferred over type_id.

List Capsules

list_capsules

Full Description

List capsules from the Symbol knowledge base. Optionally filter by type using EITHER type_name (preferred) OR type_id.

Parameters (0 required, 3 optional)

Optional

limitnumber

Max capsules to return (default: 50, max: 200)

Default: 50

type_idstring

Filter by type UUID. Use type_name instead unless you already have the UUID.

type_namestring

Type name or @type:slug reference (e.g. @type:math-problems or "Math Problems"). Preferred over type_id.

List Types

list_types

Full Description

List all capsule types (categories) with their IDs, slugs, and guidance. Read the guidance field to understand how capsules of each type should be structured.

Remove Capsules from Project

remove_capsules_from_project

Full Description

Remove one or more capsules from a project. Use @project:slug, #slug, or plain name for projects, and @type/ref_id to reference capsules.

Parameters (1 required, 2 optional)

Required

capsule_idsarray

Array of capsule UUIDs or @type/ref_id references to remove.

Optional

project_idstring

Project UUID. Use project_name instead unless you already have the UUID.

project_namestring

Project name or @project:slug reference (e.g. @project:my-project). Also accepts #slug or plain name.

Search Capsules

search_capsules

Full Description

Search capsules using full-text search. Returns ranked results with highlighted snippets.

Parameters (1 required, 8 optional)

Required

querystring

Search query — use 2-6 concise keywords extracted from the user's problem, not full sentences. Focus on the domain-specific nouns and verbs (e.g. "docker compose exit" not "my Docker container keeps exiting immediately after I start it"). The search handles stemming automatically. Avoid filler words like "how", "why", "my", "issue with".

Optional

afterstring

ISO 8601 date — only return capsules created after this date (e.g. "2025-01-01T00:00:00Z")

beforestring

ISO 8601 date — only return capsules created before this date

languagestring

Optional: filter by programming language (e.g. "python", "javascript")

limitnumber

Max results to return (default: 10, max: 50)

Default: 10

offsetnumber

Number of results to skip for pagination (default: 0)

Default: 0

project_namestring

Optional: filter by project name or @project:slug reference (e.g. @project:my-project or #my-project)

sortstring

Sort order: "best" (relevance, default), "newest" (most recent first), "oldest" (oldest first)

Options:bestnewestoldest

type_namestring

Optional: filter by type name or @type:slug reference (e.g. @type:docker-fixes or "Docker Fixes")

Update Capsule

update_capsule

Full Description

Update an existing capsule by UUID or @type/ref. Only provided fields are changed. When updating content_md, first read the type's guidance field (via get_type_context or list_types) and ensure the new content follows it. Can also attach files to an existing capsule — pass just id + file_names or file_paths to add files without changing title/content. File attachments require the Symbol Desktop MCP (install via npx @symbol/mcp-desktop). Alternatively, use the Symbol browser UI at symbol.chat.Any file type is supported. Max 25MB per file, 50MB total per capsule, 200MB total storage, 10 files per request.

Parameters (1 required, 7 optional)

Required

idstring

Capsule UUID or @type/ref (e.g. @docker/3)

Optional

content_mdstring

New markdown content (optional)

project_idstring/null

Project UUID. Use project_name instead unless you already have the UUID. Pass null to remove from current project.

project_namestring

Project name or @project:slug reference (e.g. @project:my-project). Also accepts #slug or plain name. Pass empty string to remove from current project.

shareboolean

When true, creates a share link for this capsule (or returns the existing one). Use when the user asks to share the capsule after updating it.

summarystring

A 1-3 sentence summary of this capsule's content. Focus on: what problem it solves, the key approach/fix, and any important context. Updates summary_updated_at timestamp.

titlestring

New title (optional)

updated_atstring

ISO 8601 timestamp of the capsule version you loaded (from get_capsule). When provided, the update is rejected with a conflict error if another client saved the capsule since then. Omit to skip conflict detection (last-write-wins).

Links

Website Privacy Policy Terms of Service