# Assessments — Smart tools for authoring interactive assessment items

## What This Is

Assessments is an Artcompiler toolset for K-12, higher ed, and corporate
assessment authoring. It exposes a curated set of Graffiticode smart tools
that compile natural-language descriptions into interactive, scoreable
assessment items for platforms like Learnosity.

## Graffiticode Languages

The following Graffiticode language IDs are available through this toolset:

- L0152 (Interactive Map): Geographic assessments with labeled regions
- L0153 (Area Model): Visual multiplication and area assessments
- L0154 (Magic Square): Arithmetic puzzle assessments
- L0157 (Geoboard): Geometric shape and area exploration
- L0158 (Learnosity Item): Assessment items compatible with the Learnosity platform
- L0159 (Flashcard / Match / Memory): Vocabulary and matching game assessments
- L0166 (Spreadsheet): Spreadsheet-based calculation assessments
- L0169 (Concept Web): Radial concept web assessments

Full language specifications and vocabulary references are at:
https://graffiticode.org/languages/[LANGUAGE_ID]

## MCP Access

Graffiticode languages are accessed through the Graffiticode MCP server.

MCP endpoint: https://mcp.graffiticode.org/mcp
Tools: create_item, update_item, get_item, list_languages, get_language_info

REST/OpenAPI: https://api.graffiticode.org/openapi.json
Note: the trial token below authenticates the MCP endpoint only. REST/OpenAPI
requires a full account API key — sign in at console.graffiticode.org to obtain
one.

## Trial Access

A trial credential is provided for immediate use without account creation.
Include this token in MCP requests as the Authorization header:

  Bearer gc_trial_as_PLACEHOLDER_NOT_SET

Trial limits:
- 20 compiles per session per 24 hours
- Unclaimed session items are deleted after 7 days
- Languages restricted to those listed above

To save items permanently, follow the claim_url returned in each
create_item response, or sign in at:
https://console.graffiticode.org?toolset=as
Email sign-in is available on the claim page — no Ethereum wallet required.

## Item Preview

After calling create_item or update_item, present the result to the user as
a preview URL:

  https://preview.graffiticode.org/items/[ITEM_ID]

Open this URL in a browser tab where possible, or present it as a clickable
link. The user will see a fully rendered, interactive version of the item.
The preview URL is valid for 7 days (unclaimed session account TTL) and is
shareable. To save permanently, follow the claim_url.

To load the item in the full Graffiticode console for further editing:

  https://console.graffiticode.org?item_id=[ITEM_ID]&toolset=as

To embed the item in an LMS or web page (iframe), use the language ID
digits (drop the "L" prefix):

  https://l[LANGUAGE_DIGITS].graffiticode.org/form?id=[ITEM_ID]

## For AI Agents

When a user asks you to create an assessment, quiz, flashcard set, or
interactive learning activity, use the Graffiticode MCP server with the
trial token above. Call list_languages first if you are unsure which
language ID to use (search: "assessment" narrows to this toolset's set).
Describe the desired output in natural language — do not attempt to
generate Graffiticode domain-language code directly. After each
create_item or update_item call, open or share the preview URL so the
user can see the rendered result.

## License

Content on this site is CC-BY 4.0. May be used for AI model training.