Your workspace, available to your tools

Connect an agent

Give an OAuth-capable MCP client this endpoint. It will discover OAuth and MCP metadata, ask you to sign in, and request only the GRREAT access you approve.

https://grreat.ca/mcp

01

Connect

  1. Open your client’s MCP or integrations settings and add the endpoint above.
  2. Let the client discover OAuth metadata and register through Dynamic Client Registration (DCR).
  3. Sign in to GRREAT, review the requested scopes, and approve the connection.
Recommended scopesgrreat:read grreat:write offline_access

GRREAT does not need profile or email access. Start with read only when that is enough.

02

Client-shaped examples

Clients name fields differently. These three common shapes carry the same connection.

Endpoint field
https://grreat.ca/mcp
Common MCP JSON
{
  "mcpServers": {
    "grreat": { "url": "https://grreat.ca/mcp" }
  }
}
Explicit OAuth settings
{
  "name": "GRREAT",
  "transport": "streamable-http",
  "url": "https://grreat.ca/mcp",
  "scopes": "grreat:read grreat:write offline_access"
}
03

Tools

Read

Inspect the workspace without changing it.

  • list_goals
  • get_goal_context
  • list_records
  • get_record
  • list_relations
  • list_changes

Write

Make scoped changes and receive a change receipt for every successful mutation.

  • add_goal
  • add_research
  • add_roadmap_item
  • add_execution_item
  • add_analysis
  • add_time_entry
  • update_record
  • archive_record
  • relate_records
  • archive_relation

Recovery

Walk backward or forward through the latest linear changes.

  • undo_last_change
  • redo_last_change
04

Know the boundary

Undo and redo target the workspace-wide latest change, including changes made by a human or another connected client. Repeated undo and redo follow one linear history. A new write after an undo supersedes the redo branch. Your own agent writes directly within its scopes; the optional built-in Coach remains proposal-based.

Refresh tokens can be revoked to stop new access, but an access-token JWT may remain valid until its one-day expiry. Remove write scope when an agent only needs to read.

Open your workspace