Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
FORGESPEC_DBNoFull database path~/.forgespec/forgespec.db
FORGESPEC_DIRNoDatabase directory~/.forgespec

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
forgespec_capabilitiesC

Negotiate ForgeSpec coordination mode, schemas, independently versioned features, and limits.

forgespec_healthA

Get server health diagnostics, database integrity status, system time, active leases, and version telemetry.

tb_audit_logA

Query historical audit trail of authority grants, revocations, and approval decisions.

sdd_validateA

Validate an SDD contract against the phase schema. Returns validation result with confidence check and allowed transitions.

sdd_saveB

Validate and persist an SDD contract. Records the phase transition for project traceability.

sdd_historyA

Get the SDD phase history for a project. Shows all contract transitions in chronological order.

sdd_getA

Get a single SDD contract by ID. Returns full contract data.

sdd_listA

List all SDD contracts with optional filters by project and phase.

tb_create_boardA

Create a new task board for a project. Optionally include tasks inline to create board + all tasks in a single atomic call (avoids N separate tb_add_task calls).

tb_add_taskB

Add a task to an existing board. Every task should reference a spec and have acceptance criteria.

tb_statusB

Get the current status of a task board with all tasks grouped by status.

tb_claimB

Claim a task for execution. Only claims tasks in 'ready' status with all dependencies resolved.

tb_set_dependenciesB

Atomically replace a direct-v1 task's normalized same-board dependency set.

tb_heartbeatC

Renew an active direct-v1 task attempt lease.

tb_recover_claimsB

Recover expired direct-v1 attempts. Tasks require explicit requeue afterward.

tb_requeueC

Explicitly requeue a recovered direct-v1 task.

tb_approveA

Record an immutable direct-v1 approval decision with asserted provenance for a declared task gate. Asserted provenance is not authentication.

tb_grantA

Create an attenuated, expiring task-authority grant. Requires exact task-authority@1.0.0 negotiation.

tb_handoffC

Create a reference-only attenuated handoff. Requires exact task-authority@1.0.0 negotiation.

tb_revokeA

Append an authority revocation without changing board ownership. Requires exact task-authority@1.0.0 negotiation.

tb_queryD

Query a stable, bounded, authorized direct-v1 task snapshot.

tb_batch_statusC

Query bounded direct-v1 task status summaries for recovery without messaging.

tb_eventsC

Query authorized immutable direct-v1 event deltas in stable revision order.

tb_updateA

Update a task's status and/or append notes. Moving to 'done' requires 'in_progress' or 'in_review'. Notes are stored as timestamped entries.

tb_unblockedB

List all tasks that are ready to be worked on (no unresolved dependencies).

tb_getA

Get full details of a single task by ID.

tb_list_boardsA

List task boards, optionally filtered by project. With actor plus direct-v1 context (coordination_mode/api_version/schema_version 1.0.0), also lists direct-v1 boards the actor owns or holds an active grant on. Use this to discover board IDs after context loss.

file_reserveA

Reserve files or glob patterns to prevent conflicts between agents. Use check_only=true to check for conflicts without reserving. Reservations expire after TTL.

file_releaseB

Release file reservations held by an agent.

file_renewB

Renew an active direct-v1 file lease with matching task-attempt authority and revision.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/lleontor705/forgespec-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server